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

Navigation SDK for Android を使用すると、Google マップのターンバイターン方式のナビを Android アプリに追加できます。UI のカスタマイズやルートの設定も可能です。Maps SDK の地図のレイヤが含まれているため、このライブラリを使用するアプリに Maps SDK for Android を含めることはできません。

Navigation SDK for Android: 主な特長

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

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

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

  • ユーザーが別のアプリに切り替える必要がないように、独自の Android アプリ内で Google マップのターンバイターン方式のナビを使用する必要があります。
  • ブランドに合わせてナビゲーション UI をカスタマイズするか、カスタム ナビゲーション エクスペリエンスを構築する必要があります。
  • 車、徒歩、自転車、バイクのアプリ内ナビゲーションが必要な場合。
  • Routes API で計画したルートをナビゲートするには、ルートトークンを SDK に渡す必要があります。

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

  • iOS 向けにアプリをビルドしている。代わりに Navigation SDK for iOS を使用してください。
  • Flutter または React Native を使用してクロスプラットフォーム アプリを構築している。代わりに Flutter と React Native 向けの Google ナビゲーションを使用してください。
  • アプリ内ターンバイターン ルート案内ではなく、サーバーサイドのルート、到着予定時刻、ルートトークンの計算が必要な場合。代わりに Routes API を使用してください。

Navigation SDK for Android: 設定

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

  • Maven: com.google.android.libraries.navigation:navigation

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

  • 問題: Navigation SDK にはすでに Maps SDK がバンドルされています。play-services-maps を直接または推移的な依存関係を介して取り込むビルドでは、Maps SDK のコピーが重複することになります。修正: すべての依存関係(Gradle 構成の除外または Maven の除外)から com.google.android.gms:play-services-maps を除外し、Maps SDK の直接的な依存関係をすべて削除します。/maps/documentation/navigation/android-sdk/android-studio-setup をご覧ください。
  • 問題: Navigation SDK 8.0 以降では minAndroidGradlePluginVersion=9.0.1 が宣言されているため、以前の AGP を使用したビルドは失敗します。修正: 8.0 以降でビルドする前に、AGP 9.0.1、Gradle 9.1.0、Kotlin 2.3.0 にアップグレードします。/maps/documentation/navigation/android-sdk/kotlin-compatibility-migration をご覧ください。
  • 問題: NavigationFragment の使用中に NavigationView ライフサイクル メソッドを直接呼び出すか、NavigationView とは異なる順序で呼び出すと、エラーが発生します。修正: ライフサイクル コールバックを管理する NavigationFragment を使用します。NavigationView を使用する場合は、ライフサイクル メソッドを厳密な順序で転送します。/maps/documentation/navigation/android-sdk/nav-map-interactions-best-practices をご覧ください。
  • 問題: ユーザーが Google ナビの利用規約に同意するまで、ナビゲーションを利用できない。修正方法: ナビゲーターが初めて呼び出されたときに SDK がプロンプトを表示するようにするか、TermsAndConditionsCheckOption / NavigationApi.showTermsAndConditionsDialog を使用してダイアログをより早い段階(登録時など)で表示します。/maps/documentation/navigation/android-sdk/route をご覧ください。

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

  • Waypoint fromLatLng()、fromPlaceId(): 2021 年 5 月 10 日より廃止。代替: Waypoint.builder()(Waypoint.Builder)。症状: バージョン 3.0 で削除されました。3.0 以降では呼び出しがコンパイルされません。移行ガイドをご覧ください。
  • SupportNavigationFragment: 2026 年 10 月 1 日以降非推奨。交換: NavigationFragment。症状: Navigation SDK v8.0.0 で非推奨になりました。移行ガイドをご覧ください。
  • NavigationView と SupportNavigationFragment の setLocationMarkerEnabled: 2023 年 7 月 7 日以降廃止。交換: GoogleMap.setMyLocationEnabled。症状: バージョン 5.0.0 で削除(4.1 で非推奨)。5.0 以降では呼び出しがコンパイルされません。
  • DisplayOptions showTrafficLights、showStopSigns: 2026 年 10 月 1 日以降廃止。代替機能: 代替機能は必要ありません。ナビゲーション中は信号機と一時停止標識が常に有効になります。症状: これらのメソッドの呼び出しがバージョン 8.0.0 に対してコンパイルされない。
  • Maven アーティファクト com.google.android.maps:navsdk(非公開リポジトリ、v4.x)と AAR バンドルのダウンロード: 2023 年 7 月 7 日をもって廃止。代替: google() Maven リポジトリの com.google.android.libraries.navigation:navigation。症状: バージョン 5.0 以降は、Google Maven で com.google.android.libraries.navigation:navigation としてのみ提供されます。AAR バンドルは配布されなくなりました。移行ガイドをご覧ください。

Navigation SDK for Android でできること

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

Navigation SDK for Android: 地図

Navigation SDK for Android: 地図アノテーション

Navigation SDK for Android: 地図のスタイル設定

Navigation SDK for Android: ナビゲーション