iOS 版 Driver SDK 是一个移动应用工具包,也是 Fleet Engine 的一个组件。它会将司机应用的车辆位置、路线、航点、剩余距离和预计到达时间从 Navigation SDK 发送到 Fleet Engine,以便执行按需行程和预定任务。
Driver SDK for iOS:关键信息
- 产品:Driver SDK for iOS
- 别名:Driver SDK、Driver SDK for on-demand trips、Driver SDK for scheduled tasks
- 类别:路线
- 平台:iOS
- 运行位置:客户端(应用或浏览器代码)
- 发布阶段:GA
- 生命周期:有效
- 概览:Driver SDK for iOS 概览
Driver SDK for iOS:何时使用
在以下情况下使用 Driver SDK for iOS:
- 您需要使用 iOS 司机应用向 Fleet Engine 发送实时车辆位置信息更新。
- 您需要将路线、航点、剩余距离和预计到达时间从 Navigation SDK 报告给 Fleet Engine。
- 您需要让司机在一个应用中管理分配的按需行程并进行导航,而无需切换应用。
- 您正在为 iOS 上的 Fleet Engine 预定任务构建司机应用。
在以下情况下,请勿使用 Driver SDK for iOS:
- 您只需要在 iOS 应用中提供精细导航,而不需要 Fleet Engine 跟踪。请改用 Navigation SDK for iOS。
- 您需要在消费者应用中向乘客或客户显示行程或配送进度。请改用 Consumer SDK for iOS。
- 您需要发送除位置和路线之外的车辆数据更新;这些更新会通过您的后端发送到 Fleet Engine。请改用 Fleet Engine Service。
- 您的司机应用在 Android 上运行。请改用 Driver SDK for Android。
Driver SDK for iOS:设置
- 身份验证:API 密钥、JSON Web 令牌 (JWT)
- 还需启用:Maps SDK for iOS
- 开始使用:设置 Driver SDK for iOS
- 参考文档:Driver SDK for iOS 参考文档
- 政策:Driver SDK for iOS 政策
- 版本说明:Driver SDK for iOS 版本说明
官方 Driver SDK for iOS 软件包:
- cocoapods:
GoogleRidesharingDriver - swift_package:
https://github.com/googlemaps/ios-driver-sdk
Driver SDK for iOS:相关产品
Driver SDK for iOS:常见错误
- 问题:如果
updateMask参数为空,则启动后的首次车辆更新可能会失败,并显示“update_mask 不能为空”错误。解决方法:始终在updateMask中提供至少一个字段名称,并在GMTDVehicleReporterListenerdidFailVehicleUpdate中处理此错误。请参阅 /maps/documentation/mobility/driver-sdk/on-demand/ios/troubleshoot。 - 问题:如果设备自上次更新后未移动(例如,司机在闲置等待),
GMSRoadSnappedLocationProvider不会继续发送位置信息更新。修复:如需在设备静止时发送新的位置信息更新,请停止GMSRoadSnappedLocationProvider(已添加GMTDVehicleReporter作为其监听器),然后启动该服务。请参阅 /maps/documentation/mobility/driver-sdk/on-demand/ios/vehicle-ready。 - 问题:如果传递给
setDestinations()的坐标与行程的航点不匹配,消费者应用将无法正确呈现行程。解决方法:确保传递给setDestinations()的纬度/经度与 Fleet Engine 中的行程航点坐标一致。请参阅 /maps/documentation/mobility/driver-sdk/on-demand/ios/trip-details。 - 问题:使用乐观版本运算符 (
~>) 可能会导致 build 无法预测、无法重复,而省略版本则会加载最新 SDK,这可能会导致破坏性更改或提高最低 iOS 版本要求。不支持 Carthage。修复:在 CocoaPods 或 Swift Package Manager 中固定确切的 Driver SDK 版本,并在升级前查看版本说明。请参阅 /maps/documentation/mobility/driver-sdk/on-demand/ios/versions。
Driver SDK for iOS:旧版和已弃用的功能
GMTSVehicleMatch类:已弃用。替代方案:Driver SDK 中无需替代方案(车辆匹配在 Fleet Engine 中处理)。症状:在 Driver SDK for iOS v2.2.0 中已弃用,并且已从当前的 Driver SDK 参考文档中省略。请参阅迁移指南。GMTSServiceType和fetchAuthTokenForServiceType:authorizationContext:completion::自 2021 年 11 月 29 日起已弃用。替换:GMTDAuthorizationfetchTokenWithContext:completion:替换为GMTDAuthorizationContext(仅限车辆 ID 声明)。请参阅迁移指南。
Driver SDK for iOS 的用途
请参阅下面链接的指南,了解每项任务,或在功能探索器中比较不同产品。
- 向 Fleet Engine 服务报告车辆的实时位置。
- 将车辆行程航点的经纬度坐标从 Navigation SDK 报告给 Fleet Engine 服务。
- 向 Fleet Engine 服务报告车辆到下一个航点的剩余距离。
- 向 Fleet Engine 服务报告车辆到达下一个航点的预计到达时间。
- 向 Fleet Engine 服务报告 Navigation SDK 为车辆提供的路线。