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

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

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

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

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

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

このセクションでは、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 の構成に追加します。

注: Driver SDK は Navigation SDK に依存します。依存関係を 明示的に定義したバージョンの Navigation SDK の 2 つのバージョンがあります。 それ以外の場合は、サンプルコード ブロックを省略して、プロジェクトがメジャー リリース バージョン内の最新バージョンの 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」ファイルにあります。

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

次のステップ

依存関係の宣言