מדריך מקוצר ל-Navigation SDK ל-iOS

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

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

  • המוצר: Navigation SDK ל-iOS
  • ידוע גם בשם: Navigation SDK
  • קטגוריה: מסלולים
  • פלטפורמה: iOS
  • פועל ב: לקוח (קוד של אפליקציה או דפדפן)
  • שלב ההשקה: GA
  • מחזור חיים: פעיל
  • ‫Overview: Navigation SDK for iOS overview
  • זמינות אזורית: מוגבלת. מסלולי נסיעה והליכה זמינים ברוב המדינות. מצב התנועה, שיבושים בזמן אמת, רכב דו-גלגלי, רכיבה על אופניים, מגבלות מהירות, רמזורים ותמרורי עצור משתנים בהתאם למדינה. (פרטי הכיסוי)

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

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

  • אתם צריכים ניווט מסלול מפורט של מפות Google בתוך אפליקציה ל-iOS מקורית משלכם, כדי שהמשתמשים לא יעברו בין אפליקציות.
  • אתם צריכים להתאים אישית את ממשק המשתמש של הניווט, את סגנונות המפה, את המצלמה או את הפריסה כך שיתאימו למותג שלכם במהלך ההנחיה.
  • אתם צריכים העדפות מסלול, כמה נקודות דרך או אסימון מסלול מ-Routes API או מ-Route Optimization API.
  • אתם צריכים אירועי נסיעה (מיקום, הגעה, שינויים במסלול, זמן הגעה משוער) או פיד נתונים של מסלול מפורט בשביל ממשק משתמש מותאם אישית להנחיה או בשביל CarPlay.

מתי לא להשתמש ב-Navigation SDK ל-iOS:

  • אתם מפתחים אפליקציה ל-Android. במקרה כזה, צריך להשתמש ב-Navigation SDK ל-Android.
  • אתם מפתחים אפליקציית נייטיב ב-Flutter או ב-React Native. במקרה כזה, השתמשו ב-Google Navigation ל-Flutter ול-React Native.
  • אתם צריכים רק מסלולים, זמני הגעה משוערים או מרחקים בשרת, בלי הנחיות בתוך האפליקציה. במקום זאת, אתם צריכים להשתמש ב-Routes API.

‫Navigation SDK ל-iOS: הגדרה

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

  • swift_package: https://github.com/googlemaps/ios-navigation-sdk (GoogleNavigation)

חבילות שלא צריך להשתמש בהן עם Navigation SDK ל-iOS:

  • ‫cocoapods:‏ GoogleNavigation. ההפצה של CocoaPods הוצאה משימוש החל מגרסה 11.0.0 ונכנסה למצב תחזוקה ב-18 באוגוסט 2025. במקום זאת, אפשר להשתמש ב-Swift Package Manager.

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

  • הבעיה: המסך מתעמעם או נכבה במהלך הניווט כי ה-SDK לא משבית את טיימר חוסר הפעילות של iOS. פתרון: מגדירים את UIApplication.shared.isIdleTimerDisabled = true בזמן הניווט. אפשר לקרוא מידע נוסף בכתובת /maps/documentation/navigation/ios-sdk/route.
  • הבעיה: גרסה ראשית עתידית של ה-SDK תשתמש במד הגובה (CMAltimeter), ואפליקציות בלי NSMotionUsageDescription ב-Info.plist יקרסו בזמן ההפעלה. הוספת המפתח עכשיו לא תשפיע על ההתנהגות הנוכחית. התיקון: מוסיפים את NSMotionUsageDescription (Privacy - Motion Usage Description) אל Info.plist. אפשר לקרוא מידע נוסף בכתובת /maps/documentation/navigation/ios-sdk/route.
  • הבעיה: Places SDK ל-iOS לא כלול ב-Navigation SDK (החל מגרסה 5.0 של Places SDK), ולכן חסרות מחלקות של Places. הפתרון: מתקינים את Places SDK ל-iOS בנפרד, באותה גרסה של Navigation SDK. אפשר לקרוא מידע נוסף בכתובת /maps/documentation/navigation/ios-sdk/xcode-setup.
  • הבעיה: הגדרת יעדים באמצעות אסימון מסלול נכשלת עם השגיאה .travelModeUnsupported אם ה-travelMode של האפליקציה הוא לא driving או twoWheeler. התיקון: מגדירים את mapView.travelMode לערך .driving או .twoWheeler. בודקים את resolvedParameters.travelMode כדי לראות את המצב שבו המסלול משתמש. מידע נוסף זמין בכתובת /maps/documentation/navigation/ios-sdk/route-customizations.

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

  • הפצה של CocoaPods: הוצאה משימוש ב-6 באוגוסט 2026. החלופה: Swift Package Manager. התופעה: מצב תחזוקה החל מ-18 באוגוסט 2025. לא יהיו גרסאות חדשות של CocoaPods אחרי הרבעון השני של 2026. למדריך להעברת נתונים (מיגרציה)
  • GMSNavigator setDestinations:callback:, setDestinations:routingOptions:callback:, setDestinations:routeToken:callback: (GMSRouteStatusCallback): הוצא משימוש החל מ-2 בנובמבר 2026. החלפה: setDestinations:completionHandler:, setDestinations:routingOptions:completionHandler:, setDestinationsWithToken:completionHandler: (GMSNavigationRouteCompletionHandler).
  • מאפיין המכונה GMSServices appCheckTokenProvider: הוצא משימוש ב-24 בספטמבר 2026. החלפה: מאפיין הכיתה GMSServices.appCheckTokenProvider (+[GMSServices setAppCheckTokenProvider:]). תסמין: בגרסה 11.1.0, הגדרת App Check באמצעות GMSServices.sharedServices() נכשלה. למדריך להעברת נתונים (מיגרציה)
  • GMSNavigator continueToNextDestination: הוצא משימוש החל מ-7 באפריל 2026. החלפה: GMSNavigator continueToNextDestinationWithCompletion:.
  • ‫GMSUISettings showsTrafficLights ו-showsStopSigns: הוצאו משימוש החל מ-6 באוגוסט 2026. חלופה: אין צורך בחלופה. רמזורים ותמרורי עצור מוצגים כברירת מחדל במהלך הניווט.
  • סוג המפה .terrain במהלך ניווט פעיל: הוצא משימוש ב-6 באוגוסט 2026. החלפה: סוג המפה .normal (kGMSTypeNormal),‏ .satellite או .hybrid.
  • הפרוטוקולים GMSNavigatorDelegate ו-GMSRoadSnappedLocationProviderDelegate: הוצאו משימוש ב-13 במאי 2021. החלפה: GMSNavigatorListener ו-GMSRoadSnappedLocationProviderListener (צריך להוסיף באמצעות -addListener:; להגדיר את timeUpdateThreshold ואת distanceUpdateThreshold ב-GMSNavigator). אפשר לעיין במדריך להעברת נתונים.

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

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

‫Navigation SDK ל-iOS: עיצוב מפות

‫Navigation SDK ל-iOS: ניווט