借助 iOS 版 Consumer SDK,iOS 消费者应用可以跟踪 Fleet Engine 中的按需行程。其类(例如 GMTCTripModel 和 GMTCJourneySharingSession)可对行程数据进行建模,并在地图上显示车辆的位置、路线、预计到达时间和剩余距离。
Consumer SDK for iOS:关键信息
- 产品:Consumer SDK for iOS
- 别名:iOS Consumer SDK
- 类别:路线
- 平台:iOS
- 运行位置:客户端(应用或浏览器代码)
- 发布阶段:GA
- 生命周期:有效
- 概览:Consumer SDK for iOS 概览
iOS 版 Consumer SDK:何时使用
在以下情况下使用 Consumer SDK for iOS:
- 您需要一款 iOS 应用,以便消费者跟踪 Fleet Engine 跟踪的按需行程或配送行程。
- 您需要在 iOS 消费者应用的地图上显示车辆的近乎实时的位置、路线和实时路况。
- 您需要在 iOS 中显示按需行程的预计接送时间和剩余距离。
- 您已使用 Fleet Engine 和 Driver SDK 来管理按需行程,并且需要行程分享的消费者端功能。
在以下情况下,请勿使用 Consumer SDK for iOS:
- 您需要让消费者跟踪预定任务或配送;预定任务消费者体验已针对 JavaScript 进行了记录。请改用 JavaScript 消费者 SDK。
- 您需要在 Android 消费者应用中分享按需行程进度。请改用 Consumer SDK for Android。
- 您需要在 Web 应用中分享按需行程进度。请改用 JavaScript 消费者 SDK。
- 您需要将司机的位置信息和行程状态从司机的 iOS 应用发送到 Fleet Engine。请改用 Driver SDK for iOS。
Consumer SDK for iOS:设置
- 身份验证:JSON Web 令牌 (JWT)
- 同时启用:Fleet Engine Service
- 开始使用:设置 Consumer SDK for iOS
- 参考文档:Consumer SDK for iOS 参考文档
- 政策:Consumer SDK for iOS 政策
- 版本说明:Consumer SDK for iOS 版本说明
官方 Consumer SDK for iOS 软件包:
- cocoapods:
GoogleRidesharingConsumer - swift_package:
https://github.com/googlemaps/ios-consumer-sdk
Consumer SDK for iOS:相关产品
Consumer SDK for iOS:常见错误
- 问题:如果 JWT 在签名时未包含行程 ID 或已过期,行程监控会失败并显示 401
UNAUTHENTICATED。解决方法:让令牌提供方 (GMTCAuthorization) 返回为授权上下文中的行程 ID 签发的 JWT,按行程缓存该 JWT,并在其过期时进行刷新。请参阅 /maps/documentation/mobility/journey-sharing/on-demand/ios/auth-sdk。 - 问题:如果行程名称未使用
providers/{provider_id}/trips/{trip_id}格式,行程监控会失败,并显示 400INVALID_ARGUMENT。解决方法:将 Google Cloud 项目 ID 用作provider_id,并在初始化 SDK 时将同一项目 ID 作为providerID传递。请参阅 /maps/documentation/mobility/journey-sharing/on-demand/ios/init-sdk。 - 问题:在行程完成或取消后,应用会继续监听更新。解决方法:在行程完成或取消时,对行程模型调用
unregisterSubscriber。请参阅 /maps/documentation/mobility/journey-sharing/on-demand/ios/share-journey。 - 问题:手动 XCFramework 安装会忽略所需的资源包和 build 设置,除非您在 Xcode 中添加它们。解决方法:尽可能使用 CocoaPods。对于手动安装,请将
gRPCCertificates.bundle和GoogleRidesharingConsumer.bundle添加到项目中,关联列出的框架,并将-ObjC添加到“Other Linker Flags”(其他链接器标志)中,以便进行调试和发布。请参阅 /maps/documentation/mobility/journey-sharing/on-demand/ios/setup。
Consumer SDK for iOS:旧版和已弃用的功能
GMTSVehicleLocation-initWithLatLng:latLngAccuracy:heading:headingAccuracy:speed:speedAccuracy:updateTime:isSnappableToRoute:初始化程序:自 2025 年 6 月 1 日起已弃用。替换:将GMTSVehicleLocation-initWithOptions:替换为GMTSVehicleLocationOptions。[GMTCMapView initWithCoder]:自 2023 年 12 月 1 日起已弃用。换货:GMTCMapView-initWithOptions:。
Consumer SDK for iOS 的用途
请参阅下面链接的指南,了解每项任务,或在功能探索器中比较不同产品。
- 添加可自定义的互动式地图,用于跟踪从 Fleet Engine 到移动应用的行程进度。
- 添加路线多段线,用于在网页或移动应用上的地图中跟踪来自 Fleet Engine 的行程。
- 在网页或移动应用中的地图上,更新 Fleet Engine 行程的路线进度。
- 在跟踪 Fleet Engine 行程进度的地图上更改道路、多段线和多边形的样式。
- 在跟踪 Fleet Engine 行程进度的地图上显示或隐藏地图项。
- 在跟踪 Fleet Engine 行程进度的地图上更改图标和文本标签的样式。
- 在跟踪 Fleet Engine 行程进度的地图上,为不同的缩放级别应用不同的地图样式。
- 更改地图上地点的密度,以便跟踪 Fleet Engine 中的行程进度。实验性功能注意:Consumer SDK 中的云端地图样式设置支持功能已正式发布,而地图注点密度控制是一项实验性云端地图样式设置功能(仅在浅色地图样式中受支持)。
- 在跟踪 Fleet Engine 行程进度的地图上更改建筑物的样式。实验性功能 注意:Consumer SDK 中的云端地图样式设置支持功能已正式发布,而 3D 和占地面积建筑样式自定义是一项实验性云端地图样式设置功能(仅在浅色地图样式中受支持)。
- 在跟踪 Fleet Engine 行程进度的地图上更改地标的样式。实验性 注意:Consumer SDK 中的云端地图样式设置支持功能已正式发布,而地标图标自定义是一项实验性云端地图样式设置功能(仅在浅色地图样式中受支持)。
- 在地图上自定义一个标记,用于跟踪 Fleet Engine 中的行程进度。
- 在地图上自定义路线多段线,以跟踪 Fleet Engine 中的行程进度。