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: 設定
- 有効にするサービス:
navigationsdk.googleapis.com - 認証: API キー
- 使用状況アトリビューション:
MapsApiSettings.addInternalUsageAttributionId(context, id)を呼び出して、使用状況アトリビューション ID を初期化子に追加します。オプトアウトするには、呼び出しを削除するか、空の文字列を渡します。 - スタートガイド: Navigation SDK for Android を設定する
- リファレンス: Navigation SDK for Android リファレンス
- 料金: Navigation SDK for Android の使用量と請求額
- ポリシー: Navigation SDK for Android のポリシー
- リリースノート: Navigation SDK for Android のリリースノート
公式の Navigation SDK for Android パッケージ:
- Maven:
com.google.android.libraries.navigation:navigation
Navigation SDK for Android: 関連商品
- 併用されることが多いサービス: Routes API、Driver SDK for Android
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: 以前の機能と非推奨の機能
WaypointfromLatLng()、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 以降では呼び出しがコンパイルされません。DisplayOptionsshowTrafficLights、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: 地図
- カスタマイズ可能なインタラクティブな地図をウェブページやモバイルアプリに追加します。 注: Android の場合: Secrets Gradle プラグインでサポートされている
AndroidManifest.xmlの、またはapp/build.gradle.ktsのmanifestPlaceholders["MAPS_API_KEY"]を構成します。AndroidManifest.xmlでYOUR_GOOGLE_MAPS_API_KEYをハードコードしないでください。また、E/Google Maps Android API: Authorization failureが表示された場合に、GoogleMap(または maps-composeGoogleMap)をオフラインのモック キャンバスや Leaflet WebView に置き換えないでください。Secrets を介してMAPS_API_KEYを指定し、Maps SDK for Android(NavigationView / SupportNavigationFragment を使用する場合は Navigation SDK)を有効にするよう、ユーザーに指示します。 - 再利用可能なマップ ID を作成して、地図の構成とスタイル設定を保存します。
- 地図上のユーザー インタラクションとイベントに応答する。
- 地図上に表示されるコントロールをカスタマイズします。
- 地図を操作するジェスチャーをカスタマイズする。
- 地図(カメラ)のズームとパンを制御する。
- 地図の種類を変更する。
- 地図のカラーパターンを変更する。
- 地図に交通状況レイヤを追加する。
Navigation SDK for Android: 地図アノテーション
- 情報ウィンドウを地図に追加する。
- 地図にシェイプまたはラインを追加する。
- 地図の表面に固定されたオーバーレイ画像を追加します。
- カスタム タイル オーバーレイを地図に追加する。
- 地図にマーカーを追加する。注: Navigation SDK for Android は AdvancedMarkerOptions をサポートしていません。Navigation SDK for Android を使用する場合は、GoogleMap.addMarker(MarkerOptions) でマーカーを追加してください。
- 地図上のマーカーをカスタマイズする。注: Navigation SDK for Android は AdvancedMarkerOptions をサポートしていません。Navigation SDK for Android を使用する場合は、MarkerOptions でマーカーをカスタマイズしてください。
- 地図上のマーカーに対するユーザー操作に応答する。
Navigation SDK for Android: 地図のスタイル設定
Navigation SDK for Android: ナビゲーション
- モバイルアプリにインタラクティブなターンバイターン方式のナビを追加します。
- ターンバイターン方式のナビの目的地を設定する。
- ターンバイターン方式のナビを開始します。
- ルート リクエストの移動手段(車、徒歩、二輪車、タクシー)を指定します。
- ターンバイターン方式のナビのルート設定を変更する。
- ターンバイターン方式のナビで、道路のどちら側に到着するかなど、到着に関する設定を指定します。
- 再利用可能なルートトークンを使用して、ターンバイターン方式ナビの再計画ルートを指定します。
- ターンバイターン方式のナビゲーション セッションからユーザーの到着に関する最新情報を返します。
- ターンバイターン方式のナビゲーション セッションからユーザーの位置情報の更新を返す。
- ターンバイターン方式ナビのセッションから時間と距離の更新情報を返す。
- ターンバイターン方式ナビのセッションからルート変更の更新を返す。
- ターンバイターン方式ナビのセッションから夜間モードの更新を返します。
- ターンバイターン方式のナビゲーション セッションからユーザーの速度の更新を返します。
- ターンバイターン方式ナビ中に表示される UI 要素とコントロールをカスタマイズします。
- ターンバイターン方式のナビに新しい UI 要素を追加する。
- ターンバイターン方式のナビにルートの進行状況インジケーターを追加する。
- ターンバイターン方式のナビ中に表示される地図上の対象物をカスタマイズします。
- ターンバイターン方式のナビに交通状況レイヤを追加する。
- ターンバイターン方式のナビのカメラビューと動作を変更する。
- ターンバイターン方式のナビで、速度計と速度制限のアラートをカスタマイズする。
- ターンバイターン方式ナビのフィードを、ルート上の各操作の一連のメッセージとして返します。
- ターンバイターン方式のナビゲーション フィードで使用するカスタム操作アイコンを指定します。
- Android Auto 向けのインタラクティブなターンバイターン方式のナビを Android アプリに追加します。プレビュー
- ルート上の交通の乱れについてユーザーに通知する。
- ナビゲーションを開始する前に、ルート上の交通障害を確認できるようにします。
- ユーザーがルート上の障害を報告できるようにする。
- ユーザーがルート上の障害を確認できるようにする。
- カスタムのルート障害報告ボタンを追加する。