מדריך מקוצר ל-Maps 3D SDK ל-Android

‫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: הגדרה

‫חבילות רשמיות של Maps 3D SDK ל-Android:

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

‫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

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