Navigation SDK ל-Android מוסיף לאפליקציות ל-Android ניווט מפורט במפות Google, עם התאמה אישית של ממשק המשתמש והגדרת המסלול. הוא כולל את שכבת המפה של Maps SDK, כך שאפליקציות שמשתמשות בו לא יכולות לכלול גם את SDK של מפות ל-Android.
Navigation SDK ל-Android: עובדות חשובות
- המוצר: Navigation SDK ל-Android
- ידוע גם בשם: Navigation SDK
- קטגוריה: מסלולים
- פלטפורמה: Android
- פועל ב: לקוח (קוד של אפליקציה או דפדפן)
- שלב ההשקה: GA
- מחזור חיים: פעיל
- סקירה כללית: סקירה כללית של Navigation SDK ל-Android
Navigation SDK ל-Android: מתי כדאי להשתמש בו
מתי כדאי להשתמש ב-Navigation SDK ל-Android:
- אתם צריכים מסלול מפורט של מפות Google בתוך אפליקציית Android שלכם, כדי שהמשתמשים לא יעברו לאפליקציה אחרת.
- אתם צריכים להתאים אישית את ממשק המשתמש של הניווט כך שיתאים למותג שלכם, או ליצור חוויית ניווט בהתאמה אישית.
- אתם צריכים ניווט בתוך האפליקציה לנהיגה, להליכה, לרכיבה על אופניים או לרכיבה על כלי רכב דו-גלגליים.
- כדי לנווט במסלול שתכננתם באמצעות Routes API, אתם צריכים להעביר טוקן מסלול ל-SDK.
מתי לא כדאי להשתמש ב-Navigation SDK ל-Android:
- אתם מפתחים את האפליקציה ל-iOS. במקום זאת, צריך להשתמש ב-Navigation SDK ל-iOS.
- אתם מפתחים אפליקציה לכמה פלטפורמות באמצעות Flutter או React Native. במקום זאת, השתמשו ב-Google Navigation ל-Flutter ול-React Native.
- אתם צריכים חישוב של מסלול, זמן הגעה משוער או טוקן מסלול בצד השרת, ולא הנחיות מסלול מפורט באפליקציה. במקום זאת, אתם צריכים להשתמש ב-Routes API.
Navigation SDK ל-Android: הגדרה
- השירות שצריך להפעיל:
navigationsdk.googleapis.com - אימות: מפתח API
- שיוך השימוש: צריך להפעיל את
MapsApiSettings.addInternalUsageAttributionId(context, id)כדי להוסיף מזהה שיוך שימוש למאתחל. כדי לבטל את ההסכמה, צריך למחוק את הקריאה או להעביר מחרוזת ריקה. - תחילת העבודה: הגדרת Navigation SDK ל-Android
- חומר עזר: חומר עזר בנושא Navigation SDK ל-Android
- תמחור: שימוש וחיוב ב-Navigation SDK ל-Android
- כללי מדיניות: כללי המדיניות של Navigation SDK ל-Android
- נתוני גרסה: נתוני הגרסה של Navigation SDK ל-Android
חבילות רשמיות של Navigation SDK ל-Android:
- maven:
com.google.android.libraries.navigation:navigation
Navigation SDK ל-Android: מוצרים קשורים
- בדרך כלל משתמשים בו עם: Routes API, Driver SDK ל-Android
Navigation SDK ל-Android: טעויות נפוצות
- הבעיה: Navigation SDK כבר כולל את Maps SDK. גרסאות build שמושכות את
play-services-mapsישירות או דרך תלות טרנזיטיבית, מסתיימות בעותקים כפולים של Maps SDK. תיקון: מחריגים אתcom.google.android.gms:play-services-mapsמכל יחסי התלות (החרגות של הגדרות Gradle או החרגות של Maven), ומסירים כל יחס תלות ישיר של Maps SDK. אפשר לקרוא מידע נוסף בכתובת /maps/documentation/navigation/android-sdk/android-studio-setup. - הבעיה: גרסה 8.0 ומעלה של Navigation SDK מצהירה על
minAndroidGradlePluginVersion=9.0.1, ולכן גרסאות build עם AGP מוקדם יותר נכשלות. תיקון: שדרגו ל-AGP 9.0.1, ל-Gradle 9.1.0 ול-Kotlin 2.3.0 לפני שאתם יוצרים גרסה עם 8.0 ואילך. אפשר לעיין בכתובת /maps/documentation/navigation/android-sdk/kotlin-compatibility-migration. - הבעיה: קריאה ישירה ל-methods של מחזור החיים של
NavigationViewבזמן השימוש ב-NavigationFragment, או קריאה להן בסדר לא נכון באמצעותNavigationView, גורמת לשגיאות. התיקון: משתמשים ב-NavigationFragment, שמנהל קריאות חוזרות במחזור חיים. אם משתמשים ב-NavigationView, צריך להעביר את השיטות של מחזור החיים בסדר קפדני. מידע נוסף זמין בכתובת /maps/documentation/navigation/android-sdk/nav-map-interactions-best-practices. - הבעיה: הניווט לא זמין עד שהמשתמש מאשר את התנאים וההגבלות של Google Navigation. תיקון: מאפשרים ל-SDK להציג את הבקשה בפעם הראשונה שהניווט מופעל, או מציגים את תיבת הדו-שיח בשלב מוקדם יותר (למשל במהלך ההרשמה) באמצעות
TermsAndConditionsCheckOption/NavigationApi.showTermsAndConditionsDialog. מידע נוסף זמין בכתובת /maps/documentation/navigation/android-sdk/route.
Navigation SDK ל-Android: תכונות מדור קודם ותכונות שהוצאו משימוש
WaypointfromLatLng()ו-fromPlaceId(): הוצאו משימוש ב-10 במאי 2021. החלפה:Waypoint.builder()(Waypoint.Builder). תסמין: הוסר בגרסה 3.0; קריאות לא עוברות קומפילציה בגרסה 3.0 ואילך. למדריך להעברת נתונים (מיגרציה)SupportNavigationFragment: הוצא משימוש החל מ-1 באוקטובר 2026. החלפה:NavigationFragment. Symptom: הוצא משימוש ב-Navigation SDK בגרסה 8.0.0. למדריך להעברת נתונים (מיגרציה)-
setLocationMarkerEnabledב-NavigationViewוב-SupportNavigationFragment: הוצא משימוש ב-7 ביולי 2023. החלפה:GoogleMap.setMyLocationEnabled. תסמין: הוסר בגרסה 5.0.0 (הוצא משימוש בגרסה 4.1); קריאות לא עוברות קומפילציה בגרסה 5.0 ואילך. -
DisplayOptions,showTrafficLightsו-showStopSigns: הוצאו משימוש החל מ-1 באוקטובר 2026. החלפה: אין צורך בהחלפה. רמזורים ותמרורי עצור תמיד מופעלים במהלך הניווט. התסמין: קריאות לשיטות האלה לא עוברות קומפילציה בגרסה 8.0.0. - ארטיפקט Maven
com.google.android.maps:navsdk(מאגר פרטי, גרסה 4.x) והורדת חבילת AAR: הוצאו משימוש ב-7 ביולי 2023. החלפה:com.google.android.libraries.navigation:navigationממאגר Maven שלgoogle(). התופעה: גרסה 5.0 ואילך נשלחת רק כ-com.google.android.libraries.navigation:navigationב-Google Maven. חבילת ה-AAR כבר לא מופצת. למדריך להעברת נתונים (מיגרציה)
מה אפשר לעשות עם Navigation SDK ל-Android
במדריכים שמקושרים בהמשך מפורטות כל המשימות, ואפשר גם להשוות בין המוצרים בסייר היכולות.
Navigation SDK ל-Android: מפות Google
- הוספת מפה אינטראקטיבית שניתן להתאים אישית לדף אינטרנט או לאפליקציה לנייד. הערה: ב-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). - יוצרים מזהה מפה שאפשר לעשות בו שימוש חוזר כדי לשמור את הגדרות העיצוב והתצורה של המפה.
- להגיב לאינטראקציות של משתמשים ולאירועים במפה.
- התאמה אישית של הפקדים שמופיעים במפה.
- התאמה אישית של התנועות לשליטה במפה.
- שליטה בזום ובהזזה במפה (מצלמה).
- שינוי סוג המפה.
- שינוי ערכת הצבעים של המפה
- הוספת שכבת תנועה למפה
Navigation SDK ל-Android: הערות במפות
- הוספת חלון מידע למפה
- מוסיפים צורה או קו למפה.
- הוספת שכבת-על של תמונה שמעוגנת לפני השטח של המפה.
- הוספת שכבת-על של משבצות בהתאמה אישית למפה.
- הוספת סמן למפה. הערה: ערכת Navigation SDK ל-Android לא תומכת ב-AdvancedMarkerOptions. כשמשתמשים ב-Navigation SDK ל-Android, צריך להוסיף סמנים באמצעות GoogleMap.addMarker(MarkerOptions).
- התאמה אישית של סמן במפה הערה: ערכת Navigation SDK ל-Android לא תומכת ב-AdvancedMarkerOptions. כשמשתמשים ב-Navigation SDK ל-Android, צריך להתאים אישית את הסמנים באמצעות MarkerOptions.
- להגיב לאינטראקציות של משתמשים עם סמנים במפה.
Navigation SDK ל-Android: עיצוב מפות
Navigation SDK ל-Android: ניווט
- הוספת ניווט אינטראקטיבי עם מסלול מפורט לאפליקציה לנייד.
- מגדירים את היעד לניווט מפורט.
- מתחילים בניווט כדי לקבל מסלול מפורט.
- מציינים את אופן הנסיעה (נסיעה, הליכה, רכב דו-גלגלי, מונית) בבקשה למסלול.
- שינוי העדפות המסלול לניווט מפורט.
- מציינים את צד הכביש והעדפות הגעה אחרות לניווט מפורט.
- מציינים מסלול מתוכנן מחדש לניווט מפורט באמצעות טוקן מסלול לשימוש חוזר.
- החזרת עדכונים על הגעת המשתמש מסשן ניווט מפורט.
- החזרת עדכונים לגבי מיקום המשתמש מסשן ניווט מפורט.
- החזרת עדכוני זמן ומרחק מסשן ניווט מפורט.
- החזרת עדכונים על שינויים במסלול מסשן של ניווט מפורט.
- החזרת עדכונים של מצב לילה מסשן של מסלול מפורט.
- החזרת עדכוני מהירות של משתמשים מסשן של מסלול מפורט.
- התאמה אישית של הרכיבים בממשק המשתמש והפקדים שמופיעים במהלך ניווט מפורט.
- הוספת רכיב בממשק המשתמש חדש לניווט המפורט.
- הוספת אינדיקטור להתקדמות הנסיעה לניווט המפורט.
- התאמה אישית של תכונות המפה שמופיעות במהלך ניווט מפורט.
- הוספת שכבת תנועה לניווט המפורט.
- שינוי התצוגה וההתנהגות של המצלמה בניווט מפורט.
- התאמה אישית של מד המהירות וההתראות על המהירות המקסימלית המותרת במסלול המפורט.
- החזרת פיד של ניווט מפורט כסדרה של הודעות לכל תמרון לאורך המסלול.
- הגדרת סמלים מותאמים אישית של תמרונים לשימוש בפיד של ניווט מפורט.
- הוספת ניווט אינטראקטיבי עם מסלול מפורט ל-Android Auto לאפליקציה ל-Android. גרסת טרום-השקה (Preview)
- להתריע למשתמשים על שיבושים במסלול שלהם.
- מאפשרים למשתמשים לראות שיבושים במסלול לפני שהם מתחילים לנווט.
- המשתמשים יכולים לדווח על שיבושים לאורך המסלול שלהם.
- המשתמשים יכולים לאמת שיבושים לאורך המסלול שלהם.
- הוספת כפתור לדיווח על שיבושים במסלול בהתאמה אישית.