Driver SDK for iOS 快速参考

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:设置

官方 Driver SDK for iOS 软件包:

  • cocoapods:GoogleRidesharingDriver
  • swift_package: https://github.com/googlemaps/ios-driver-sdk

Driver SDK for iOS:常见错误

  • 问题:如果 updateMask 参数为空,则启动后的首次车辆更新可能会失败,并显示“update_mask 不能为空”错误。解决方法:始终在 updateMask 中提供至少一个字段名称,并在 GMTDVehicleReporterListener didFailVehicleUpdate 中处理此错误。请参阅 /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 日起已弃用。替换:GMTDAuthorization fetchTokenWithContext:completion: 替换为 GMTDAuthorizationContext(仅限车辆 ID 声明)。请参阅迁移指南。

Driver SDK for iOS 的用途

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