設定 Google Cloud 控制台專案

設定並設定 Google Cloud 控制台,以便將 Consumer SDK 用於 在 Android 裝置上,按照下列步驟操作。

  1. 設定開發專案
  2. 在應用程式中加入 Consumer SDK
  3. 在應用程式中加入 API 金鑰
  4. 在應用程式中加入必要的作者資訊

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

設定開發專案

如果您沒有 Google Cloud 控制台開發專案,也沒有 則需要設定一個行動專案。詳情請參閱 參閱 Fleet Engine 指南中的建立專案

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

在應用程式中加入 Consumer SDK

Consumer SDK 是從私人 Maven 存放區取得。存放區 包括 SDK 的專案物件模型 (.pom) 檔案和 Javadocs。如要新增 呼叫應用程式的消費者 SDK,請按照下列步驟操作:

  1. 按照下列說明設定環境以存取主機 Maven 存放區 本指南的步驟 2

  2. 在 Gradle 或 Maven 中加入 Consumer SDK 和 Maps SDK 依附元件 此外還會從 0 自動調整資源配置 您完全不必調整資源調度設定

    在下方範例中,將 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 金鑰安全性最佳做法, 請參閱有關 API 安全性最佳做法的 Google 地圖平台文章。

您可以參考 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 包括開放原始碼通知

後續步驟

取得驗證權杖