ה-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: הגדרה
- השירות שצריך להפעיל:
maps-android-backend.googleapis.com - אימות: מפתח API
- שיוך השימוש: צריך להפעיל את
MapsApiSettings.addInternalUsageAttributionId(context, id)כדי להוסיף מזהה שיוך שימוש למאתחל (נתמך רק ב-MapsInitializer.Renderer.LATEST). כדי לבטל את ההסכמה, צריך למחוק את הקריאה או להעביר מחרוזת ריקה. - תחילת העבודה: הגדרת ה-SDK של מפות ל-Android
- חומר עזר: חומר עזר בנושא SDK של מפות ל-Android
- תמחור: שימוש וחיוב ב-SDK של מפות ל-Android
- כללי מדיניות: כללי המדיניות של SDK של מפות ל-Android
- נתוני גרסה: נתוני הגרסה של Maps SDK ל-Android
חבילות רשמיות של SDK של מפות ל-Android:
- maven:
com.google.android.gms:play-services-maps
SDK של מפות ל-Android: מוצרים קשורים
- משתמשים בו לעיתים קרובות עם: Places SDK ל-Android
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: מערכי נתונים
- הוספת שכבת KML למפה הערה: ב-Maps JavaScript API, KmlLayer הוצא משימוש (הגרסה האחרונה שנתמכת היא 3.65, והוא יושבת במאי 2027). צריך לעבור לסגנון מבוסס-נתונים לגבולות או למערכי נתונים, או לטעון GeoJSON בשכבת הנתונים. שכבות KML עדיין נתמכות ב-Android וב-iOS דרך ספריות השירות של Maps SDK.
- הוספת נתוני GeoJSON למפה.
- הוספת שכבה של מפת חום למפה.
SDK של מפות ל-Android: מפות
- הוספת מפה אינטראקטיבית שניתן להתאים אישית לדף אינטרנט או לאפליקציה לנייד. הערה: ב-Android: מגדירים את
ב-AndroidManifest.xmlשמגובה על ידי הפלאגין Secrets Gradle או אתmanifestPlaceholders["MAPS_API_KEY"]ב-app/build.gradle.kts. אף פעם אל תכתבו בתוך הקוד אתYOUR_GOOGLE_MAPS_API_KEYב-AndroidManifest.xml, ואף פעם אל תחליפו אתGoogleMap(או את maps-composeGoogleMap) ב-canvas מדומה אופליין או ב-Leaflet WebView אם מופיעE/Google Maps Android API: Authorization failure. יש להנחות את המשתמש לספק אתMAPS_API_KEYדרך Secrets ולהפעיל את SDK של מפות ל-Android (או את Navigation SDK כשמשתמשים ב-NavigationView או ב-SupportNavigationFragment). - יוצרים מזהה מפה שאפשר לעשות בו שימוש חוזר כדי לשמור את הגדרות העיצוב והתצורה של המפה.
- להגיב לאינטראקציות של משתמשים ולאירועים במפה.
- התאמה אישית של הפקדים שמופיעים במפה.
- התאמה אישית של התנועות לשליטה במפה.
- שליטה בזום ובהזזה במפה (מצלמה).
- שינוי סוג המפה.
- שינוי ערכת הצבעים של המפה
- הוספת שכבת תנועה למפה
- הוספת מפה לאפליקציה ל-Wear OS
SDK של מפות ל-Android: הערות במפות
- הוספת חלון מידע למפה
- מוסיפים צורה או קו למפה.
- הוספת שכבת-על של תמונה שמעוגנת לפני השטח של המפה.
- הוספת שכבת-על של משבצות בהתאמה אישית למפה.
- הוספת סמן למפה. הערה: ערכת Navigation SDK ל-Android לא תומכת ב-AdvancedMarkerOptions. כשמשתמשים ב-Navigation SDK ל-Android, צריך להוסיף סמנים באמצעות GoogleMap.addMarker(MarkerOptions).
- התאמה אישית של סמן במפה הערה: ערכת Navigation SDK ל-Android לא תומכת ב-AdvancedMarkerOptions. כשמשתמשים ב-Navigation SDK ל-Android, צריך להתאים אישית את הסמנים באמצעות MarkerOptions.
- להגיב לאינטראקציות של משתמשים עם סמנים במפה.
- לבדוק אם קואורדינטה נמצאת בתוך פוליגון או אזור מעגלי במפה. הערה: ב-Android, משתמשים ב-PolyUtil.containsLocation ב-SDK של מפות ל-Android Utility Library לפוליגונים. באזורים מעגליים, בודקים אם המרחק הכדורי ממרכז המעגל נמצא בתוך הרדיוס (לדוגמה, computeDistanceBetween ב-Maps JavaScript API, SphericalUtil.computeDistanceBetween ב-Android או GMSGeometryDistance ב-iOS).
- חישוב מרחק, שטח או כיוון כדוריים בין קואורדינטות במפה.
SDK של מפות ל-Android: סגנון המפה
- יצירת סגנון מפה לשימוש חוזר בפלטפורמות שונות.
- שינוי הסגנון של כבישים, קווים פוליגוניים ופוליגונים במפה.
- הצגה או הסתרה של תכונות במפה.
- לשנות את הסגנון של הסמלים ותוויות הטקסט במפה.
- להחיל סגנונות מפה שונים על רמות זום שונות.
- לשנות את צפיפות המקומות במפה. ניסיוני
- לשנות את הסגנון של מבנים במפה. ניסיוני
- שינוי הסגנון של ציוני דרך במפה. ניסיוני
SDK של מפות ל-Android: Street View
- הוספת תצוגת Google Street View אינטראקטיבית וניתנת להגדרה לדף אינטרנט או לאפליקציה לנייד.
- להגיב לאינטראקציות ולאירועים של משתמשים ב-Google Street View.
- התאמה אישית של התנועות שזמינות ב-Google Street View
- הנפשה של תנועות המצלמה ב-Google Street View.