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

Android 用 Consumer SDK を使用するように Google Cloud コンソールを設定して構成するには、次の手順を行います。

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

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

開発プロジェクトを設定する

モビリティ プロジェクトの Google Cloud コンソール開発プロジェクトと API キーがない場合は、設定する必要があります。詳細については、Fleet Engine ガイドの プロジェクトを作成するをご覧ください。

Consumer SDK の開発プロジェクトを選択するときは、Fleet Engine で使用しているのと同じ Google Cloud コンソール プロジェクトと API キーを選択します。

アプリに Consumer SDK を追加する

Consumer SDK は Google Maven リポジトリから入手できます。リポジトリには、SDK のプロジェクト オブジェクト モデル（.pom）ファイルと Javadoc が含まれています。アプリに Consumer SDK を追加するには、Gradle または Maven 構成に Consumer SDK と Maps SDK の依存関係を追加します。

次の例では、VERSION_NUMBER を必要なバージョンの Consumer SDK に置き換えます。

Gradle

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

dependencies {
  ...
  implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-consumer:VERSION_NUMBER'
  implementation "com.google.android.gms:play-services-maps:18.1.0"
}

Maven

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

<dependencies>
  ...
  <dependency>
    <groupId>com.google.android.libraries.mapsplatform.transportation</groupId>
    <artifactId>transportation-consumer</artifactId>
    <version>VERSION_NUMBER</version>
  </dependency>
  <dependency>
    <groupId>com.google.android.gms</groupId>
    <artifactId>play-services-maps</artifactId>
    <version>18.1.0</version>
  </dependency>
</dependencies>

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

アプリに Consumer SDK を追加したら、API キーを追加します。開発プロジェクトの設定時に取得したプロジェクト API キーを使用する必要があります。詳細については、このガイドのステップ 3 で 開発プロジェクトを設定するをご覧ください。

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

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

プラグインをインストールして 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 と同期します。詳細については、Android ドキュメントの プロジェクトを 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.consumerapidemo">
        <uses-permission android:name="android.permission.ACCESS_FINE_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>

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

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

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

オープンソースの通知を含める方法については、https://developers.google.com/android/guides/opensource をご覧ください。

次のステップ

認証トークンを取得する