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

‫Driver SDK ל-Android היא ערכת כלים לנייד שמיועדת לאפליקציות לנהגים. היא שולחת עדכונים על מיקום הרכב, המסלול, המרחק שנותר וזמן ההגעה המשוער מ-Navigation SDK אל Fleet Engine. הוא תומך גם בנסיעות על פי דרישה וגם במשימות מתוזמנות.

‫Driver SDK ל-Android: עובדות חשובות

  • המוצר: Driver SDK ל-Android
  • ידוע גם בתור: Driver SDK, ‏ Driver SDK for on-demand trips, ‏ Driver SDK for scheduled tasks
  • קטגוריה: מסלולים
  • פלטפורמה: Android
  • פועל ב: לקוח (קוד של אפליקציה או דפדפן)
  • שלב ההשקה: GA
  • מחזור חיים: פעיל
  • סקירה כללית: סקירה כללית של Driver SDK ל-Android

‫Driver SDK ל-Android: מתי כדאי להשתמש בו

מתי כדאי להשתמש ב-Driver SDK ל-Android:

  • כדי לשלוח עדכונים בזמן אמת על מיקום הרכב והמסלול ל-Fleet Engine, צריך להשתמש באפליקציית הנהג ל-Android.
  • כדי לקבל את המרחק שנותר ואת זמן ההגעה המשוער לנקודת הציון הבאה מ-Navigation SDK, צריך להשתמש ב-Fleet Engine.
  • אתם צריכים אפליקציה אחת לנהגים, שגם מנהלת את הנסיעות לפי דרישה או את המשימות המתוזמנות שהוקצו, וגם מספקת ניווט.

מתי לא להשתמש ב-Driver SDK ל-Android:

  • אתם צריכים רק מסלול מפורט באפליקציה ולא משתמשים ב-Fleet Engine. במקום זאת, צריך להשתמש ב-Navigation SDK ל-Android.
  • אתם צריכים לשלוח עדכונים של נתוני הרכב, מלבד מיקום, מסלול, מרחק וזמן הגעה משוער (הנתונים האלה עוברים דרך ה-backend שלכם). במקום זאת, צריך להשתמש ב-Fleet Engine Service.
  • אתם מפתחים את אפליקציית הנהג ל-iOS. במקום זאת, צריך להשתמש ב-Driver SDK ל-iOS.

‫Driver SDK ל-Android: הגדרה

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

  • maven: com.google.android.libraries.mapsplatform.transportation:transportation-driver
  • maven: com.google.android.libraries.navigation:navigation

‫Driver SDK ל-Android: טעויות נפוצות

  • הבעיה: אם תלויות ה-build לא מציינות גרסה של Driver SDK, סביבת הפיתוח המשולבת (IDE) טוענת את הגרסה החדשה ביותר. החל מגרסה 7.0.0, גרסאות build חדשות לא תומכות יותר ב-Android 6 ו-7 (רמות API‏ 23-25). הפתרון: מציינים גרסה מפורשת של Driver SDK ל-Android בתלויות ה-build כדי לשלוט במועד שבו משתנה מערכת ההפעלה המינימלית הנתמכת. אפשר לעיין בכתובת /maps/documentation/mobility/services/resources/relnotes_driver_sdk_android.
  • הבעיה: ערכת Driver SDK תלויה ב-Navigation SDK. אם לא מצמידים גרסה של Navigation SDK, הפרויקט תמיד מוריד את הגרסה הראשית האחרונה של Navigation SDK. הפתרון: מוסיפים את יחסי התלות של Driver SDK ו-Navigation SDK. אם אתם מצמידים את Navigation SDK, בחרו גרסה בטווח שמופיע בנתוני הגרסה של Driver SDK (לדוגמה, [7.0, 8.0) ל-Driver SDK 7.1). אפשר לקרוא מידע נוסף בכתובת /maps/documentation/mobility/driver-sdk/on-demand/android/configure-project.
  • הבעיה: ערכת ה-SDK מבקשת אסימוני הרשאה דרך AuthTokenFactory בזמן עדכון המיקום. אם השרת לא יכול להנפיק אסימוני JWT, אי אפשר לאשר עדכונים ל-Fleet Engine. הפתרון: ודאו שההטמעה בצד השרת יכולה להנפיק טוקנים לפני הפעלת ה-SDK, והשתמשו בטוקנים עד שהם יפוגו. מידע נוסף זמין בכתובת /maps/documentation/mobility/driver-sdk/on-demand/android/authenticate.
  • הבעיה: גרסאות build של ProGuard יכולות להפיק אזהרות לגבי המחלקות com.google,‏ io.grpc ו-okio. הפתרון: מוסיפים את -dontwarn com.google.**,‏ -dontwarn io.grpc.** ו--dontwarn okio.** להגדרות של ProGuard. אפשר לעיין בכתובת /maps/documentation/mobility/driver-sdk/on-demand/android/dependencies.

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

  • ממשק StatusListener: הוצא משימוש ב-25 בנובמבר 2024. החלפה: DriverStatusListener. תסמין: הוסר ב-Driver SDK ל-Android בגרסה 6.0.0. למדריך להעברת נתונים (מיגרציה)
  • Nav/Driver SDK ל-Android בגרסה 1.x (קובץ בינארי משולב): הוצא משימוש ב-21 ביוני 2022. החלפה: קובצי בינארי נפרדים של Driver SDK בגרסה 3 ואילך ושל Navigation SDK. תסמין: הוצא משימוש ב-21 ביוני 2021 ולא מתוחזק אחרי 21 ביוני 2022. שיטות כמו Waypoint#fromLatLng ו-Navigator#startGuidance(resumeIntent) הוסרו בגרסה 3.0. למדריך להעברת נתונים (מיגרציה)
  • AuthTokenContext ServiceType: הוצא משימוש החל מ-29 בנובמבר 2021. החלפה: תביעות בעלות על מזהה הרכב ומזהה המשימה שכלולים. הבעיה: הוסרו בגרסה 4.0.0: ServiceType ו-getServiceType() מ-AuthTokenContext, ו-setServiceType מ-AuthTokenContext.Builder. למדריך להעברת נתונים (מיגרציה)
  • המאפיין Task parentId: הוצא משימוש ב-28 באפריל 2022. החלפה: trackingId. Symptom: השם שונה בגרסה 4.1.0. המאפיין הישן עדיין קיים אבל הוצא משימוש.

מה אפשר לעשות עם Driver SDK ל-Android

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