Driver SDK for iOS 快速參考

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:設定

官方 Driver SDK for iOS 套件:

  • cocoapods:GoogleRidesharingDriver
  • swift_package: https://github.com/googlemaps/ios-driver-sdk

Driver SDK for iOS:常見錯誤

  • 問題:如果 updateMask 參數空白,啟動後第一次更新車輛時,可能會失敗並顯示「update_mask cannot be empty」訊息。修正方式:請務必在 updateMask 中提供至少一個欄位名稱,並在 GMTDVehicleReporterListener didFailVehicleUpdate 中處理這項錯誤。請參閱 /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 日起淘汰。替換:GMTDAuthorization fetchTokenWithContext:completion: 替換為 GMTDAuthorizationContext (僅限車輛 ID 聲明)。請參閱遷移指南。

iOS 版 Driver SDK 的用途

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