Consumer SDK for Android クイック リファレンス

Consumer SDK for Android は、オンデマンド移動用の Fleet Engine の一部です。このライブラリには、Fleet Engine でルートデータをモデル化してルートを追跡するインターフェースと、ルートの進行状況(車両の位置、ルート、到着予定時刻、残りの距離、交通状況)を Android アプリでユーザーと共有する地図ベースの表示を構築するクラスが用意されています。

Consumer SDK for Android: 主な特長

  • プロダクト: Consumer SDK for Android
  • 別名: Android Consumer SDK、Consumer SDK、Mobility Services オンデマンド Trips Android Consumer SDK
  • カテゴリ: ルート
  • プラットフォーム: Android
  • 実行場所: クライアント(アプリまたはブラウザのコード)
  • リリース ステージ: GA
  • ライフサイクル: アクティブ
  • 概要: Consumer SDK for Android の概要

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

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

  • Android アプリのユーザーが、バックエンドが Fleet Engine で追跡するオンデマンドのルート(乗車、注文、配達)を追跡できるようにする必要があります。
  • Android ユーザーアプリの地図上に、車両の準リアルタイムの道路にスナップされた位置とルートを表示する必要があります。
  • Android で、Fleet Engine のルートの乗車と降車の到着予定時刻、残りの距離、リアルタイムの交通状況を表示する必要があります。
  • Android のルート共有マップで、ルートマーカー、ルート ポリライン、地図のスタイルをカスタマイズする必要がある。

次の場合、Consumer SDK for Android を使用しないでください。

  • iOS アプリでオンデマンドのルートを共有する必要がある場合は、代わりに Consumer SDK for iOS を使用してください。
  • ウェブページでのルート共有、または配送などのスケジュール設定されたタスクの消費者による追跡が必要な場合。代わりに JavaScript Consumer SDK を使用してください。
  • ドライバーの Android アプリからドライバーの位置情報とルートの進行状況を報告する必要があります。代わりに Driver SDK for Android を使用してください。

Consumer SDK for Android: 設定

公式の Consumer SDK for Android パッケージ:

  • Maven: com.google.android.libraries.mapsplatform.transportation:transportation-consumer

Consumer SDK for Android: よくある間違い

  • 問題: Maps SDK の依存関係が明示的なバージョンに設定されていない場合、Consumer SDK は必要最小限の Maps SDK バージョンを使用します。これにより、それ以降の Maps SDK バージョンの機能に依存するアプリが破損する可能性があります。修正: Gradle または Maven で、transportation-consumer とともに明示的に定義された play-services-maps バージョンを宣言します。/maps/documentation/mobility/journey-sharing/on-demand/android/configure-project をご覧ください。
  • 問題: ルートの共有をトリップの終了後に停止しないと、Fleet Engine への不要なネットワーク リクエストが発生し、メモリリークが発生します。修正: ルートが不要になった場合(onDestroy() の場合や、ルートが COMPLETE の場合など)は、JourneySharingSession.stop() を呼び出します。/maps/documentation/mobility/journey-sharing/on-demand/android/share-journey をご覧ください。
  • 問題: API インスタンスがすでに存在する場合、ConsumerApi.initialize() が例外をスローする(2.0.0 以降)。修正: 最初に ConsumerApi.getInstance() を呼び出し、返された Task を確認して、インスタンスがすでに存在するかどうかを判断します。/maps/documentation/mobility/services/resources/relnotes_consumer_sdk_android をご覧ください。
  • 問題: Consumer SDK v3 以前は、フル R8 モードをサポートしていません。AGP 8.0 以降をターゲットとするアプリでは、ビルドまたはランタイムの問題が発生する可能性があります。修正: AGP 8.0 以降をターゲットとする場合は android.enableR8.fullMode=false を設定し、Consumer SDK 3.0 以降では Kotlin 2.0 で AGP 7.3 以降を使用します。/maps/documentation/mobility/journey-sharing/on-demand/android/migration-guide-v3 をご覧ください。

Consumer SDK for Android: 以前の機能と非推奨の機能

  • ConsumerTrip、ConsumerTripCallback、ConsumerTripManager、ConsumerTripOptions: 2023 年 9 月 15 日以降廃止。交換: TripModel、TripModelCallback、TripModelManager、TripModelOptions。移行ガイドをご覧ください。
  • Trip クラスと Trip.TripStatus / Trip.TripType アノテーション(および TripInfo#getTripStatus()、TripInfo#getTripType()、TripModelCallback#onTripStatusUpdated): 2023 年 9 月 15 日以降非推奨。交換: TripInfo.TripStatus / TripInfo.TripType、TripInfo#getCurrentTripStatus()、TripInfo#getCurrentTripType()、TripModelCallback#onTripStatusUpdate。移行ガイドをご覧ください。
  • MarkerStyleOptions、PolylineStyleOptions: 2021 年 11 月 30 日以降廃止。代替: MarkerOptions と PolylineOptions(Maps SDK と共有)。症状: Consumer SDK は、MarkerOptions のデフォルトではなく、マーカーまたはポリラインのタイプごとに独自のデフォルト スタイルを適用します。移行ガイドをご覧ください。
  • プライベート リポジトリの配布チャネル: 非推奨。代替: Google Maven リポジトリ(バージョン 2.1.0 以降)。移行ガイドをご覧ください。

Consumer SDK for Android でできること

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