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: 設定
- 認証: JSON Web Token(JWT)、API キー
- 有効にする必要があるその他のサービス: Fleet Engine Service、Maps SDK for Android
- スタートガイド: Consumer SDK for Android を設定する
- リファレンス: Consumer SDK for Android リファレンス
- ポリシー: Consumer SDK for Android のポリシー
- リリースノート: Consumer SDK for Android のリリースノート
公式の Consumer SDK for Android パッケージ:
- Maven:
com.google.android.libraries.mapsplatform.transportation:transportation-consumer
Consumer SDK for Android: 関連商品
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 でできること
各タスクについては、以下のリンク先のガイドをご覧ください。また、機能エクスプローラでプロダクトを比較することもできます。
- 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 からのルートの進行状況を追跡する地図上で、ルートのポリラインをカスタマイズします。