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:設定
- 驗證:JSON Web Token (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、依行程快取,並在到期時重新整理。請參閱 /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 時,除非您在 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 的行程進度。實驗功能 注意:Consumer SDK 的雲端式地圖樣式設定支援功能已正式發布,而搜尋點密度控制項則是雲端式地圖樣式設定的實驗功能 (僅支援淺色地圖樣式)。
- 在地圖上變更建築物樣式,追蹤 Fleet Engine 的行程進度。實驗功能 注意:Consumer SDK 支援雲端式地圖樣式設定正式發布版,而 3D 和足跡建築物樣式自訂功能,則是雲端式地圖樣式設定實驗功能 (僅支援淺色地圖樣式)。
- 變更地圖上的地標樣式,追蹤 Fleet Engine 的行程進度。實驗功能 注意:Consumer SDK 支援雲端式地圖樣式設定 (正式發布版),而地標圖示自訂功能則是實驗性的雲端式地圖樣式設定功能 (僅支援淺色地圖樣式)。
- 自訂地圖上的標記,追蹤 Fleet Engine 的行程進度。
- 在地圖上自訂路線折線,追蹤 Fleet Engine 的行程進度。