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

Driver SDK for Android は、ドライバーアプリ用のモバイル ツールキットです。Navigation SDK から Fleet Engine に車両の位置、ルート、残りの距離、到着予定時刻の更新情報を送信します。オンデマンドのルートとスケジュール設定されたタスクの両方をサポートしています。

Driver SDK for Android: 主な特長

  • プロダクト: Driver SDK for Android
  • 別名: Driver SDK、オンデマンド トリップ用 Driver SDK、スケジュール設定されたタスク用 Driver SDK
  • カテゴリ: ルート
  • プラットフォーム: Android
  • 実行場所: クライアント(アプリまたはブラウザのコード)
  • リリース ステージ: GA
  • ライフサイクル: 有効
  • 概要: Driver SDK for Android の概要

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

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

  • Android ドライバーアプリで、車両のリアルタイムの位置情報とルートの更新情報を Fleet Engine に送信する必要があります。
  • Navigation SDK から次のウェイポイントまでの残り距離と到着予定時刻を受け取るには、Fleet Engine が必要です。
  • 割り当てられたオンデマンドのルートやスケジュール設定されたタスクを管理し、ナビゲーションを提供するドライバーアプリが 1 つ必要です。

Driver SDK for Android を使用しない場合:

  • アプリでターンバイターン方式のナビのみが必要で、Fleet Engine を使用しない。代わりに Navigation SDK for Android を使用してください。
  • 位置、ルート、距離、到着予定時刻(これらはバックエンド経由で送信されます)以外の車両データの更新を送信する必要があります。代わりに Fleet Engine Service を使用してください。
  • iOS 用のドライバーアプリをビルドします。代わりに Driver SDK for iOS を使用してください。

Driver SDK for Android: 設定

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

  • maven: com.google.android.libraries.mapsplatform.transportation:transportation-driver
  • maven: com.google.android.libraries.navigation:navigation

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

  • 問題: ビルド依存関係で Driver SDK のバージョンが指定されていない場合、IDE は最新バージョンを読み込みます。v7.0.0 以降、新しいビルドは Android 6 と 7(API 23 ~ 25)をサポートしなくなりました。修正: ビルド依存関係で Driver SDK for Android のバージョンを明示的に指定して、サポート対象 OS の最小バージョンが変更されるタイミングを制御します。/maps/documentation/mobility/services/resources/relnotes_driver_sdk_android をご覧ください。
  • 問題: Driver SDK は Navigation SDK に依存しています。Navigation SDK のバージョンが固定されていない場合、プロジェクトは常にメジャー バージョン内の最新の Navigation SDK をダウンロードします。修正: Driver SDK と Navigation SDK の両方の依存関係を追加します。Navigation SDK を固定する場合は、Driver SDK のバージョンに対応するリリースノートに記載されている範囲のバージョンを選択します(例: Driver SDK 7.1 の場合は [7.0, 8.0))。/maps/documentation/mobility/driver-sdk/on-demand/android/configure-project をご覧ください。
  • 問題: SDK は、位置情報の更新時に AuthTokenFactory を介して認証トークンをリクエストします。サーバーが JWT を発行できない場合、Fleet Engine の更新は認可されません。修正: SDK を初期化する前に、サーバーサイドの実装でトークンを発行できることを確認し、有効期限が切れるまでトークンを再利用します。/maps/documentation/mobility/driver-sdk/on-demand/android/authenticate をご覧ください。
  • 問題: ProGuard ビルドで、com.google、io.grpc、okio クラスに関する警告が生成されることがあります。修正: -dontwarn com.google.**、-dontwarn io.grpc.**、-dontwarn okio.** を ProGuard 構成に追加します。/maps/documentation/mobility/driver-sdk/on-demand/android/dependencies をご覧ください。

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

  • StatusListener インターフェース: 2024 年 11 月 25 日以降廃止。交換: DriverStatusListener。症状: Driver SDK for Android v6.0.0 で削除されました。移行ガイドをご覧ください。
  • Nav/Driver SDK for Android v1.x(統合バイナリ): 2022 年 6 月 21 日をもって廃止。代替: Driver SDK v3 以降と Navigation SDK のバイナリを分離します。症状: 2021 年 6 月 21 日に非推奨となり、2022 年 6 月 21 日以降はメンテナンスされていません。Waypoint#fromLatLng や Navigator#startGuidance(resumeIntent) などのメソッドは v3.0 で削除されました。移行ガイドをご覧ください。
  • AuthTokenContext ServiceType: 2021 年 11 月 29 日以降廃止。置換: 含まれている車両 ID とタスク ID の申し立て。症状: v4.0.0 で削除: AuthTokenContext から ServiceType と getServiceType()、AuthTokenContext.Builder から setServiceType。移行ガイドをご覧ください。
  • Task parentId プロパティ: 2022 年 4 月 28 日以降非推奨。交換: trackingId。症状: v4.1.0 で名前が変更されました。古いプロパティはまだ存在しますが、非推奨です。

Driver SDK for Android でできること

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