באמצעות ה-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: הגדרה
- השירות שצריך להפעיל:
maps-ios-backend.googleapis.com - אימות: מפתח API
- שיוך שימוש: קוראים ל-class method
GMSServicesשלaddInternalUsageAttributionID:(Swift:GMSServices.addInternalUsageAttributionID(_:)) כדי להוסיף מזהה שיוך שימוש למאתחל. כדי לבטל את ההסכמה, צריך למחוק את הקריאה או להעביר מחרוזת ריקה. - תחילת העבודה: הגדרת Maps SDK ל-iOS
- חומר עזר: חומר עזר בנושא SDK של מפות ל-iOS
- תמחור: שימוש וחיוב ב-SDK של מפות ל-iOS
- כללי מדיניות: כללי המדיניות של SDK של מפות ל-iOS
- הערות מוצר: הערות מוצר של SDK של מפות ל-iOS
חבילות רשמיות של SDK של מפות ל-iOS:
- swift_package:
https://github.com/googlemaps/ios-maps-sdk
SDK של מפות ל-iOS: מוצרים קשורים
- ממשקי API שמשתמשים בהם לעיתים קרובות עם Places SDK for Android: Geocoding API, Places SDK for iOS
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: מערכי נתונים
- הוספת שכבת KML למפה הערה: ב-Maps JavaScript API, KmlLayer הוצא משימוש (הגרסה האחרונה שנתמכת היא 3.65, והוא יושבת במאי 2027). צריך לעבור לסגנון מבוסס-נתונים לגבולות או למערכי נתונים, או לטעון GeoJSON בשכבת הנתונים. שכבות KML עדיין נתמכות ב-Android וב-iOS דרך ספריות השירות של Maps SDK.
- הוספת נתוני GeoJSON למפה.
- הוספת שכבה של מפת חום למפה.
SDK של מפות ל-iOS: המרת כתובות לקואורדינטות (geocoding)
SDK של מפות ל-iOS: מפות
- הוספת מפה אינטראקטיבית שניתן להתאים אישית לדף אינטרנט או לאפליקציה לנייד. הערה: ב-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). - יוצרים מזהה מפה שאפשר לעשות בו שימוש חוזר כדי לשמור את הגדרות העיצוב והתצורה של המפה.
- להגיב לאינטראקציות של משתמשים ולאירועים במפה.
- התאמה אישית של הפקדים שמופיעים במפה.
- התאמה אישית של התנועות לשליטה במפה.
- שליטה בזום ובהזזה במפה (מצלמה).
- שינוי סוג המפה.
- שינוי ערכת הצבעים של המפה
- הוספת שכבת תנועה למפה
- יצירת עץ מרובע לחיפוש נקודות באזור מסוים.
SDK של מפות ל-iOS: הערות במפות
- הוספת חלון מידע למפה
- מוסיפים צורה או קו למפה.
- הוספת שכבת-על של תמונה שמעוגנת לפני השטח של המפה.
- הוספת שכבת-על של משבצות בהתאמה אישית למפה.
- הוספת סמן למפה. הערה: ערכת 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 של מפות ל-iOS: סגנון מפות
- יצירת סגנון מפה לשימוש חוזר בפלטפורמות שונות.
- שינוי הסגנון של כבישים, קווים פוליגוניים ופוליגונים במפה.
- הצגה או הסתרה של תכונות במפה.
- לשנות את הסגנון של הסמלים ותוויות הטקסט במפה.
- להחיל סגנונות מפה שונים על רמות זום שונות.
- לשנות את צפיפות המקומות במפה. ניסיוני
- לשנות את הסגנון של מבנים במפה. ניסיוני
- שינוי הסגנון של ציוני דרך במפה. ניסיוני
SDK של מפות ל-iOS: Street View
- הוספת תצוגת Google Street View אינטראקטיבית וניתנת להגדרה לדף אינטרנט או לאפליקציה לנייד.
- הוספת סמן או שכבת-על ל-Google Street View.
- להגיב לאינטראקציות ולאירועים של משתמשים ב-Google Street View.
- התאמה אישית של התנועות שזמינות ב-Google Street View
- הנפשה של תנועות המצלמה ב-Google Street View.