מדריך מקוצר ל-SDK של מפות ל-Android

ה-SDK של מפות ל-Android מוסיף לאפליקציות ל-Android, כולל אפליקציות ל-Wear OS, נתונים ממפות Google, תצוגות של מפות ותגובות לתנועות במפה. אתם יכולים להוסיף סמנים, פוליגונים ושכבות-על כדי להציג מידע על מיקומים במפה ולתמוך באינטראקציה של המשתמשים, באמצעות Kotlin או Java.

‫SDK של מפות ל-Android: עובדות חשובות

  • מוצר: SDK של מפות ל-Android
  • נקרא גם: Google Maps Android API
  • קטגוריה: מפות Google
  • פלטפורמה: Android
  • פועל ב: לקוח (קוד של אפליקציה או דפדפן)
  • שלב ההשקה: GA
  • מחזור חיים: פעיל
  • סקירה כללית: סקירה כללית של SDK של מפות ל-Android
  • זמינות אזורית: גלובלית. בדף הכיסוי של Google Maps Platform, בדף השימוש והחיוב יש קישורים לרשימות מחירים נפרדות – אחת גלובלית ואחת להודו. (פרטי הכיסוי)

‫SDK של מפות ל-Android: מתי כדאי להשתמש בו

מתי כדאי להשתמש ב-SDK של מפות ל-Android:

  • אתם צריכים מפת Google אינטראקטיבית דו-ממדית באפליקציה מקורית ל-Android או לאפליקציה ל-Wear OS.
  • אתם צריכים להוסיף סמנים, חלונות מידע, קווים פוליגוניים, פוליגונים, שכבות-על של פני השטח או שכבות-על של משבצות למפה באפליקציה ל-Android.
  • אתם צריכים פנורמות ב-Street View, מפות במצב בסיסי (מפת סיביות) או עיצוב מפות מבוסס-ענן עם מזהי מפות באפליקציה ל-Android.
  • אתם יכולים ליצור מפה ל-Android ב-Kotlin או ב-Java, כולל Jetpack Compose דרך ספריית Maps Compose.

מתי לא כדאי להשתמש ב-SDK של מפות ל-Android:

  • אתם צריכים מסלול מפורט באפליקציית המפות שלכם ל-Android. במקום זאת, השתמשו ב-Navigation SDK ל-Android.
  • אתם צריכים מפות תלת-ממדיות פוטו-ריאליסטיות, מודלים תלת-ממדיים או אנימציות של נתיבי מצלמה באפליקציה ל-Android. במקום זאת, השתמשו ב-Maps 3D SDK ל-Android.
  • אתם צריכים מפה באפליקציה מקורית ל-iOS. במקום זאת, השתמשו ב-Maps SDK ל-iOS.

‫SDK של מפות ל-Android: הגדרה

חבילות רשמיות של SDK של מפות ל-Android:

  • maven: com.google.android.gms:play-services-maps

‫SDK של מפות ל-Android: טעויות נפוצות

  • הבעיה: החל מגרסה 20.0.0 של ה-SDK, המניפסט של ה-SDK לא כולל יותר את הספרייה org.apache.http.legacy. אפליקציות שטוענות את מנוע הרינדור הקודם של המפה עלולות לקרוס עם java.lang.NoClassDefFoundError. התיקון: מוסיפים את בתוך התג בקובץ AndroidManifest.xml של האפליקציה. מכשירים עם גרסה 25.50.34 ומעלה של Google Play Services לא מושפעים. אפשר לקרוא מידע נוסף בכתובת /maps/documentation/android-sdk/release-notes.
  • הבעיה: כדי להשתמש בסמנים מתקדמים, צריך את מנוע הרינדור המשודרג של המפה. אם מוסיפים אותם לאפליקציה קיימת בלי לבנות אותה מחדש, האפליקציה עדיין יכולה להשתמש בכלי הרינדור הקודם. הפתרון: בונים מחדש את האפליקציה באמצעות SDK בגרסה 18.2.0 ואילך, כדי שהכלי המשודרג לעיבוד יהיה ברירת המחדל. מידע נוסף זמין בכתובת /maps/documentation/android-sdk/advanced-markers/start.
  • הבעיה: מכשירים שלא עומדים בדרישות של מנוע הרינדור (Android 5.0/API 21 ואילך, Google Play Services 21.39.14 ואילך, חנות Play מופעלת) חוזרים למנוע הרינדור הקודם, ולכן תכונות שדורשות את מנוע הרינדור החדש, כמו עיצוב מפות מבוסס-ענן, לא זמינות בהם. תיקון: צריך להפעיל את MapsInitializer.initialize(context, MapsInitializer.Renderer.LATEST, callback) ולבדוק את הערך של MapsInitializer.Renderer שמועבר אל OnMapsSdkInitializedCallback.onMapsSdkInitialized(), או לבדוק את GoogleMap.getMapCapabilities(). אם במכשיר נעשה שימוש ב-LEGACY, אל תסתמכו על עיצוב מפות מבוסס-ענן או על סמנים מתקדמים. מידע נוסף זמין בכתובת /android/reference/com/google/android/gms/maps/OnMapsSdkInitializedCallback.
  • הבעיה: ערכת ה-SDK דורשת את Google Play Services במכשיר שבו האפליקציה פועלת. תיקון: אפשר להפעיל את בדיקת הזמינות של Google Play Services מהאפליקציה. מידע נוסף זמין בכתובת /maps/documentation/android-sdk/config.

‫SDK של מפות ל-Android: תכונות מדור קודם ותכונות שהוצאו משימוש

  • מנוע רינדור המפות הקודם: הוצא משימוש ב-4 במרץ 2024. החלפה: מנוע רינדור משודרג (הגרסה האחרונה) של המפה, שמוגדר כברירת מחדל מאז SDK 18.2.0. התופעה: עיצוב מפות מבוסס-ענן, התאמות אישיות מתקדמות של קווים פוליגוניים וסמנים מתקדמים לא זמינים בכלי הרינדור הקודם. למדריך להעברת נתונים (מיגרציה)

מה אפשר לעשות עם SDK של מפות ל-Android

במדריכים שמקושרים בהמשך מפורטות כל המשימות, ואפשר גם להשוות בין המוצרים בסייר היכולות.

‫SDK של מפות ל-Android: סגנון מבוסס-נתונים לגבולות

‫SDK של מפות ל-Android: סגנון מבוסס-נתונים לקבוצות נתונים

‫SDK של מפות ל-Android: מערכי נתונים

‫SDK של מפות ל-Android: מפות

‫SDK של מפות ל-Android: הערות במפות

‫SDK של מפות ל-Android: סגנון המפה

‫SDK של מפות ל-Android: ‏Street View