Driver SDK for Android 是適用於司機應用程式的行動工具包,可將車輛位置、路線、剩餘距離和預計到達時間更新,從 Navigation SDK 傳送至 Fleet Engine。同時支援隨選行程和排定工作。
Android 適用的 Driver SDK:重要資訊
- 產品:Driver SDK for Android
- 別名:Driver SDK、Driver SDK for 隨選 trips、Driver SDK for scheduled tasks
- 類別:路徑
- 平台:Android
- 執行位置:用戶端 (應用程式或瀏覽器程式碼)
- 推出階段:GA
- 生命週期:有效
- 總覽:Driver SDK for Android 總覽
Driver SDK for Android:使用時機
在下列情況下使用 Driver SDK for Android:
- 您需要 Android 司機應用程式,才能將即時車輛位置和路線更新資訊傳送至 Fleet Engine。
- 您需要 Fleet Engine,才能從 Navigation SDK 接收剩餘距離和下一個路線控點的預計到達時間。
- 您需要一個司機應用程式,既能管理指派的隨選行程或排定工作,又能提供導航。
請勿在下列情況使用 Driver SDK for Android:
- 您只需要在應用程式中使用即時路況導航,不使用 Fleet Engine。請改用 Navigation SDK for Android。
- 您需要傳送位置、路線、距離和預計到達時間以外的車輛資料更新 (這些資料會透過後端傳送)。請改用 Fleet Engine Service。
- 您要建構 iOS 司機應用程式。請改用 Driver SDK for iOS。
Driver SDK for Android:設定
- 驗證:API 金鑰、JSON Web Token (JWT)
- 也請啟用:Maps SDK for Android
- 開始使用:設定 Driver SDK for Android
- 參考資料:Driver SDK for Android 參考資料
- 政策:Driver SDK for Android 政策
- 版本資訊:Driver SDK for Android 版本資訊
Android 官方 Driver SDK 套件:
- maven:
com.google.android.libraries.mapsplatform.transportation:transportation-driver - maven:
com.google.android.libraries.navigation:navigation
Driver SDK for Android:相關產品
Driver SDK for Android:常見錯誤
- 問題:如果建構依附元件未指定 Driver SDK 版本,IDE 會載入最新版本;從 7.0.0 版開始,新版本不再支援 Android 6 和 7 (API 23-25)。修正方式:在建構依附元件中,明確指定 Driver SDK for Android 版本,控管何時變更最低支援 OS。請參閱 /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 版本資訊列出的範圍,選擇版本 (例如 Driver SDK 7.1 應選擇 [7.0, 8.0))。請參閱 /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。 - 問題:ProGuard 建構作業可能會產生
com.google、io.grpc和okio類別的警告。修正方式:在 ProGuard 設定中加入-dontwarn com.google.**、-dontwarn io.grpc.**和-dontwarn okio.**。請參閱 /maps/documentation/mobility/driver-sdk/on-demand/android/dependencies。
Driver SDK for Android:舊版和已淘汰的功能
StatusListener介面:自 2024 年 11 月 25 日起停用。替代方案:DriverStatusListener。症狀:已在 Driver SDK for Android 6.0.0 版中移除。請參閱遷移指南。- Nav/Driver SDK for Android 1.x 版 (合併二進位檔):自 2022 年 6 月 21 日起停用。替代方案:獨立的 Driver SDK 3+ 版和 Navigation SDK 二進位檔。問題:2021 年 6 月 21 日淘汰,2022 年 6 月 21 日後不再維護;
Waypoint#fromLatLng和Navigator#startGuidance(resumeIntent)等方法已在 3.0 版中移除。請參閱遷移指南。 AuthTokenContextServiceType:自 2021 年 11 月 29 日起停用。Replacement:針對所含車輛 ID 和任務 ID 的聲明。問題:4.0.0 版已移除AuthTokenContext的ServiceType和getServiceType(),以及AuthTokenContext.Builder的setServiceType。請參閱遷移指南。TaskparentId屬性:自 2022 年 4 月 28 日起已淘汰。替代方案:trackingId。Symptom:在 4.1.0 版中重新命名;舊屬性仍存在,但已淘汰。
Driver SDK for Android 的用途
請參閱下方連結的各項工作指南,或在功能探索工具中比較各項產品。
- 向 Fleet Engine 服務回報車輛的即時位置。
- 將車輛行程路線控點的經緯度座標,從 Navigation SDK 回報給 Fleet Engine 服務。
- 向 Fleet Engine 服務回報車輛到下一個路線控點的剩餘距離。
- 向 Fleet Engine 服務回報車輛預計抵達下一個路線控點的時間。
- 將 Navigation SDK 為車輛提供的路線回報給 Fleet Engine 服務。