Consumer SDK for Android 快速参考

Consumer SDK for Android 是 Fleet Engine for on-demand trips 的一部分。它提供了一些接口,用于在 Fleet Engine 中对行程数据进行建模并跟踪行程;还提供了一些类,用于构建基于地图的显示,以便在 Android 应用中与消费者分享行程进度(车辆位置、路线、预计到达时间、剩余距离、路况)。

Consumer SDK for Android:关键信息

  • 产品:Consumer SDK for Android
  • 别名:Android Consumer SDK、Consumer SDK、Mobility Services On-demand Trips 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 消费者 SDK。
  • 您需要通过司机的 Android 应用报告司机位置和行程进度。请改用 Driver SDK for Android。

Consumer SDK for Android:设置

官方 Consumer SDK for Android 软件包:

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

Consumer SDK for Android:常见错误

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

请参阅下面链接的各项任务指南,或在功能探索器中比较不同产品。