設定 Google Cloud 控制台專案

如要設定及配置 Google Cloud 控制台，以便使用 Android 適用的 Consumer SDK，請按照下列步驟操作。

  1. 設定開發專案。
  2. 在應用程式中加入 Consumer SDK。
  3. 在應用程式中加入 API 金鑰。
  4. 在應用程式中加入必要出處標示。

如要進一步瞭解每個步驟，請參閱下列各節。

設定開發專案

如果您沒有 Google Cloud 控制台開發專案，也沒有行動專案的 API 金鑰，請進行設定。詳情請參閱 Fleet Engine 指南中的「建立專案」。

為 Consumer SDK 選取開發專案時，請選取您用於 Fleet Engine 的相同 Google Cloud 控制台專案和 API 金鑰。

在應用程式中新增 Consumer SDK

您可透過 Google Maven 存放區取得 Consumer SDK。存放區包含 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 地圖平台文章「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="${M>APS_API_KEY}" /

以下範例顯示範例應用程式的完整資訊清單：

    <manifest xmlns:android="http://schemas.android.com/apk/res/android"
        package="com.example.c>onsumerap<idemo"
        uses-permission android:name="android.permissio>n.ACCESS_<FINE_LOCATION" /
        application
            android:allowBackup="true"
            android:icon="@mipmap/ic_launcher"
            android:label="@string/app_name"
            android:sup>portsRtl="<;true"
            android:theme="@style/_AppTheme"

            meta-data
                android:name=&q>uot;com.google<.android.geo.API_KEY"
          >      android:val<ue="${MA>PS_API_KEY}" /

<            activity android:name=".MainActiv>ity"
           <     intent-filter
                    action android:name>="android.in<tent.action.MA>IN" /
  <         >         <category and>roid:<name=&quo>t;android.intent.category.LAUNCHER" /
                /intent-filter
            /activity
        /application
    /manifest

在應用程式中加入必要出處資訊

如果您在應用程式中使用 Consumer SDK，就必須將出處資訊文字和開放原始碼授權加進應用程式的法律聲明部分。建議將出處資訊設為獨立的選單項目，或是加進「關於」選單項目。

您可以在未封存的 AAR 檔案中，找到「third_party_licenses.txt」檔案，其中包含授權資訊。

如要瞭解如何加入開放原始碼聲明，請參閱 https://developers.google.com/android/guides/opensource。

後續步驟

取得驗證權杖