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: הגדרה
- אימות: מפתח API, JSON Web Token (JWT)
- צריך להפעיל גם את: SDK של מפות ל-Android
- תחילת העבודה: הגדרת Driver SDK ל-Android
- חומר עזר: חומר עזר בנושא Driver SDK ל-Android
- כללי מדיניות: כללי המדיניות של Driver SDK ל-Android
- נתוני גרסה: נתוני הגרסה של 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: מוצרים קשורים
- בדרך כלל משתמשים בו עם: Navigation SDK ל-Android, Fleet Engine Service
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. למדריך להעברת נתונים (מיגרציה) AuthTokenContextServiceType: הוצא משימוש החל מ-29 בנובמבר 2021. החלפה: תביעות בעלות על מזהה הרכב ומזהה המשימה שכלולים. הבעיה: הוסרו בגרסה 4.0.0:ServiceTypeו-getServiceType()מ-AuthTokenContext, ו-setServiceTypeמ-AuthTokenContext.Builder. למדריך להעברת נתונים (מיגרציה)- המאפיין
TaskparentId: הוצא משימוש ב-28 באפריל 2022. החלפה:trackingId. Symptom: השם שונה בגרסה 4.1.0. המאפיין הישן עדיין קיים אבל הוצא משימוש.
מה אפשר לעשות עם Driver SDK ל-Android
במדריכים שמקושרים בהמשך מפורטות כל המשימות, ואפשר גם להשוות בין המוצרים בסייר היכולות.
- דיווח על המיקום של הרכב בזמן אמת לשירות Fleet Engine.
- דיווח על קואורדינטות קו הרוחב/קו האורך של נקודות הציון של נסיעת הרכב מ-Navigation SDK לשירות Fleet Engine.
- דיווח לשירות Fleet Engine על המרחק שנותר לרכב עד לנקודת הציון הבאה.
- דיווח לשירות Fleet Engine על זמן ההגעה המשוער של הרכב לנקודת הציון הבאה שלו.
- דיווח על המסלול שסופק לרכב על ידי Navigation SDK לשירות Fleet Engine.