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

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

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

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

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

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

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

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

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

Driver SDK をアプリに追加する

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

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

注: Driver SDK は Navigation SDK に依存します。依存関係を 明示的に定義したバージョンの Navigation SDK の 2 つのバージョンがあります。 それ以外の場合は、サンプル コードブロックを省略して、プロジェクトで常にダウンロードされるようにします。 メジャー リリース バージョンに含まれている Navigation SDK の最新バージョン。「 Driver SDK と Navigation SDK の最新バージョンの動作の組み合わせは、 厳しいテストを経てリリースされました。

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

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

変更方法については、オープンソースの通知を追加するをご覧ください。 オープンソース通知が含まれます

次のステップ

依存関係の宣言