このセクションには、Android 用 Driver SDK のリリースノートが記載されています。
お知らせ: API レベル 23、24、25 のサポートの凍結
モバイル OS バージョンのサポート ポリシーに準拠して、Android 向け Driver SDK の今後のメジャー バージョンでは、Android 6 と 7(API レベル 23、24、25)のサポートを凍結します。
2025 年第 4 四半期以降にリリースされる Android 向け Driver SDK のバージョンでは、最小で Android 8(API レベル 26)がサポートされます。以前の SDK バージョンは、引き続き Android 6 と 7 をサポートします。
依存関係でバージョン番号が指定されていない場合、IDE は最新の SDK バージョンを読み込み、アプリの新しいビルドは Android 6 と 7 をサポートしません。
アプリの新しいバージョンでサポートされる OS の最小バージョンをいつ引き上げるかを制御するには、アプリのビルド依存関係で Android 用 Driver SDK のバージョンを指定します。
v6.2.0(2025 年 6 月 18 日)
バグの修正
DriverStatusListener
が指定されていないときにDriverApi.createInstance()
を呼び出すとNullPointerException
がクラッシュする問題を修正しました。
依存関係と構成の変更
Driver SDK for Android のバージョン 6.2.0 以降では、アプリを Kotlin 2.1 にアップグレードする必要があります。
Navigation SDK のサポート対象バージョンを更新しました(v6.1.0 以降)。
v6.1.0(2025 年 3 月 10 日)
バグの修正
- 内部ロギングを改善しました。
v5.99.1(2025 年 1 月 10 日)
バグの修正
- ドライバがコード「INTERNAL」と「Panic! インストール後のアプリの初回起動時に表示される「これはバグです」という説明。
v6.0.0(2024 年 11 月 25 日)
バグの修正
- ドライバがコード「INTERNAL」と「Panic! これはバグです」という説明。
- 特にデバイスがネットワークを切り替える際に、位置情報の更新接続エラーを減らすための内部的な改善。リリースが統合されると、段階的に(0% から)ロールアウトされます。
API の更新
- 非推奨のインターフェース
StatusListener
を削除しました。
依存関係と構成の変更
- POM.xml で
glide:cronet-integration
への依存関係を削除 - Navigation SDK のサポート対象バージョンを v5.x に更新しました。
- Driver SDK for Android のバージョン 6.0.0 以降、アプリは Kotlin 2.0 にアップグレードする必要があります。
- targetSdk が API レベル 34 になりました。これは、2024 年 8 月以降に Google Play ストアにデプロイされるすべてのアプリの要件です。Google Play の対象 API レベルの要件を満たすをご覧ください。
v5.99.0(2024 年 9 月 20 日)
バグの修正
- ドライバがコード「INTERNAL」と「Panic! これはバグです」という説明が表示されます。リリースが統合されると、段階的に(0% から)ロールアウトされます。
- 特にデバイスがネットワークを切り替える際に、位置情報の更新接続エラーを減らすための内部的な改善。リリースが統合されると、段階的に(0% から)ロールアウトされます。
依存関係と構成の変更
- POM.xml で
glide:cronet-integration
への依存関係を削除
v5.0.0(2023 年 9 月 12 日)
依存関係と構成の変更
- Navigation SDK を v5.x に更新しました。
minSdkVersion
を API 23 にアップグレードしました。- Kotlin のバージョンを 1.9.0 にアップグレードしました。
- Room への依存関係を追加しました。* Driver SDK を使用するアプリは、API 31 以上の
targetSdkVersion
を持つ必要があります。 - Driver SDK を使用するアプリは、Java 8 ライブラリのサポートを有効にする必要があります。更新手順については、https://developer.android.com/studio/write/java8-support をご覧ください。
- Proguard または Dexguard を使用するアプリは、R8 に移行する必要があります。詳細については、https://developer.android.com/build/shrink-code をご覧ください。
- Driver SDK を使用するアプリでは、脱糖を有効にする必要があります。手順については、https://developer.android.com/studio/write/java8-support#library-desugaring をご覧ください。
バグの修正
- disableLocationTracking の同期に関する問題を修正しました。
- 例外ステータスの更新で原因を報告する新しい DriverStatusListener インターフェースを導入しました。
- ドライバーが静止したままになる問題を修正しました(v4.99.0 以降で利用可能)。
v4.99.0(2023 年 8 月 9 日)
- NavSDK 依存関係のさまざまなバージョンをサポートします。** v4.5.0 から v5.0.0(v5.0.0 を除く)までをサポートします。
- 車両が停止しているときに到着予定時刻が自動的に短縮されないようにします。この変更はテストとして段階的に導入されるため、すべてのアプリで同時に変更が反映されるわけではありません。
v4.5.0(2023 年 5 月 12 日)
- Navigation SDK の依存関係を v4.5 に更新しました。Navigation SDK のグループ ID とアーティファクト ID が変更されました。
バージョン 4.4.3(2023 年 3 月 20 日)
依存関係の変更
- Navigation SDK の依存関係を v4.4.1 にアップグレードしました。
v4.4.2(2023 年 2 月 15 日)
バグの修正
SDK で一時的な接続の問題が発生した場合のネットワーク復旧時間を改善します。これは試験運用版の修正です。
「Raw」位置情報のみを含む
UpdateVehicle
リクエストを破棄します。「ルートの概要」アルファ版 API の競合状態を修正しました。
v4.4.1(2022 年 11 月 18 日)
バグの修正
- トラフィック アップロード ロジックのバグを修正しました。
その他の変更
- リクエスト ヘッダーとステータス コードのレポート機能の内部的な改善。
v4.4.0(2022 年 9 月 21 日)
バグの修正
- API インスタンスがクリアされていない場合に「Google マップで運転中」の通知が削除されないバグを修正しました。
依存関係の変更
- Navigation SDK の依存関係を v4.2.2 にアップグレードしました。
v4.3.0(2022 年 8 月 24 日)
内部的な改善。
お知らせ: Android 5 のサポート終了(2022 年 7 月 21 日)
最新の SDK バージョン(v4.2.0)では、Android 5 で動作するアプリ(API レベル 21 と 22 の両方)のサポートを 1 年間延長します。
具体的な内容:
- Android アプリで実行される Navigation SDK と Driver SDK は、2023 年 6 月 30 日まで Android 5(API レベル 21)以上をサポートします。
- 2023 年 6 月 30 日以降は、Android API レベル 23 以上のみをサポートします。つまり、この日以降は、すべての SDK バージョンで Android API レベル 21 と 22 のサポートが終了します。つまり、SDK バージョン(4.x を含む)の Android 21 または 22 に関連するバグは修正されず、SDK が正しく動作することは保証されません。
このお知らせは、2021 年 6 月 21 日の Android 21 と 22 のサポート凍結のお知らせと、2021 年 10 月 18 日の Android 23、24、25 のサポート凍結のお知らせに優先します。
v4.2.0(2022 年 6 月 8 日)
依存関係の変更
- Nav SDK の依存関係を v4.1.3 にアップグレードしました。
- サポートされる最小 Android API レベルを 21 に引き下げます。
v4.1.0(2022 年 4 月 28 日)
API の更新
Task
オブジェクトのparentId
プロパティの名前をtrackingId
に変更しました。古いプロパティは当面の間は引き続き存在しますが、非推奨となります。
v4.0.0(2021 年 11 月 29 日)
このリリースでサポートされる最小 Android API レベルは 23 です。
API の更新
このリリースでは、Android 用 Driver SDK が以下の変更で更新されています。
VehicleStops API の変更
VehicleStop
オブジェクトは、Task
オブジェクトのリストではなく、TaskInfo
オブジェクトのリストを参照するようになりました。Task の状態が必要な場合は、アプリケーション コードで追跡することをおすすめします。
新しいクラス
TaskInfo
を追加しました。VehicleStop
のgetTasks
関数をgetTaskInfoList
関数に置き換えました。VehicleStop.Builder
のsetTasks
関数をsetTaskInfoList
関数に置き換えました。
クラッシュのモニタリング
SDK の安定性を高めるため、クラッシュのモニタリングとレポート機能が追加されました。この機能はデフォルトで有効になっていますが、SDK を初期化する前に setAbnormalTerminationReportingEnabled()
を呼び出して false
の値を渡すと、無効にできます。
DriverApi
にsetAbnormalTerminationReportingEnabled
関数を追加しました。
Async getRemainingVehicleStops
DeliveryVehicleReporter
のgetRemainingVehicleStops
関数を変更し、List<VehicleStop> ではなく Future<List<VehicleStop>> を返すようにしました。
認証
AuthTokenContext
インターフェースから不要なプロパティを削除しました。ServiceType
は非推奨になりました。ServiceType
に依存するのではなく、含まれている車両 ID とタスク ID のクレームを取得するだけで済みます。
AuthTokenContext
からServiceType
を削除しました。AuthTokenContext
からgetServiceType()
を削除しました。AuthTokenContext.Builder
からsetServiceType
を削除しました。
2021 年 10 月 18 日 - API レベル 23、24、25 のサポートを終了
10 月 18 日のお知らせを読む
内部依存関係の変更に対応するため、2022 年第 3 四半期より、Android 向け Navigation SDK と Driver SDK の新バージョンでは Android API レベル 23、24、25(Android 6、7.0、7.1)がサポートされなくなります。
2022 年第 3 四半期以降にリリースされる Android 版 Navigation SDK と Driver SDK は、Android API レベル 26 以降を搭載したデバイスのみをサポートします。
Android 向け Navigation SDK および Driver SDK の v4.x 以前でビルドされたアプリ バージョンは、Android API レベル 25 以下のデバイスで引き続き動作します。
v3.0.4(2021 年 7 月 28 日)
機能
このリリースにより、Driver SDK は Navigation SDK から正式に分離されます。詳しくは、移行ガイドをご覧ください。
API の更新
以下のメソッドを追加しました。
`RidesharingDriverApi.getDriverSdkVersion()`安定性とバグの修正
接続エラーとして分類するのではなく、PERMISSION_DENIED
エラーを報告します。
非推奨のお知らせ(2021 年 6 月 21 日)
このお知らせでは、上記の日付をもって Android 向け Driver SDK と Android 向け Navigation SDK のサポートが終了することについて説明します。このお知らせは、影響を受けるお客様にサービスに関する重要なお知らせ(MSA)としても送信されました。
Android 向け Nav/Driver SDK は、Android 向け Navigation SDK v3.x と Android 向け Driver SDK v3.x(バイナリ分割)になります
お客様の統合を簡素化し、有用な機能を迅速に提供できるようにするため、Navigation SDK for Android と Driver SDK for Android を 2 つの異なるバイナリに分割します。
- Navigation SDK for Android。ドライバー向けのナビゲーション/ルーティング機能を提供します。
- Android 用 Driver SDK。これにより、Fleet Engine のステートフル ウェブサービスを利用して、乗車やタスクの進行状況や割り当てを把握できます。
Android 用 Driver SDK には、コア ルーティング機能のために Android 用 Navigation SDK との必須の依存関係があることにご注意ください。
変更点は何ですか?
v3 の主な変更点は次のとおりです。
- 1 つではなく 2 つのバイナリ。
- Android クラス用 Driver SDK のパッケージ定義を明確化しました。
- Navigation SDK for Android には、パッケージの一部として Maps SDK for Android が含まれています(Navigation SDK for Android v2 以降)。
- これにより、地図とナビゲーションの機能を同じ地図上で共存させ(NavigationView にポリラインを描画するなど)、2 つの地図ではなく 1 つの地図を使用するため、メモリ使用量が削減されます。
- Navigation SDK for Android 3.0 は、Navigation SDK for Android との完全な機能の同等性を欠いていますが、v3.2 でほとんどの問題が解決されます。詳しくは、できることとタイミングをご覧ください。
- 発生する可能性のある問題をデバッグしやすくするためのロギング。
次のメソッドも v3 で削除されました。これらのメソッドは以前に非推奨としてマークされ、代替ソリューションがすでに存在します。
- 以下の Nav/Driver SDK メソッドは、2020 年 8 月 10 日にリリースされた v1.16 で非推奨となり、v3.0 で削除されました。
Waypoint#fromLatLng(*)
Waypoint#fromPlaceId(*)
Navigator#startGuidance(resumeIntent)
NavigationApi#initForegroundServiceManager(*)
- 完全性と明確性を確保するため、v1 から v2 への移行でいくつかのメソッドが削除されたことに注意してください。これらのほとんどは、Navigation SDK for Android と Maps SDK for Android の間で重複するクラスを統合したものです。これらの変更について詳しくは、移行ガイドをご覧ください。
Driver SDK for Android と Navigation SDK for Android v1.x の非推奨化
ナビゲーション/ドライバー SDK v1 は 2018 年にリリースされました。v3 バージョンがまもなくリリースされるため、多くのメジャー バージョンをサポートすることによる持続不可能性を回避するために、v1 を非推奨にすることになりました。
この追加バージョンをサポートする必要がなくなることで、最新のメジャー バージョンをより適切にサポートし、お客様にとって重要な機能をさらに構築できるようになります。
そのため、Nav/Driver SDK v1.x は非推奨となり、2022 年 6 月 21 日以降はメンテナンスされなくなります。
SDK バージョンの非推奨の仕組みをご確認ください。
Navigation SDK と Driver SDK の Android 21 と 22 のサポート終了
取り消されたお知らせを読む
Android 向け Navigation SDK と Android 向け Driver SDK の次期バージョン 4.0 では、最小 [Android 6.0(API レベル 23)](https://developer.android.com/studio/releases/platforms#6.0){: .external} がサポートされます。現在サポートされている最小バージョンは Android 5.0(API レベル 21)です。v4.0 は 2021 年第 4 四半期にリリースされる予定です。具体的には、次のようになります。
- v4.x より前のバージョンでビルドされたアプリ バージョンは、Android 21 と 22 のデバイスで引き続き動作します。現在の SDK を統合したドライバー アプリは、Android 21 以降を搭載したデバイスで引き続き動作します。これは以前と同じです。
- Driver SDK for Android と Navigation SDK for Android v4.x(2021 年第 4 四半期を予定、変更の可能性あり)以降でビルドされたアプリのバージョンは、Android 21 と 22 を搭載したデバイスにインストールできなくなります。v4.x は最小 Android 6.0(API レベル 23)で動作するため、今後リリースされる v4.x でビルドされたアプリのバージョンは、Android 23 以降を搭載したデバイスを使用しているドライバーのみが受け取ることができます。つまり、Google の SDK 関連の変更と、お客様が行ったアプリの変更の両方が、Android 21 と 22 を搭載したデバイスを使用しているドライバーには届かなくなります。
アップグレードする Navigation SDK for Android v3 と Driver SDK for Android v3 のバージョンと、その提供開始時期については、次の表をご覧ください。
どの Driver プラットフォーム機能を使用していますか? | これらの機能を使用しますか? | アップグレードする必要がある最初のバージョンは次のとおりです。 | 提供予定日 (変更される可能性があります) |
移行に関するリンク |
---|---|---|---|---|
ナビゲーションのみ (NavSDK メソッド) |
いいえ | NavSDK v3.0.1 | たった今 | ガイド |
○ | NavSDK v3.5(予測) | 2021 年 9 月 | ||
ナビゲーションと Fleet Engine のトラッキング(NavSDK と DriverSDK のメソッド) | いいえ | Nav SDK v3.0 と Driver SDK v3.0 | リリース時に利用可能なドライバ v3.0 移行ガイド | |
○ | NavSDK v3.x と DriverSDK v3.0 |
削除されたメソッドを引き続き使用するには、v1.x を使用し続けることができますが、2022 年 6 月 21 日以降のサポートやメンテナンスは期待できません(次のセクションを参照)。
v3.x に移行することをおすすめします。具体的には、次のようになります。
* v1.x の最終リリースは 2021 年第 4 四半期に行われます(したがって、v1 はそれ以降「機能フリーズ」されます)。
* この最後のリリースは、その後 6 か月間(2022 年 6 月 21 日まで)パッチを適用できます。この期間を過ぎると、v1.x のバグや機能リクエストには対応できなくなります。
これらの変更に対応していただくために、以下の表と [移行ガイド](/maps/documentation/navigation-sdk-android/v2/migration)をご確認ください。
いつまでに何をすればよいですか?
現在、以下のプランをご利用の場合: | これらの機能を使用しますか? | 今すぐアップグレードするには | 2021 年 9 月にアップグレードするには | 移行に関するリンク |
---|---|---|---|---|
v1.x (FleetEngine.java / ドライバ機能を使用しない場合) |
いいえ | NavSDK v3.0 | ガイド | |
○ | オプションなし | NavSDK 3.x | ||
v1.x (FleetEngine.java / Driver 機能を使用) |
いいえ | オプションなし | NavSDK 3.x + DriverSDK 3.x |
上記のガイドと、リリース時に利用可能な Driver v3.0 移行ガイド。 |
○ |
Android 21 と 22 を搭載したデバイスを使用しているドライバーに、Android 用 Driver SDK と Android 用 Navigation SDK のバージョン v4.x 以降をドライバー アプリに統合する前に、新しいバージョンの Android(Android 6.0 以降)にアップグレードするよう通知することをおすすめします。
v1.15.3(2020 年 10 月 9 日)
API の更新
- Driver SDK が Navigation SDK の交通状況の更新をサブスクライブし、Fleet Engine API に送信するようになりました。
安定性とバグの修正
- gRPC ランタイムのクラッシュを修正しました。
v1.15.2
機能
永続通知を停止する機能を追加しました。Fleet Engine インスタンスで位置情報のレポートが停止すると、Navigator
でガイダンスが停止し、すべてのナビゲーション リスナーが登録解除され、NavigationFragment
または NavigationView
が一時停止します。
安定性とバグの修正
- Fleet Engine インスタンスがクリアされた場合に例外がスローされるバグを修正しました。
v1.15.1(2020 年 5 月 12 日)
機能
1.15.0 のデータの予備分析では、安定した位置情報のレポート(「スタック」した位置情報の減少)が大幅に改善されていることが示されました。このパッチ修正により、位置情報のレポート機能の改善が継続されます。ANR の問題は、これらの改善とは関係ありませんでした。
安定性とバグの修正
- ルートの開始地点に直線が表示されることがあるバグを修正しました。
- SDK によって位置情報がレポートされるときに ANR が発生する可能性があるバグを修正しました。これは、ロックの競合の影響を受けやすい
onArrival()
の改善によるものです。特定の状況下で ANR を確実に再現でき、修正によって問題が解決されたことを確認できました。ANR を生成するよう変更したテストアプリは、修正後 8 時間 ANR なしで実行されました。
v1.15.0(2019 年 3 月 23 日)
機能
- 車両の位置追跡を改善するため、開始、ルート外、到着イベントのナビゲーション ガイダンス ステータスを導入しました。
- ナビゲーションの状態に関係なく、道路にスナップされた位置情報を継続的に取得する機能を追加しました。
- 道路にスナップされる前の位置(精度など)に関する情報を追加しました。
安定性とバグの修正
- navsdk の minSdkVersion を 19 に引き上げました。
- サーバーサイドのリバース ジオコーディングが失敗した場合に、緯度/経度の経由地の名前が反映されないバグを修正しました。
v1.14.2 リリース(2019 年 2 月 2 日)
機能
- DriverSDK が 0,0 の位置情報を Fleet Engine に送信しないようにします(移動経路の共有と割り当て位置情報の入力が改善されます)。
- 現在地の更新が停止する問題を改善し、経路の共有のフォールバックを減らすためのロギングを追加しました。
- 間隔が変更されない限り、
setLocationReportingInterval()
の繰り返し呼び出しを無視します。 - 使用されている間隔に対して高い頻度でこのメソッドが繰り返し呼び出されるのを防ぐことを目的として、
setReportingInterval()
メソッドの javadoc を更新しました。 - Api 29 の位置情報の信頼性が向上しました。
v1.13.0
安定性とバグの修正
- クライアントが gradle ビルドに追加する必要がある okhttp の依存関係を追加します。
v1.11.7(2019 年 10 月 18 日)
安定性とバグの修正
- 特定の目的地に対して
onArrival()
が発生した後も、位置情報の更新が継続されるようになりました。 - デフォルトの通知(Free Nav モードの定数文字列)は、ナビゲーション通知に設定されたカラーパターンと一致します。詳しくは、共有の永続通知をご覧ください。
- 位置情報の更新イベントが遅延すると、誤った位置情報の更新が発生し、ルートの開始地点に直線が表示されるなどのアーティファクトが発生する問題を修正しました。
v1.11.6(2019 年 10 月 4 日)
API の更新
- ネットワーク障害の発生後、Driver SDK が位置情報の更新を迅速に再開できるようにする一連の変更を導入しました。ネットワーク接続が復元されると、次のスケジュールされた位置情報の更新で位置情報の更新が再開されます。
安定性とバグの修正
setVehicleState()
がすぐに返されるようになりました。FleetEngine の更新がバックグラウンド スレッドで行われるようになりました。アプリケーション応答なし(ANR)の問題に対処します。- 古いバージョンの Consumer SDK を使用すると、ジャーニーの共有ルートが直線で表示される問題を修正しました。Driver SDK によってルートに 1 回限りの経由地が追加されないようにします。