Driver SDK for iOS 是行動應用程式工具包,也是 Fleet Engine 的元件。這項服務會將 Navigation SDK 中的司機應用程式車輛位置、路線、路線控點、剩餘距離和預計到達時間,傳送至 Fleet Engine,用於隨選行程和排定工作。
Driver SDK for iOS:重要資訊
- 產品:Driver SDK for iOS
- 別名:Driver SDK、Driver SDK for 隨選 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:設定
- 驗證:API 金鑰、JSON Web Token (JWT)
- 同時啟用:Maps SDK for iOS
- 開始使用:設定 Driver SDK for iOS
- 參考資料:Driver SDK for iOS 參考資料
- 政策:Driver SDK for iOS 政策
- 版本資訊:Driver SDK for iOS 版本資訊
官方 Driver SDK for iOS 套件:
- cocoapods:
GoogleRidesharingDriver - swift_package:
https://github.com/googlemaps/ios-driver-sdk
Driver SDK for iOS:相關產品
Driver SDK for iOS:常見錯誤
- 問題:如果
updateMask參數空白,啟動後第一次更新車輛時,可能會失敗並顯示「update_mask cannot be empty」訊息。修正方式:請務必在updateMask中提供至少一個欄位名稱,並在GMTDVehicleReporterListenerdidFailVehicleUpdate中處理這項錯誤。請參閱 /maps/documentation/mobility/driver-sdk/on-demand/ios/troubleshoot。 - 問題:如果裝置自上次更新後就未移動 (例如司機在原地等待),
GMSRoadSnappedLocationProvider就不會持續傳送位置更新。修正方式:如要在裝置靜止時傳送新的位置更新通知,請停止並啟動GMSRoadSnappedLocationProvider(已新增GMTDVehicleReporter做為事件監聽器)。請參閱 /maps/documentation/mobility/driver-sdk/on-demand/ios/vehicle-ready。 - 問題:如果傳遞至
setDestinations()的座標與行程的路線控點不符,消費者應用程式就無法正確算繪行程。修正方式:確認傳遞至setDestinations()的經緯度與車隊引擎中的行程路線控點座標相符。請參閱 /maps/documentation/mobility/driver-sdk/on-demand/ios/trip-details。 - 問題:使用樂觀版本運算子 (
~>) 可能會導致建構作業無法預測且無法重複,而省略版本則會載入最新版 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 2.2.0 版已淘汰,且目前的 Driver SDK 參考資料已省略。請參閱遷移指南。GMTSServiceType和fetchAuthTokenForServiceType:authorizationContext:completion::自 2021 年 11 月 29 日起淘汰。替換:GMTDAuthorizationfetchTokenWithContext:completion:替換為GMTDAuthorizationContext(僅限車輛 ID 聲明)。請參閱遷移指南。
iOS 版 Driver SDK 的用途
請參閱下方連結的各項工作指南,或在功能探索工具中比較各項產品。
- 向 Fleet Engine 服務回報車輛的即時位置。
- 將車輛行程路線控點的經緯度座標,從 Navigation SDK 回報給 Fleet Engine 服務。
- 向 Fleet Engine 服務回報車輛到下一個路線控點的剩餘距離。
- 向 Fleet Engine 服務回報車輛預計抵達下一個路線控點的時間。
- 將 Navigation SDK 為車輛提供的路線回報給 Fleet Engine 服務。