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 の概要

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

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

  • Fleet Engine が追跡するオンデマンドの乗車または配達のルートをユーザーがフォローできる iOS アプリが必要です。
  • 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 を返すように設定します。この 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 でできること

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