Navigation SDK for Android を統合すると、アプリは外部の地図ビューにリンクするだけでなく、 Google マップ ナビを使用すると、ユーザーの移動に関するデータを動的に取得し、一目でわかるレポートを提供できます。このガイドでは、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 は、NavigationView
と組み合わせて
Navigatorを使用する動作を示します。
オプション 2: 2 つ目のオプション NavFragmentActivity は、
SupportNavigationFragment とともに
Navigator を使用する動作を示します。
これらのオプションのいずれかをクリックすると、次のものが表示されます。
- ナビゲーション UI
- アプリのメニューの [Set Destination] ボタン
- 操作して API のメソッドを動的に呼び出すことができるオーバーレイ
- その他のオプションを含むオーバーフロー メニュー
まず、[Set Destination] をクリックして住所を選択します。アプリは、現在地からその住所までの移動をシミュレートします。コントロール パネルのオーバーレイを使用して、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 を使用する必要があるかもしれません。