Android 適用的 Consumer SDK 是 Fleet Engine 的一部分,用於隨選行程。這項 SDK 提供多種介面,可模擬行程資料並追蹤 Fleet Engine 中的行程,以及多種類別,可建構地圖式螢幕,在 Android 應用程式中與消費者分享行程進度 (車輛位置、路線、預計到達時間、剩餘距離、路況)。
Consumer SDK for Android:重要資訊
- 產品:Consumer SDK for Android
- 別名:Android Consumer SDK、Consumer SDK、Mobility Services 隨選行程 Android Consumer SDK
- 類別:路徑
- 平台:Android
- 執行位置:用戶端 (應用程式或瀏覽器程式碼)
- 推出階段:GA
- 生命週期:有效
- 總覽:Consumer SDK for Android 總覽
Consumer SDK for Android:使用時機
在下列情況下使用 Consumer SDK for Android:
- 您需要讓 Android 應用程式中的消費者追蹤隨選行程 (乘車、訂單或外送),而後端會在 Fleet Engine 中追蹤這些行程。
- 您需要在 Android 消費者應用程式的地圖上,顯示車輛近乎即時、貼齊道路的位置和路線。
- 您需要在 Android 裝置上顯示 Fleet Engine 行程的上車和下車預計到達時間、剩餘距離和即時路況。
- 您需要在 Android 中自訂行程共用地圖的行程標記、路線折線或地圖樣式。
請勿在下列情況使用 Consumer SDK for Android:
- 您需要在 iOS 應用程式中分享隨選行程。請改用 Consumer SDK for iOS。
- 您需要在網頁中分享行程,或追蹤排定任務 (例如運送) 的消費者。請改用 JavaScript Consumer SDK。
- 您需要透過司機的 Android 應用程式回報司機位置和行程進度。請改用 Driver SDK for Android。
Consumer SDK for Android:設定
- 驗證:JSON Web Token (JWT)、API 金鑰
- 同時啟用:Fleet Engine Service、Maps SDK for Android
- 開始使用:設定 Consumer SDK for Android
- 參考資料:Consumer SDK for Android 參考資料
- 政策:Consumer SDK for Android 政策
- 版本資訊:Consumer SDK for Android 版本資訊
Android 官方 Consumer SDK 套件:
- maven:
com.google.android.libraries.mapsplatform.transportation:transportation-consumer
Consumer SDK for Android:相關產品
Android 適用的 Consumer SDK:常見錯誤
- 問題:如果未將 Maps SDK 依附元件設為明確版本,Consumer SDK 會使用最低必要 Maps SDK 版本,這可能會導致依賴後續 Maps SDK 版本功能的應用程式中斷。修正方式:在 Gradle 或 Maven 中,宣告明確定義的
play-services-maps版本和transportation-consumer。請參閱 /maps/documentation/mobility/journey-sharing/on-demand/android/configure-project。 - 問題:行程結束後未停止分享行程,導致向 Fleet Engine 發出不必要的網路要求,並造成記憶體流失。修正方式:在不再需要行程時呼叫
JourneySharingSession.stop(),例如在onDestroy()中或行程為COMPLETE時。請參閱 /maps/documentation/mobility/journey-sharing/on-demand/android/share-journey。 - 問題:如果 API 執行個體已存在 (2.0.0 以上版本),
ConsumerApi.initialize()會擲回例外狀況。修正方式:先呼叫ConsumerApi.getInstance(),並檢查傳回的Task,判斷是否已有執行個體。請參閱 /maps/documentation/mobility/services/resources/relnotes_consumer_sdk_android。 - 問題:Consumer SDK 3 以下版本不支援完整 R8 模式;指定 AGP 8.0 以上版本的應用程式可能會發生建構或執行階段問題。修正方式:如果指定 AGP 8.0 以上版本,請設定
android.enableR8.fullMode=false,並搭配使用 AGP 7.3 以上版本和 Kotlin 2.0,以支援 Consumer SDK 3.0 以上版本。請參閱 /maps/documentation/mobility/journey-sharing/on-demand/android/migration-guide-v3。
Consumer SDK for Android:舊版和已淘汰的功能
ConsumerTrip、ConsumerTripCallback、ConsumerTripManager、ConsumerTripOptions:已於 2023 年 9 月 15 日停用。替代方案:TripModel、TripModelCallback、TripModelManager、TripModelOptions。請參閱遷移指南。Trip類別和Trip.TripStatus/Trip.TripType註解 (以及TripInfo#getTripStatus()、TripInfo#getTripType()、TripModelCallback#onTripStatusUpdated):自 2023 年 9 月 15 日起淘汰。替換:TripInfo.TripStatus/TripInfo.TripType、TripInfo#getCurrentTripStatus()、TripInfo#getCurrentTripType()、TripModelCallback#onTripStatusUpdate。請參閱遷移指南。MarkerStyleOptions和PolylineStyleOptions:自 2021 年 11 月 30 日起停用。替代方案:MarkerOptions和PolylineOptions(與 Maps SDK 共用)。症狀:Consumer SDK 會根據標記或折線類型套用自己的預設樣式,而非MarkerOptions預設值。請參閱遷移指南。- 私人存放區發布管道:已淘汰。替代方案:Google Maven 存放區 (2.1.0 以上版本)。請參閱遷移指南。
Consumer SDK for Android 的用途
請參閱下方連結的各項工作指南,或在功能探索工具中比較各項產品。
- 新增可自訂的互動式地圖,追蹤車輛引擎到行動應用程式的行程進度。
- 在網頁或行動應用程式的地圖上,新增追蹤車輛引擎行程的路線折線。
- 在網頁或行動應用程式的地圖上,更新 Fleet Engine 行程的路線進度。
- 在地圖上變更道路、折線和多邊形的樣式,追蹤 Fleet Engine 的行程進度。
- 在地圖上顯示或隱藏地圖項目,追蹤 Fleet Engine 的行程進度。
- 變更地圖上的圖示和文字標籤樣式,追蹤 Fleet Engine 的行程進度。
- 在地圖上追蹤 Fleet Engine 行程進度時,為不同縮放等級套用不同地圖樣式。
- 變更地圖上地點的密度,追蹤 Fleet Engine 的行程進度。實驗功能 注意:Consumer SDK 的雲端式地圖樣式設定支援功能已正式發布,而搜尋點密度控制項則是雲端式地圖樣式設定的實驗功能 (僅支援淺色地圖樣式)。
- 在地圖上變更建築物樣式,追蹤 Fleet Engine 的行程進度。實驗功能 注意:Consumer SDK 支援雲端式地圖樣式設定正式發布版,而 3D 和足跡建築物樣式自訂功能,則是雲端式地圖樣式設定實驗功能 (僅支援淺色地圖樣式)。
- 變更地圖上的地標樣式,追蹤 Fleet Engine 的行程進度。實驗功能 注意:Consumer SDK 支援雲端式地圖樣式設定 (正式發布版),而地標圖示自訂功能則是實驗性的雲端式地圖樣式設定功能 (僅支援淺色地圖樣式)。
- 自訂地圖上的標記,追蹤 Fleet Engine 的行程進度。
- 在地圖上自訂路線折線,追蹤 Fleet Engine 的行程進度。