Consumer SDK for Android 快速參考指南

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:設定

Android 官方 Consumer SDK 套件:

  • maven:com.google.android.libraries.mapsplatform.transportation:transportation-consumer

Android 適用的 Consumer SDK:常見錯誤

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 的用途

請參閱下方連結的各項工作指南,或在功能探索工具中比較各項產品。