מצב בסיסי

ה-SDK של מפות ל-Android יכול להציג תמונה בפורמט בייטמאפ של מפה, עם אינטראקטיביות מוגבלת למשתמש. המפה הזו נקראת מצב טעינה מהירה.

דוגמאות קוד

המאגר ApiDemos ב-GitHub כולל דוגמאות שממחישות את השימוש במצב Lite:

• LiteDemoActivity – Java: היסודות של שימוש במפה במצב בסיסי ב-Java
• LiteDemoActivity – Kotlin: היסודות של שימוש במפה במצב טעינה מהירה ב-Kotlin
• LiteListDemoActivity – Java: הצגת מפות ביעילות ב-ListViews באמצעות מצב קל ב-Java
• LiteListDemoActivity – Kotlin: הצגת מפות ביעילות ב-ListViews באמצעות מצב טעינה מהירה ב-Kotlin

סקירה כללית על מצב Lite

מפה במצב בסיסי היא תמונה בפורמט בייטמאפ של מפה במיקום וברמת התמקדות מסוימים. מצב Lite תומך בכל סוגי המפות (רגילות, היברידיות, לוויין, שטח) ובקבוצת משנה של הפונקציונליות שסופקת על ידי ה-API המלא. מצב Lite שימושי כשרוצים להציג מספר מפות בשידור או מפה קטנה מדי שלא תומכת באינטראקציה משמעותית.

משתמשים שצופים במפה לא יכולים לשנות את מרחק התצוגה או להזיז את המפה. סמלים במפה מאפשרים למשתמשים להציג את המפה באפליקציית מפות Google לנייד ולבקש מסלול הגעה.

הוספת מפה במצב טעינה מהירה

במצב טעינה מהירה נעשה שימוש באותן מחלקות וממשקים כמו ב-API המלא של מפות Google ל-Android. אפשר להגדיר את GoogleMap למצב בסיסי בדרכים הבאות:

• כמאפיין XML של MapView או MapFragment
• או באובייקט GoogleMapOptions

כמאפיין XML של MapView או MapFragment

<fragment xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:map="http://schemas.android.com/apk/res-auto"
    android:name="com.google.android.gms.maps.MapFragment"
    android:id="@+id/map"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    map:cameraZoom="13"
    map:mapType="normal"
    map:liteMode="true"/>

באובייקט GoogleMapOptions

val options = GoogleMapOptions()
    .liteMode(true)

      

GoogleMapOptions options = new GoogleMapOptions()
    .liteMode(true);

      

פרטים על הגדרת המצב הראשוני של המפה מופיעים במדריך לאובייקט המפה.

כוונות להפעלת תצוגת מפה או בקשת מסלול הגעה

כברירת מחדל, בסרגל הכלים בפינה השמאלית התחתונה של המפה מופיעים סמלים שמספקים גישה לתצוגת מפה או לבקשת מסלול באפליקציה לנייד של מפות Google. אפשר להשבית את סרגל הכלים באמצעות הפקודה UiSettings.setMapToolbarEnabled(false). לפרטים נוספים, ראו את מסמכי העזרה של סרגל הכלים.

כמו כן, כברירת מחדל, כשמשתמש מקייש על המפה, ה-API מפעיל את האפליקציה לנייד של מפות Google. אפשר לשנות את ההגדרה הזו באמצעות GoogleMap.setOnMapClickListener() כדי להגדיר מאזין משלכם. אפשר גם להשבית אירועי קליקים במפה על ידי קריאה ל-setClickable() בתצוגה שמכילה את MapView או MapFragment. פרטים על שתי השיטות האלה מופיעים במסמכי התיעוד בנושא אירועים.

אירועים במחזור החיים

כשמשתמשים ב-API במצב אינטראקטיבי מלא, משתמשים בכיתה MapView חייבים להעביר את כל השיטות של מחזור החיים של הפעילות לשיטות התואמות בכיתה MapView. דוגמאות לשיטות מחזור החיים הן onCreate(),‏ onDestroy(),‏ onResume() ו-onPause().

כשמשתמשים בכיתה MapView במצב בסיסי, העברת אירועי מחזור חיים היא אופציונלית, מלבד במקרים הבאים:

• חובה להפעיל את הפונקציה onCreate(), אחרת לא תופיע מפה.
• אם רוצים להציג את הנקודה 'המיקום שלי' במפה במצב בסיסי ולהשתמש במקור המיקום שמוגדר כברירת מחדל, צריך להפעיל את הפונקציות onResume() ו-onPause(), כי מקור המיקום יתעדכן רק בין הקריאות האלה. אם אתם משתמשים במקור מיקום משלכם, אין צורך להפעיל את שתי השיטות האלה.

תכונות API נתמכות

בטבלה הבאה מתוארת ההתנהגות של מפה במצב Lite בכל תחום של פונקציונליות ה-API. אם אפליקציה קוראת לשיטה שלא נתמכת במצב Lite, ביומן של ה-API תירשם הודעת אזהרה.