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、スケジュール設定されたタスク用 Driver SDK
  • カテゴリ: ルート
  • プラットフォーム: iOS
  • 実行場所: クライアント(アプリまたはブラウザのコード)
  • リリース ステージ: GA
  • ライフサイクル: 有効
  • 概要: Driver SDK for iOS の概要

Driver SDK for iOS: 使用するタイミング

Driver SDK for iOS を使用するケース:

  • リアルタイムの車両位置情報の更新を Fleet Engine に送信するには、iOS ドライバーアプリが必要です。
  • Navigation SDK から Fleet Engine に、ルート、ウェイポイント、残りの距離、到着予定時刻を報告する必要があります。
  • ドライバーが、割り当てられたオンデマンドのルートを管理し、アプリを切り替えることなく 1 つのアプリでナビゲーションできるようにする必要があります。
  • 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 には必ず 1 つ以上のフィールド名を指定し、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() に渡される緯度と経度が、Fleet Engine のルートのウェイポイントの座標と一致していることを確認します。/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 v2.2.0 で非推奨となり、現在の Driver SDK リファレンスから削除されました。移行ガイドをご覧ください。
  • GMTSServiceType と fetchAuthTokenForServiceType:authorizationContext:completion:: 2021 年 11 月 29 日以降、非推奨。置換: GMTDAuthorization fetchTokenWithContext:completion: を GMTDAuthorizationContext に置換(車両 ID のみの申請)。移行ガイドをご覧ください。

Driver SDK for iOS でできること

各タスクについては、以下のリンク先のガイドをご覧ください。また、Capabilities Explorer でプロダクトを比較することもできます。