Android 用の Navigation SDK を統合することで、アプリは外部のマップビューにリンクするだけにとどまりません。Google マップ ナビゲーションを使用すると、アプリでユーザー ジャーニーに関するデータを動的に取得し、一目で確認できるレポートを提供できます。このガイドでは、GitHub で入手できる Navigation SDK のデモアプリを実行する方法について説明します。
準備する
Navigation SDK の使用を開始するには、以下のものが必要です。
- Navigation SDK で使用するためにプロビジョニングされた API キー。キーの作成と制限の詳細については、API キーを使用するをご覧ください。
- SDK アーティファクト。Navigation SDK に Maven を使用するようにプロジェクトが構成されていることを確認します。
- デモアプリ（複数可）。
- Android Studio: Navigation SDK を使用してアプリをビルドする際に推奨される開発環境。
このドキュメントは、Android 開発とオブジェクト指向プログラミングの概念を理解しているデベロッパーを対象にしています。また、ユーザーの視点で 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: NavFragmentActivity という名前の 2 番目のオプションでは、Navigator とともに SupportNavigationFragment を使用する動作を示します。
いずれかのオプションをクリックすると、次のように表示されます。
- ナビゲーション UI と
- アプリのメニューにある [Set Destination] ボタン
- 操作して API のメソッドを動的に呼び出せるオーバーレイ
- その他のオプションが表示されるオーバーフロー メニュー
開始するには、[目的地を設定] をクリックして住所を選択します。アプリは、現在地からその住所までのルートをシミュレートします。コントロール パネルのオーバーレイを使用すると、API を呼び出すとどうなるかがわかります。たとえば、[View Methods] をクリックすると、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 を使用する必要がある場合があります。