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: הגדרה
- השירות שצריך להפעיל:
navigationsdk.googleapis.com - אימות: מפתח API
- צריך להפעיל גם את: SDK של מפות ל-iOS
- שיוך השימוש: מפעילים את
GMSServices.addInternalUsageAttributionID(_:)(+[GMSServices addInternalUsageAttributionID:]) כדי להוסיף מזהה שיוך שימוש למאתחל. כדי לבטל את ההסכמה, צריך למחוק את הקריאה או להעביר מחרוזת ריקה. - שנתחיל? הגדרת Navigation SDK ל-iOS
- חומר עזר: חומר עזר בנושא Navigation SDK ל-iOS
- תמחור: שימוש וחיוב ב-Navigation SDK ל-iOS
- כללי מדיניות: כללי המדיניות של Navigation SDK ל-iOS
- נתוני גרסה: נתוני הגרסה של 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: מוצרים קשורים
- ממשקי API שמשתמשים בהם לעיתים קרובות עם הממשק הזה: SDK של מפות ל-iOS, Routes API, Route Optimization API, Places SDK ל-iOS
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. למדריך להעברת נתונים (מיגרציה)
GMSNavigatorsetDestinations:callback:,setDestinations:routingOptions:callback:,setDestinations:routeToken:callback:(GMSRouteStatusCallback): הוצא משימוש החל מ-2 בנובמבר 2026. החלפה:setDestinations:completionHandler:,setDestinations:routingOptions:completionHandler:,setDestinationsWithToken:completionHandler:(GMSNavigationRouteCompletionHandler).- מאפיין המכונה
GMSServicesappCheckTokenProvider: הוצא משימוש ב-24 בספטמבר 2026. החלפה: מאפיין הכיתהGMSServices.appCheckTokenProvider(+[GMSServices setAppCheckTokenProvider:]). תסמין: בגרסה 11.1.0, הגדרת App Check באמצעותGMSServices.sharedServices()נכשלה. למדריך להעברת נתונים (מיגרציה) GMSNavigatorcontinueToNextDestination: הוצא משימוש החל מ-7 באפריל 2026. החלפה:GMSNavigatorcontinueToNextDestinationWithCompletion:.-
GMSUISettingsshowsTrafficLightsו-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: ניווט
- הוספת ניווט אינטראקטיבי עם מסלול מפורט לאפליקציה לנייד.
- מגדירים את היעד לניווט מפורט.
- מתחילים בניווט כדי לקבל מסלול מפורט.
- מציינים את אופן הנסיעה (נסיעה, הליכה, רכב דו-גלגלי, מונית) בבקשה למסלול.
- שינוי העדפות המסלול לניווט מפורט.
- מציינים את צד הכביש והעדפות הגעה אחרות לניווט מפורט.
- מציינים מסלול מתוכנן מחדש לניווט מפורט באמצעות טוקן מסלול לשימוש חוזר.
- החזרת עדכונים על הגעת המשתמש מסשן ניווט מפורט.
- החזרת עדכונים לגבי מיקום המשתמש מסשן ניווט מפורט.
- החזרת עדכוני זמן ומרחק מסשן ניווט מפורט.
- החזרת עדכונים על שינויים במסלול מסשן של ניווט מפורט.
- החזרת עדכונים של מצב לילה מסשן של מסלול מפורט.
- החזרת עדכוני מהירות של משתמשים מסשן של מסלול מפורט.
- התאמה אישית של הרכיבים בממשק המשתמש והפקדים שמופיעים במהלך ניווט מפורט.
- הוספת רכיב בממשק המשתמש חדש לניווט המפורט.
- הוספת אינדיקטור להתקדמות הנסיעה לניווט המפורט.
- התאמה אישית של תכונות המפה שמופיעות במהלך ניווט מפורט.
- הוספת שכבת תנועה לניווט המפורט.
- שינוי התצוגה וההתנהגות של המצלמה בניווט מפורט.
- התאמה אישית של מד המהירות וההתראות על המהירות המקסימלית המותרת במסלול המפורט.
- החזרת פיד של ניווט מפורט כסדרה של הודעות לכל תמרון לאורך המסלול.
- הגדרת סמלים מותאמים אישית של תמרונים לשימוש בפיד של ניווט מפורט.
- הוספת ניווט אינטראקטיבי מפורט ל-CarPlay באפליקציה ל-iOS. גרסת טרום-השקה (Preview)
- להתריע למשתמשים על שיבושים במסלול שלהם.
- מאפשרים למשתמשים לראות שיבושים במסלול לפני שהם מתחילים לנווט.
- המשתמשים יכולים לדווח על שיבושים לאורך המסלול שלהם.
- המשתמשים יכולים לאמת שיבושים לאורך המסלול שלהם.
- הוספת כפתור לדיווח על שיבושים במסלול בהתאמה אישית.