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:设置
- 身份验证:API 密钥、JSON Web 令牌 (JWT)
- 还需启用:Maps SDK for Android
- 开始使用:设置 Driver SDK for Android
- 参考文档:Driver SDK for Android 参考文档
- 政策:Driver SDK for Android 政策
- 版本说明: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:相关产品
- 通常与以下产品搭配使用:Navigation SDK for Android、Fleet Engine Service
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 中移除。请参阅迁移指南。 AuthTokenContextServiceType:自 2021 年 11 月 29 日起已停用。替换:声明包含的车辆 ID 和任务 ID。症状:在 v4.0.0 中移除了:AuthTokenContext中的ServiceType和getServiceType(),以及AuthTokenContext.Builder中的setServiceType。请参阅迁移指南。TaskparentId属性:自 2022 年 4 月 28 日起已弃用。替换:trackingId。症状:在 v4.1.0 中已重命名;旧属性仍然存在,但已弃用。
Driver SDK for Android 的用途
请参阅下面链接的指南,了解每项任务,或在功能探索器中比较不同产品。
- 向 Fleet Engine 服务报告车辆的实时位置。
- 将车辆行程航点的经纬度坐标从 Navigation SDK 报告给 Fleet Engine 服务。
- 向 Fleet Engine 服务报告车辆到下一个航点的剩余距离。
- 向 Fleet Engine 服务报告车辆到达下一个航点的预计到达时间。
- 向 Fleet Engine 服务报告 Navigation SDK 为车辆提供的路线。