מצב בסיסי

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

דוגמאות קוד

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

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

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

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

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

הוספת מפה במצב בסיסי

מצב טעינה מהירה משתמש באותן מחלקות וממשקים כמו Google Maps Android API המלא. אפשר להגדיר 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). לפרטים נוספים, ראו את המסמכים של סרגל הכלים.

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

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

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

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

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

תכונות נתמכות של ה-API

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