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

‫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: הגדרה

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

  • maven: com.google.android.libraries.navigation:navigation

‫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: תכונות מדור קודם ותכונות שהוצאו משימוש

  • Waypoint fromLatLng() ו-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

‫Navigation SDK ל-Android: הערות במפות

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

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