Navigation SDK for Android を統合することで、アプリは外部地図ビューへのリンク以上のことができます。Google マップ ナビゲーションを使用すると、アプリでユーザーのルートに関するデータを動的に取得し、1 つの画面でレポートを表示できます。このガイドでは、GitHub で入手できる Navigation SDK のデモアプリを実行する方法について説明します。
準備する
Navigation SDK を使用するには、次のものを用意してください。
- Navigation SDK で使用するためにプロビジョニングされた API キー。キーの作成と制限の詳細については、API キーを使用するをご覧ください。
- SDK アーティファクト。Navigation SDK に Maven を使用するようにプロジェクトが構成されていることを確認します。
- 1 つ以上のデモアプリ。
- Android Studio: Navigation SDK を使ってアプリをビルドする際に推奨される開発環境です。
このドキュメントは、Android 開発とオブジェクト指向プログラミングの概念に精通している方を対象としています。また、ユーザーの視点で Google マップを使い慣れていることも必要です。
デモアプリを入手する
経験レベルに応じて、Google マップ API に加えて Navigation SDK が提供する機能を理解するのに役立つ 2 つのアプリが用意されています。Google Maps API に精通しているデベロッパーは、GoogleNavigation のデモに集中できます。両方のプロジェクトを初めて使用するデベロッパーは、両方のアプリが役に立ちます。
Navigation SDK for Android v4.1 以降では、次のデモアプリを GitHub からダウンロードできます。
GoogleNavigation デモ: ガイド付きナビゲーション セッション中のユーザー エクスペリエンスに関連する API の動作とビューの統合を示しています。
GoogleMap デモ:
GoogleMapインターフェースの個々の動作を示すことで、地図の外観と表示をカスタマイズします。
GoogleNavigation のデモ
最新の GoogleNavigation デモは GitHub で入手できます。
建物
Android Studio でデモアプリをインポートし、Gradle の実行を許可します。
local.defaults.propertiesを開き、MAPS_API_KEYプロパティの値を更新します。MAPS_API_KEY=YOUR_API_KEY[ビルド] をクリックして、SDK の実装の詳細を確認します。
Java クラスで、実装コードをメモします。
レイアウト XML で、レイアウトのデザインとテキストをメモします。
build.gradleファイルで、依存関係の SDK をメモします。
API キーをマニフェストに追加する方法については、Secrets Gradle プラグインのドキュメントをご覧ください。
実行中
Android デバイスをパソコンに接続するか、エミュレータを使用します。
- Android デバイス - 手順に沿って、Android デバイスでデベロッパー オプションを有効にし、デバイスを検出するようにシステムを設定します。
- Emulator - Android Virtual Device（AVD）Manager を使用して仮想デバイスを構成します。エミュレータを選択する際は、Google API を含むイメージを選択する必要があります。
Android Studio で、[Run] メニュー オプション（または再生ボタン アイコン）をクリックし、デプロイ ターゲットを選択します。
ビルドして起動すると、アプリはオプションのリストのランディング ページをユーザーに表示します。
NavViewActivity と NavFragmentActivity のオプション
NavSDK を初めて導入する場合は、これらの 2 つのオプションが最も有用であると考えられます。
オプション 1: NavViewActivity は、Navigator と組み合わせて NavigationView を使用して動作を示します。
オプション 2: 2 つ目のオプション（NavFragmentActivity）では、Navigator とともに SupportNavigationFragment を使用した動作を示します。
いずれかのオプションをクリックすると、次のように表示されます。
- ナビゲーション UI
- アプリのメニューにある [目的地を設定] ボタン
- 操作して API のメソッドを動的に呼び出せるオーバーレイ
- その他のオプションが表示されるオーバーフロー メニュー
開始するには、[目的地を設定] をクリックして住所を選択します。アプリは、現在地からその住所までのルートをシミュレートします。コントロールパネルのオーバーレイを使用して、API を呼び出すとどうなるかを確認します。たとえば、[メソッドを表示] をクリックして、SDK を強制的にナイトモードにして、その外観を確認できます。
SwappingMapAndNavActivity オプション
SwappingMapAndNavActivity には、次の一般的なパターンが示されています。
MapViewを表示している- ナビの開始時に
NavigationViewに切り替える - ナビゲーションの終了時に
MapViewに戻る
GoogleMap のデモ
最新の GoogleNavigation デモは GitHub で入手できます。
建物
Android Studio でデモアプリをインポートし、Gradle の実行を許可します。
local.defaults.propertiesを開き、MAPS_API_KEYプロパティの値を更新します。MAPS_API_KEY=YOUR_API_KEY[ビルド] をクリックして、SDK の実装の詳細を確認します。
Java クラスで、実装コードをメモします。
レイアウト XML で、レイアウトのデザインとテキストをメモします。
build.gradleファイルで、依存関係の SDK をメモします。
API キーをマニフェストに追加する方法については、Secrets Gradle プラグインをご覧ください。
実行中
Android デバイスをパソコンに接続するか、エミュレータを使用します。
- Android デバイス 手順に沿って、Android デバイスでデベロッパー オプションを有効にし、デバイスを検出するようにシステムを設定します。
- エミュレータ Android Virtual Device（AVD）Manager を使用して仮想デバイスを構成します。エミュレータを選択する際は、Google API を含むイメージを選択する必要があります。
Android Studio で、[Run] メニュー オプション（または再生ボタン アイコン）をクリックし、デプロイ ターゲットを選択します。
ビルドして起動すると、アプリはデモのリストのランディング ページをユーザーに表示します。
この表示パターンと、対応するソースコードの構造は、Google Maps SDK のデモのユーザーには馴染みがあるはずです。これは、GoogleMap デモが Maps API デモアプリに似せて設計されているためです。主な違いは、Navigation SDK デモでは、デモのテスト実行に使用するビュークラス（NavigationView または MapView）をユーザーが選択できることです。
通常、Google は、NavigationView を使用することを推奨しています。このデモでは、デモアプリの両方のバージョンでこれらの動作を試して、適切な動作を選択できます。たとえば、そのクラスとやり取りすることを想定したサードパーティ ライブラリを使用している場合は、MapView を使用する必要がある場合があります。