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: 設定
- 認証: JSON Web Token(JWT)
- 有効にする必要がある API: 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 を返すように設定します。この 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 からのルートの進行状況を追跡する地図上のアイコンとテキストラベルのスタイルを変更します。
- Fleet Engine からのトリップの進行状況を追跡する地図で、ズームレベルごとに異なる地図のスタイルを適用します。
- Fleet Engine からのルートの進行状況を追跡する地図上の場所の密度を変更します。試験運用版 注: Consumer SDK での Cloud ベースのマップのスタイル設定のサポートは一般提供されていますが、スポットの密度制御は Cloud ベースのマップのスタイル設定の試験運用版機能です(ライトマップ スタイルでのみサポートされています)。
- Fleet Engine からのルートの進行状況を追跡する地図上の建物のスタイルを変更します。試験運用版 注: Consumer SDK での Cloud ベースのマップのスタイル設定のサポートは一般提供されていますが、3D とフットプリントの建物のスタイル カスタマイズは、Cloud ベースのマップのスタイル設定の試験運用版機能です(ライトマップ スタイルでのみサポートされています)。
- Fleet Engine からのルートの進行状況を追跡する地図上のランドマークのスタイルを変更します。試験運用版 注: Consumer SDK での Cloud ベースのマップのスタイル設定のサポートは一般提供されていますが、ランドマーク アイコンのカスタマイズは、Cloud ベースのマップのスタイル設定の試験運用版機能です(ライトマップ スタイルでのみサポートされています)。
- Fleet Engine からのルートの進行状況を追跡する地図上のマーカーをカスタマイズします。
- Fleet Engine からのルートの進行状況を追跡する地図上で、ルートのポリラインをカスタマイズします。