Maps 3D SDK ל-Android מאפשר לאפליקציות ל-Android להציג מפות תלת-ממדיות אינטראקטיביות שנוצרו מתמונות תלת-ממדיות של Google. הוא מספק סמנים, חלונות קופצים, קווים פוליגוניים, פוליגונים, מודלים תלת-ממדיים של glTF, אנימציות של נתיבי מצלמה ופקדים לאינטראקציה של המשתמשים ולתנועת המצלמה.
Maps 3D SDK ל-Android: עובדות חשובות
- המוצר: Maps 3D SDK ל-Android
- נקרא גם: Maps 3D Android SDK
- קטגוריה: מפות Google
- פלטפורמה: Android
- פועל ב: לקוח (קוד של אפליקציה או דפדפן)
- שלב ההשקה: GA
- מחזור חיים: פעיל
- סקירה כללית: סקירה כללית של Maps 3D SDK ל-Android
- זמינות אזורית: מוגבלת. הזמינות משתנה בהתאם למדינה ולאזור. אפשר לעיין בעמודה "מפות בתלת-ממד (JavaScript, Android, iOS)" בדף הכיסוי של Google Maps Platform. (פרטי הכיסוי)
Maps 3D SDK ל-Android: מתי כדאי להשתמש בו
כדאי להשתמש ב-Maps 3D SDK ל-Android במקרים הבאים:
- אתם צריכים להציג באפליקציה ל-Android מפה אינטראקטיבית תלת-ממדית פוטו-ריאליסטית של מיקומים בעולם האמיתי.
- אתם צריכים להציב סמנים, חלונות קופצים, קווים פוליגוניים, פוליגונים או מודלים תלת-ממדיים בפורמט glTF במפה תלת-ממדית באפליקציה ל-Android.
- אתם צריכים אנימציות מוגדרות מראש של המצלמה (טיסה אל, טיסה מסביב) שמדריכות את המשתמשים בין נקודות במפה תלת-ממדית.
- אתם צריכים לקבוע באילו תנועות מצלמה ובאילו רכיבים אינטראקטיביים המשתמשים יכולים להשתמש במפה תלת-ממדית באפליקציה ל-Android.
מתי לא כדאי להשתמש ב-Maps 3D SDK ל-Android:
- אתם מפתחים אפליקציית אינטרנט שצריכה מפות תלת-ממדיות. במקום זאת, צריך להשתמש ב-Maps JavaScript API.
- אתם מפתחים אפליקציה ל-iOS שצריכה מפות תלת-ממדיות. במקום זאת, צריך להשתמש ב-Maps 3D SDK ל-iOS.
- אתם צריכים מפה דו-ממדית רגילה של רחובות שמוכנה לייצור באפליקציה ל-Android (מצב
ROADMAPב-SDK הזה הוא ניסיוני). במקום זאת, צריך להשתמש ב-SDK של מפות ל-Android.
Maps 3D SDK ל-Android: הגדרה
- השירות שצריך להפעיל:
mapsandroid.googleapis.com - אימות: מפתח API
- תחילת העבודה: הגדרת Maps 3D SDK ל-Android
- חומר עזר: חומר עזר בנושא Maps 3D SDK ל-Android
- תמחור: שימוש וחיוב ב-Maps 3D SDK ל-Android
- כללי מדיניות: כללי המדיניות של Maps 3D SDK ל-Android
- נתוני גרסה: נתוני הגרסה של Maps 3D SDK ל-Android
חבילות רשמיות של Maps 3D SDK ל-Android:
- maven:
com.google.android.gms:play-services-maps3d
Maps 3D SDK ל-Android: מוצרים קשורים
- משתמשים בו לעיתים קרובות עם: Places SDK ל-Android
Maps 3D SDK ל-Android: טעויות נפוצות
- הבעיה: אם מצב המפה לא צוין כשהמפה נטענה, המפה לא נטענת. תיקון: צריך תמיד להגדיר
Map3DMode(SATELLITE,HYBRIDאוROADMAP) ב-XML של הפריסה (map3d:mapMode) או באמצעותsetMapMode/Map3DInitConfig. אפשר לעיין בכתובת /maps/documentation/maps-3d/android-sdk/map-modes. - הבעיה: רכיבי click listener (קליקים על המפה ועל הסמנים) לא פועלים בשרשור UI הראשי, ולכן עדכונים ישירים של ממשק המשתמש מה-handler נכשלים. תיקון: עוברים לשרשור הראשי לפני שמעדכנים את ממשק המשתמש, למשל באמצעות
lifecycleScope.launch(Dispatchers.Main). מידע נוסף זמין בכתובת /maps/documentation/maps-3d/android-sdk/add-a-marker. - הבעיה: מצב המפה משותף בין מופעים של
Map3DView, כך שסמנים, שכבות-על ומיקום המצלמה מתצוגה ישנה מועברים לתצוגה חדשה. תיקון: צריך להשאיר רק מופע אחד פעיל שלMap3DView. צריך להפעיל אתonDestroy()במופע הישן ולמחוק באופן ידני סמנים ושכבות-על, ולאפס את המצלמה באמצעותGoogleMap3D. מידע נוסף זמין בכתובת /maps/documentation/maps-3d/android-sdk/add-a-3d-map. - הבעיה: כברירת מחדל, לחיצה על נקודת עניין במפת הבסיס מציגה את הווידג'ט של ממשק המשתמש של Places, שגם דורש את התלות ב-Places SDK. תיקון: מוסיפים את התלות של Places SDK ל-Android, ומחזירים את
trueמ-onMap3DClickב-OnMap3DClickListenerכדי להסתיר את הווידג'ט שמוגדר כברירת מחדל אם לא רוצים אותו. מידע נוסף זמין בכתובת /maps/documentation/maps-3d/android-sdk/points-of-interest.
מה אפשר לעשות עם Maps 3D SDK ל-Android
במדריכים שמקושרים בהמשך מפורטות כל המשימות, ואפשר גם להשוות בין המוצרים בסייר היכולות.
- הוספת מפה תלת-ממדית אינטראקטיבית ופוטו-ריאליסטית לדף אינטרנט.
- הוספת סמן למפה תלת-ממדית פוטו-ריאליסטית
- התאמה אישית של סמן במפה תלת-ממדית פוטו-ריאליסטית.
- הוספת מודל תלת-ממדי למפה תלת-ממדית פוטו-ריאליסטית.
- הוספת קו פוליגוני תלת-ממדי למפה תלת-ממדית פוטו-ריאליסטית.
- הוספת פוליגון תלת-ממדי למפה תלת-ממדית פוטו-ריאליסטית.
- להגיב לאינטראקציות ולאירועים של משתמשים במפה תלת-ממדית פוטו-ריאליסטית.
- התאמה אישית של אמצעי הבקרה שמופיעים במפה תלת-ממדית פוטו-ריאליסטית.
- שליטה בנתיב המצלמה ובאנימציות במפה תלת-ממדית פוטו-ריאליסטית.
- שליטה בהגבלות על המצלמה במפה תלת-ממדית פוטו-ריאליסטית.