Android 用の Navigation SDK を統合することで、アプリは外部のマップビューにリンクするだけのことも可能です。Google マップ ナビゲーションを使用すると、アプリでユーザー ジャーニーに関するデータを動的に取得し、一目で確認できるレポートを提供できます。このガイドでは、GitHub にある Navigation SDK のデモアプリを実行する方法について説明します。
事前準備
Navigation SDK を使用するには、次のものが揃っていることを確認してください。
Google Maps Platform の担当者(以下を利用する場合):
- Navigation SDK で使用するためにプロビジョニングされた API キー。プロジェクト ID を指定する必要があります。この ID は、Google Cloud コンソールのメイン ダッシュボードのプロジェクト名の下に表示されます。
- SDK アーティファクト。Navigation SDK に Maven を使用するようにプロジェクトが構成されていることを確認します。
- v4.99.0 以前を使用しているプロジェクトの場合。Maven を使用できない場合は、共有ドライブから圧縮されたアーティファクトをダウンロードできます。静的ライブラリ ファイルは
libs/
ディレクトリにある .aar であり、Navigation SDK が AAR バンドルとして含まれています。 - デモアプリ(複数可)。
- Android Studio: Navigation SDK を使用してアプリをビルドする際に推奨される開発環境。
このドキュメントは、Android 開発とオブジェクト指向プログラミングの概念を理解しているデベロッパーを対象にしています。また、ユーザーの視点で Google マップを使い慣れていることも必要です。
デモアプリを入手する
Google では、Navigation SDK が Google Maps API に備わっている機能を理解するのに役立つ 2 つのアプリを、ユーザーの経験レベルに応じて提供しています。Google Maps API に精通しているデベロッパーは、GoogleNavigation のデモに集中できます。どちらのプロジェクトも初めて使用するデベロッパーにとっては、どちらのアプリも役に立ちます。
Android 用 Navigation SDK v4.1 以降、以下のデモアプリはどちらも GitHub からダウンロードできます。
GoogleNavigation のデモ: ガイド付きナビゲーション セッションでの、ユーザー エクスペリエンスに関連する API の動作とビューの統合を紹介します。
GoogleMap のデモ:
GoogleMap
インターフェースの個々の動作を紹介して、地図の表示や表示をカスタマイズできます。
Maven の使用に関する注意事項
デモアプリは、Gradle の Artifact Registry プラグインを使用して、リモート Maven リポジトリから SDK アーティファクトをダウンロードするように構成されています。SDK にアクセスするには、プロジェクトの構成手順に従ってください。
GoogleNavigation のデモ
最新の Google Navigation のデモは、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 デバイス - instructionsを参照して、Android デバイスで開発者向けオプションを有効にし、デバイスを検出するようにシステムを設定します。
- エミュレータ: Android Virtual Device(AVD)Manager を使用して仮想デバイスを設定します。エミュレータを指定する際は、Google API を含むイメージを選択する必要があります。
Android Studio で [Run] メニュー オプション(またはプレイボタンのアイコン)をクリックして、デプロイ ターゲットを選択します。
アプリがビルドされて起動すると、オプションのリストが記載されたランディング ページがユーザーに表示されます。
NavViewActivity オプションと NavFragmentActivity オプション
NavSDK を初めて使用する場合は、この 2 つのオプションが最も役に立つ可能性があります。
オプション 1: NavViewActivity
は、NavigationView
を Navigator
と組み合わせて使用する動作を示します。
オプション 2: NavFragmentActivity
という名前の 2 番目のオプションでは、Navigator
とともに SupportNavigationFragment
を使用する動作を示します。
これらのオプションのいずれかをクリックすると、以下の画面が表示されます。
- ナビゲーション UI と
- アプリのメニューにある [Set Destination] ボタン
- API のメソッドを動的に呼び出すために操作できるオーバーレイ
- その他のオプションのオーバーフロー メニュー
まず、[Set Destination] をクリックして住所を選択します。次に、アプリは現在地からその住所へのルートをシミュレートします。コントロール パネルのオーバーレイを使用すると、API を呼び出すとどうなるかがわかります。たとえば、[View Methods] をクリックすると、SDK を強制的に夜間モードにして、どのように表示されるかを確認できます。
SwappingMapAndNavActivity オプション
SwappingMapAndNavActivity
は、次の一般的なパターンを示します。
MapView
を表示している- ナビゲーション開始時に
NavigationView
にスワップする - ナビゲーション終了時に
MapView
に戻る
GoogleMap のデモ
最新の Google Navigation のデモは、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 デバイス: instructionsを参照して、Android デバイスで開発者向けオプションを有効にし、デバイスを検出するようにシステムを設定します。
- エミュレータ: Android Virtual Device(AVD)Manager を使用して仮想デバイスを構成します。エミュレータを指定する際は、Google API を含むイメージを選択する必要があります。
Android Studio で [Run] メニュー オプション(またはプレイボタンのアイコン)をクリックして、デプロイ ターゲットを選択します。
アプリをビルドして起動すると、デモのリストのランディング ページがユーザーに表示されます。
この表示パターンとそれに対応するソースコードの構造は、Google Maps SDK のデモを使用するユーザーが理解できるものでなければなりません。これは、GoogleMap デモが Maps API デモアプリと同じように設計されているためです。主な違いは、Navigation SDK デモでは、デモのテスト実行に使用するビュークラス(NavigationView
または MapView
(該当する場合))をユーザーが選択できる点です。
Google では一般に、NavigationView
の使用を推奨しています。このデモでは、デモアプリで両方のバージョンでこれらの動作を試して、最適な方法を選択できます。たとえば、そのクラスとのやり取りを想定しているサードパーティ ライブラリを使用している場合でも、MapView
の使用が必要になることがあります。