Android 用の Navigation SDK を統合することで、アプリは外部の地図ビューにリンクするだけにとどまりません。Google マップ ナビゲーションを使用すると、アプリでドライバーの移動に関するデータを動的に取得し、単一のレポートを作成できます。
このガイドでは、Android Studio プロジェクトの概要、Navigation SDK の統合方法、SDK に付属のデモアプリの実行方法について説明します。
Navigation SDK は、アプリ内のナビゲーションの外観と音声を制御できる静的ライブラリ(.aar)です。ライブラリの詳細については、別のウィンドウで Navigation SDK リファレンス(Javadoc)をご覧ください。
事前準備
Android 用の Navigation SDK を使用するには、次のものが揃っていることを確認してください。
Google Maps Platform の担当者(以下を利用する場合):
- Navigation SDK で使用するためにプロビジョニングされた API キー。プロジェクト ID を指定する必要があります。この ID は、Google Cloud コンソールのメイン ダッシュボードのプロジェクト名の下にあります。
以下を含む zip ファイル。
libs/
ディレクトリにある静的ライブラリ ファイル .aar。Navigation SDK が aar バンドルとして格納されています。- ライセンス用のテキスト ファイルと、利用規約と契約へのリンク。
- Android Studio に新しいプロジェクトとしてインポートするデモアプリ。Gradle と Maven を使用して Android Studio でデモアプリをビルドするためのアプリファイル。
Android Studio: Navigation SDK を使用してアプリをビルドする際に推奨される開発環境。このドキュメントは、Android 開発とオブジェクト指向プログラミングの概念を理解しているデベロッパーを対象にしています。また、ユーザーの視点で Google マップを使い慣れていることも必要です。
SDK、デモアプリ、ドキュメントの入手
SDK ファイルをダウンロードして解凍したら、デモアプリを調べて実行できます。
デモアプリには、NavigationFragment
クラスを実装するビルドと、NavigationView
クラスを実装するバリアントが用意されています。NavigationFragment
バリアントはデフォルトで実行され、次の図のようなナビゲーション パスを表示します。
任意のファイル マネージャーを使用して、SDK ファイルが格納されたディレクトリに移動します。
Navigation SDK ライブラリを
demo
プロジェクトのapp/libs
ディレクトリにコピーします。たとえば、Linux ターミナルで
cp libs/*.aar demo/app/libs
を実行できます。Android Studio でデモアプリをインポートして、Gradle を実行できるようにします。
アプリの
AndroidManifest.xml
を開き、API_KEY
プロパティの値を更新します。<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.navigationapidemo" > <application android:allowBackup="true" android:icon="@mipmap/ic_launcher" android:label="@string/app_name" android:supportsRtl="true" android:theme="@style/_AppTheme" > <meta-data android:name="com.google.android.geo.API_KEY" android:value="YOUR_API_KEY"/> </application> </manifest>
[build] をクリックして、SDK 実装の詳細を確認します。
Java クラスの実装コードをメモします。
レイアウト xml 内のレイアウトのデザインとテキストをメモします。
build.gradle ファイルで、依存関係にある SDK をメモします。
アプリを実行する
Android デバイスをパソコンに接続するか、エミュレータを使用します。
- Android デバイス: instructionsを参照して、Android デバイスで開発者向けオプションを有効にし、デバイスを検出するようにシステムを設定します。
- エミュレータ: Android Virtual Device(AVD)Manager を使用して仮想デバイスを構成します。エミュレータを指定する際は、Google API を含むイメージを選択する必要があります。
Android Studio で [Run] メニュー オプション(またはプレイボタン アイコン)をクリックして、デプロイ ターゲットを選択します。
Navigation Demo アプリで [Set Destination] を選択し、画面の指示に沿って場所を選択し、シミュレーションされたナビゲーションを開始します。
ビュー バリアントをビルドする
デモアプリには View のバリアントが含まれています。
Android Studio でデモアプリを開き、[Build] ウィンドウの [Build Variants] タブをクリックします。
[Build Variants] ウィンドウで [viewDebug] を選択すると、ファイルリストが変更されます。
NavigationView
クラスの SDK 実装の詳細を確認します。NavViewActivity.java
の実装コードをメモします。Activity_Nav_View.xml
のレイアウト デザインとテキストに注意してください。
アプリをビルドして実行します。アプリ名が変わり、ビルドするバージョンを示します。それ以外の場合は、レンダリング オブジェクトのみが異なります。
次のステップ
独自のアプリに Navigation SDK for Android を統合します。