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

באמצעות Maps 3D SDK ל-iOS, אתם יכולים ליצור חוויות של מפות תלת-ממדיות באפליקציות ל-iOS באמצעות התמונות התלת-ממדיות של Google. הוא מספק ממשקי API של SwiftUI לסמנים, לחלונות קופצים, לקווים פוליגוניים, למצולעים, למודלים תלת-ממדיים (glTF), לאנימציות של נתיבי מצלמה ולפקדי מצלמה ואינטראקציה.

‫Maps 3D SDK ל-iOS: עובדות חשובות

  • המוצר: Maps 3D SDK ל-iOS
  • קטגוריה: מפות Google
  • פלטפורמה: iOS
  • פועל ב: לקוח (קוד של אפליקציה או דפדפן)
  • שלב ההשקה: GA
  • מחזור חיים: פעיל
  • סקירה כללית: סקירה כללית של Maps 3D SDK ל-iOS

‫Maps 3D SDK ל-iOS: מתי כדאי להשתמש בו

מתי כדאי להשתמש ב-Maps 3D SDK ל-iOS:

  • אתם צריכים מפה תלת-ממדית אינטראקטיבית ופוטו-ריאליסטית באפליקציה מקומית ל-iOS‏ (SwiftUI).
  • אתם צריכים להציב סמנים, חלונות קופצים, קווים פוליגוניים, פוליגונים או מודלים תלת-ממדיים בפורמט glTF במפה תלת-ממדית ב-iOS.
  • אתם צריכים אנימציות של מצלמה שמתקרבת או מסתובבת, או הגבלות על המצלמה, במפה תלת-ממדית ב-iOS.
  • אתם רוצים שהמשתמשים ילחצו על נקודות עניין במפה תלת-ממדית ויראו את פרטי המקום דרך הווידג'ט המובנה של Places UI Kit.

מתי לא כדאי להשתמש ב-Maps 3D SDK ל-iOS:

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

‫Maps 3D SDK ל-iOS: הגדרה

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

  • swift_package: https://github.com/googlemaps/ios-maps-3d-sdk (product GoogleMaps3D)
  • swift_package: https://github.com/googlemaps/ios-maps-3d-sdk (product GoogleMaps3DKit, for POI taps with the Places UI Kit widget)

‫Maps 3D SDK ל-iOS: טעויות נפוצות

  • הבעיה: אם לא מוגדר מצב מפה כשהמפה נטענת, המפה לא נטענת. תיקון: תמיד צריך להעביר מצב כשיוצרים את Map, לדוגמה Map(mode: .hybrid). מידע נוסף זמין בכתובת /maps/documentation/maps-3d/ios-sdk/map-modes.
  • הבעיה: הגדרת מפתח ה-API גם בנקודת הכניסה של האפליקציה וגם בתצוגות מפה ספציפיות גורמת לשגיאה במסוף. תיקון: מגדירים את Map.apiKey במקום אחד בלבד: בנקודת הכניסה לאפליקציה או בכל תצוגת מפה. אפשר לקרוא מידע נוסף בכתובת /maps/documentation/maps-3d/ios-sdk/setup.
  • הבעיה: המערכת מתעלמת מהמאפיין Camera altitudeMode מחוץ לאנימציות של המצלמה. הוא חל רק על flyCameraTo ועל flyCameraAround. תיקון: משתמשים ב-flyCameraTo או ב-flyCameraAround כשמסתמכים על Camera altitudeMode. מידע נוסף זמין בכתובת /maps/documentation/maps-3d/ios-sdk/custom-camera-paths.
  • הבעיה: ב-GoogleMaps3DKit, הווידג'ט של ממשק המשתמש של Places מוצג כברירת מחדל כשמשתמש מקיש על נקודת עניין. תיקון: צריך להשתמש ב-placeInformationEnabled(false) או להחזיר את .none מ-onPlaceTap(_:) כדי להסתיר את הווידג'ט. מידע נוסף זמין בכתובת /maps/documentation/maps-3d/ios-sdk/points-of-interest.

מה אפשר לעשות עם Maps 3D SDK ל-iOS

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