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

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

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

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

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

Google Cloud コンソールの開発プロジェクトと、Google Cloud コンソールの API キー 設定する必要があるので詳しくは、 Fleet Engine ガイドのプロジェクトを作成します。

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

アプリに Consumer SDK を追加する

Consumer SDK は非公開の Maven リポジトリから入手できます。リポジトリ には、SDK のプロジェクト オブジェクト モデル(.pom)ファイルと Javadocs が含まれています。追加するには、 コンシューマ SDK をアプリに追加する方法は次のとおりです。

  1. 以下の説明に従って、ホスト Maven リポジトリにアクセスするように環境を設定します。 このガイドのステップ 2

  2. Consumer SDK と Maps SDK の依存関係を Gradle または Maven に追加する できます。

    次の例では、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:VERSION_NUMBER"
    }
    

    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 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 を使用する場合は、帰属情報テキストと アプリの法的通知のセクションに記載する必要があります。おすすめは、 帰属情報を独立したメニュー項目として、または [概要] の一部として記載すること 選択します。

ライセンス情報は「third_party_licenses.txt」で確認できます。ファイル - アーカイブ解除された AAR ファイル

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

次のステップ

認証トークンを取得する