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

באמצעות ה-SDK של מפות ל-iOS, אתם יכולים להוסיף לאפליקציות ל-iOS מפות שמבוססות על נתונים ממפות Google. ה-SDK מטפל בגישה לשרתים של מפות Google, בתצוגת המפה ובתגובה לתנועות של המשתמש, ומאפשר להוסיף למפה סמנים, קווים פוליגוניים, שכבות-על של פני השטח וחלונות מידע.

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

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

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

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

  • אתם צריכים מפה אינטראקטיבית של Google עם טיפול בתנועות בתוך אפליקציה מקורית ל-iOS.
  • אתם צריכים להוסיף סמנים, קווים פוליגוניים, שכבות-על של פני השטח או חלונות מידע למפה באפליקציה ל-iOS.
  • אתם צריכים להציג פנורמות ב-Street View בתוך אפליקציה ל-iOS.
  • אתם צריכים להמיר קואורדינטות לכתובות (reverse geocoding) מאפליקציה ל-iOS שמוצגת בה מפה.

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

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

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

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

  • swift_package: https://github.com/googlemaps/ios-maps-sdk

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

  • הבעיה: ערכת ה-SDK לא תומכת בספריות שניתנות למיזוג. הפעלת האפשרות Build Mergeable Library (יצירת ספרייה שניתנת למיזוג) ב-Xcode גורמת לכשלים בקישור בגרסאות build להפצה. תיקון: משאירים את ההגדרה Build Mergeable Library (יצירת ספרייה שניתן למזג) במצב No (לא) (ברירת המחדל). אפשר לקרוא מידע נוסף בכתובת /maps/documentation/ios-sdk/config.
  • הבעיה: בלי רשומות LSApplicationQueriesSchemes, לחיצה על הלוגו של Google במפה מתעדת כשלים של -canOpenURL עבור comgooglemaps:// ו-googlechromes://. תיקון: מוסיפים את googlechromes ואת comgooglemaps אל LSApplicationQueriesSchemes ב-Info.plist. אפשר לקרוא מידע נוסף בכתובת /maps/documentation/ios-sdk/config.
  • הבעיה: סביר להניח שהשימוש ב-SDK בתוך תוספים של אפליקציות ל-iOS (לדוגמה, מקלדת בהתאמה אישית) לא יעבוד בגלל מגבלות זיכרון מחמירות. התיקון: משתמשים ב-SDK באפליקציה הראשית, ולא בתוספים לאפליקציה. מידע נוסף זמין בכתובת /maps/documentation/ios-sdk/overview.
  • הבעיה: ערכת ה-SDK לא מותאמת ל-iPadOS 13 ואילך עם כמה חלונות או מופעים בו-זמנית, ועלולה להציג התנהגות לא מוגדרת. הפתרון: בודקים בקפידה תרחישים של ריבוי חלונות באייפד או נמנעים מהפעלה של כמה מופעים של מפות בו-זמנית. מידע נוסף זמין בכתובת /maps/documentation/ios-sdk/overview.

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

  • מנוע רינדור של OpenGL ו-setMetalRendererEnabled: הוצא משימוש ב-19 במאי 2025. החלפה: מנוע הרינדור של Metal (ברירת המחדל מגרסה 8.0.0 ואילך); צריך להסיר את setMetalRendererEnabled. התופעה: הוצאה משימוש בגרסה 9.0.0 (28 במאי 2024) והוסרה בגרסה 10.0.0; GMSServices לא מופיע יותר ב-setMetalRendererEnabled:.
  • המודול GoogleMapsM4B: יצא משימוש ב-19 במאי 2025. החלפה: צריך להסיר את ה-pod או ה-framework של GoogleMapsM4B. הם קשורים לתוכנית תשלומים מיושנת. תסמין: הוצא משימוש ב-20 בפברואר 2024, הוסר מחבילת Swift בגרסה 9.0.0 ומה-SDK בגרסה 10.0.0.
  • הפצה של CocoaPods: הוצאה משימוש ב-6 באוגוסט 2026. החלפה: Swift Package Manager. תסמין: מצב תחזוקה החל מ-18 באוגוסט 2025. הוצאה משימוש החל מגרסה 11.0.0. למדריך להעברת נתונים (מיגרציה)
  • התקנה של Carthage: הוצאה משימוש ב-27 ביוני 2022. החלפה: Swift Package Manager. התופעה: Carthage לא תומך בספריות שמטרגטות את iOS 13 ואילך. הגרסה העדכנית שזמינה דרך Carthage היא 6.2.1. למדריך להעברת נתונים (מיגרציה)

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

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

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

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

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

‫SDK של מפות ל-iOS: המרת כתובות לקואורדינטות (geocoding)

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

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

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

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