Google Cloud コンソール プロジェクトを構成する

Android 用 Driver SDK を使用するように Google Cloud コンソール プロジェクトを設定して構成する手順は次のとおりです。

1. モバイルアプリ プロジェクトを設定します。
2. アプリに Driver SDK を追加します。
3. アプリに API キーを追加します。
4. アプリに必要な帰属表示を含めます。

各手順の詳細については、以下のセクションをご覧ください。

注: アプリは minSdkVersion 23 以上をターゲットにする必要があります。

モバイルアプリ プロジェクトを設定する

このセクションでは、Driver SDK 用にモバイルアプリ プロジェクトを構成する方法について説明します。

モバイルアプリ プロジェクトを構成する手順は次のとおりです。

1. モビリティ プロジェクト用の Google Cloud コンソール開発プロジェクトと API キーがない場合は、設定する必要があります。詳細については、 Fleet Engine プロジェクトを作成するをご覧ください。
2. Google Cloud コンソールで、Fleet Engine に使用しているものと同じ Google Cloud コンソール プロジェクトと API キーを選択します。
3. [API とサービス] を選択し、Maps SDK for Android を検索して有効にします。

アプリに Driver SDK を追加する

Driver SDK は Google Maven リポジトリから入手できます。リポジトリには、SDK のプロジェクト オブジェクト モデル（.pom）ファイルと Javadoc が含まれています。

アプリに Driver SDK を追加するには、Gradle または Maven の構成に Driver SDK と Navigation SDK の依存関係を追加します。

注: Driver SDK は Navigation SDK に依存しています。この例に示すように、Navigation SDK の明示的に定義された バージョンに依存関係を設定します。 そうしない場合は、例のコードブロックを省略して、プロジェクトがメジャー リリース バージョン内の最新バージョンの Navigation SDK を常にダウンロードできるようにします。最新バージョンの Driver SDK と Navigation SDK の組み合わせ動作は、リリース前に厳格なテストを受けています。

次の例では、VERSION_NUMBER を選択したバージョンの Driver SDK に置き換えます。

Gradle

build.gradle に次の行を追加します。

dependencies {
...
implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-driver:VERSION_NUMBER'
implementation 'com.google.android.libraries.navigation:navigation:5.0.0'
}

Maven

pom.xml に次の行を追加します。

<dependencies>
  ...
  <dependency>
    <groupId>com.google.android.libraries.mapsplatform.transportation.driver</groupId>
    <artifactId>transportation-driver</artifactId>
    <version>VERSION_NUMBER</version>
  </dependency>
  <dependency>
    <groupId>com.google.android.libraries.navigation</groupId>
    <artifactId>navigation</artifactId>
    <version>5.0.0</version>
  </dependency>
</dependencies>

アプリに API キーを追加する

アプリに Driver SDK を追加したら、API キーを追加します。開発プロジェクトの設定時に取得したプロジェクト API キーを使用する必要があります。詳細については、モバイルアプリ プロジェクトを設定するをご覧ください。

このセクションでは、アプリからより安全に 参照できるように API キーを保存する方法について説明します。API キーのセキュリティに関するベスト プラクティスの詳細については、Google Maps Platform の API セキュリティに関するベスト プラクティスをご覧ください。

重要: API キーをバージョン管理システムにチェックインしないでください。代わりに、プロジェクトのルート ディレクトリにある local.properties ファイルに保存します。local.properties ファイルについて詳しくは、 Gradle プロパティ ファイルをご覧ください。

このタスクを効率化するには、GitHub ドキュメント の Android 用 Secrets Gradle プラグインを使用します。

プラグインをインストールして API キーを保存する手順は次のとおりです。

1. ルートレベルの build.gradle ファイルを開き、buildscript の dependencies 要素に次のコードを追加します。

   Groovy

   buildscript {
         dependencies {
             // ...
             classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.0"
         }
   }
   

   Kotlin

   buildscript {
       dependencies {
           // ...
           classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.0")
       }
   }
   

2. アプリレベルの build.gradle ファイルを開き、plugins 要素に次のコードを追加します。

   Groovy

   id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
   

   Kotlin

   id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
   

3. Android Studio を使用している場合は、プロジェクトを Gradle と同期します。詳細については、 プロジェクトを Gradle と同期するをご覧ください。

4. プロジェクト レベルのディレクトリで local.properties を開き、次のコードを追加します。YOUR_API_KEY を実際の API キーに置き換えます。

   MAPS_API_KEY=YOUR_API_KEY

5. AndroidManifest.xml ファイルで、com.google.android.geo.API_KEY に移動し、android:value 属性を次のように更新します。

       <meta-data
           android:name="com.google.android.geo.API_KEY"
           android:value="${MAPS_API_KEY}" />

次の例は、サンプルアプリの完全なマニフェストを示しています。

    <manifest xmlns:android="http://schemas.android.com/apk/res/android"
        package="com.example.driverapidemo" >
        <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
        <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
        <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="${MAPS_API_KEY}" />

            <activity android:name=".MainActivity" >
                <intent-filter>
                    <action android:name="android.intent.action.MAIN" />
                    <category android:name="android.intent.category.LAUNCHER" />
                </intent-filter>
            </activity>
        </application>
    </manifest>

注: ナビゲーション エクスペリエンスを最適化するには、ドライバに以下の 権限を付与する必要があります: android.permission.ACCESS_COARSE_LOCATION と android.permission.ACCESS_FINE_LOCATION. アプリ内で実行時に両方をリクエストしてください。

アプリに必要な帰属表示を含める

アプリで Driver SDK を使用する場合は、アプリの法的通知セクションに帰属表示テキストとオープンソース ライセンスを含める必要があります。帰属表示は、独立したメニュー項目として、または [このアプリについて] メニュー項目の一部として含めることをおすすめします。

ライセンス情報は、解凍された AAR ファイルの「third_party_licenses.txt」ファイルにあります。

オープンソース通知を含める方法については、オープンソース通知を含めるをご覧ください。

次のステップ

依存関係の宣言