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

Driver SDK for Cloud を使用するように Google Cloud コンソール プロジェクトを設定、構成するには、 Android の場合は、次の手順に沿って操作してください。

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

各ステップの詳細については、次のセクションをご覧ください。

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

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

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

  1. Google Cloud Console 開発プロジェクトと API キーがない場合 設定するには 1 つ設定が必要です詳細については、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 を追加するには、Driver SDK と Navigation SDK の依存関係を Gradle または Maven の構成に追加します。

次の例では、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 の保護に関するベスト プラクティス」をご覧ください。

このタスクを効率化するには、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>

アプリに必要な属性情報を含める

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

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

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

次のステップ

依存関係の宣言