Driver SDK for Android 快速参考

Driver SDK for Android 是一款适用于司机应用的移动工具包,可将 Navigation SDK 中的车辆位置、路线、剩余距离和预计到达时间更新发送到 Fleet Engine。它同时支持按需行程和预定任务。

Driver SDK for Android:关键信息

  • 产品:Driver SDK for Android
  • 别名:Driver SDK、Driver SDK for on-demand 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:设置

官方 Driver SDK for Android 软件包:

  • maven:com.google.android.libraries.mapsplatform.transportation:transportation-driver
  • maven:com.google.android.libraries.navigation:navigation

Driver SDK for Android:常见错误

  • 问题:如果 build 依赖项未指定 Driver SDK 版本,IDE 会加载最新版本;从 v7.0.0 开始,新 build 不再支持 Android 6 和 7(API 23-25)。解决方法:在 build 依赖项中指定明确的 Driver SDK for Android 版本,以控制最低支持操作系统版本的变更时间。请参阅 /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 build 可能会针对 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 for Android:旧版和已弃用的功能

  • StatusListener 接口:自 2024 年 11 月 25 日起已停用。替换:DriverStatusListener。症状:已在 Driver SDK for Android v6.0.0 中移除。请参阅迁移指南。
  • Nav/Driver SDK for Android v1.x(合并二进制文件):自 2022 年 6 月 21 日起停用。替代方案:单独的 Driver SDK v3+ 和 Navigation SDK 二进制文件。症状:于 2021 年 6 月 21 日弃用,在 2022 年 6 月 21 日之后不再维护;Waypoint#fromLatLng 和 Navigator#startGuidance(resumeIntent) 等方法已在 v3.0 中移除。请参阅迁移指南。
  • AuthTokenContext ServiceType:自 2021 年 11 月 29 日起已停用。替换:声明包含的车辆 ID 和任务 ID。症状:在 v4.0.0 中移除了:AuthTokenContext 中的 ServiceType 和 getServiceType(),以及 AuthTokenContext.Builder 中的 setServiceType。请参阅迁移指南。
  • Task parentId 属性:自 2022 年 4 月 28 日起已弃用。替换:trackingId。症状:在 v4.1.0 中已重命名;旧属性仍然存在,但已弃用。

Driver SDK for Android 的用途

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