Consumer SDK for iOS 快速参考

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

官方 Consumer SDK for iOS 软件包:

  • cocoapods:GoogleRidesharingConsumer
  • swift_package: https://github.com/googlemaps/ios-consumer-sdk

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} 格式,行程监控会失败,并显示 400 INVALID_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 的用途

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