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 Consumer SDK。
  • 您需要在 Android 消費者應用程式中分享隨選行程進度。請改用 Consumer SDK for Android。
  • 您需要在網頁應用程式中分享隨選行程進度。請改用 JavaScript Consumer 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、依行程快取,並在到期時重新整理。請參閱 /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 時,除非您在 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 的用途

請參閱下方連結的各項工作指南,或在功能探索工具中比較各項產品。