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 は、経験レベルに応じて、Google Maps 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[build] をクリックして、SDK 実装の詳細を確認します。
Java クラスで、実装コードをメモします。
レイアウト XML で、レイアウトのデザインとテキストをメモします。
build.gradleファイルで、依存関係の SDK をメモします。
API キーをマニフェストに追加する方法については、Secrets Gradle プラグインのドキュメントをご覧ください。
実行中
Android デバイスをパソコンに接続するか、エミュレータを使用します。
- Android デバイス - 手順に沿って、Android デバイスで開発者向けオプションを有効にし、デバイスを検出するようにシステムを設定します。
- エミュレータ - 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[build] をクリックして、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 を使用する必要がある場合があります。