配置 Google Cloud 控制台项目

要设置和配置 Google Cloud 控制台，以便将使用方 SDK 用于 Android 设备，请按以下步骤操作。

  1. 设置您的开发项目。
  2. 将消费者 SDK 添加到您的应用。
  3. 将 API 密钥添加到您的应用。
  4. 在您的应用中添加必要的提供方说明。

如需详细了解每个步骤，请参阅以下部分。

设置您的开发项目

如果您没有 Google Cloud 控制台开发项目和 移动项目，则需要先设置一个。有关详情，请参阅 在 Fleet Engine 指南中创建项目。

在为使用方 SDK 选择开发项目时，请选择 您用于 Fleet Engine 的 Google Cloud 控制台项目和 API 密钥。

将消费者 SDK 添加到您的应用

消费者 SDK 可通过专用 Maven 制品库获取。仓库 包括 SDK 的项目对象模型 (.pom) 文件和 Javadocs。要将 使用方 SDK 添加到您的应用中，请按以下步骤操作：

  1. 按照说明设置您的环境以访问托管 Maven 制品库， 本指南的第 2 步。

  2. 将使用方 SDK 和 Maps SDK 依赖项添加到您的 Gradle 或 Maven 配置。

    在以下示例中，将 VERSION_NUMBER 替换为所需的 消费者 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 密钥

将消费者 SDK 添加到应用后，请添加 API 密钥。您必须使用 您在设置开发项目时获取的项目 API 密钥。对于 如需了解详情，请参阅本指南第 3 步中的设置开发项目。

本部分介绍了如何存储 API 密钥，以提高其安全性 由您的应用引用如需详细了解 API 密钥安全最佳实践 请参阅有关 API 安全性最佳实践的 Google Maps Platform 文章。

如需简化此任务，请参阅 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>

在您的应用中添加必要的提供方说明

如果您在应用中使用消费者 SDK，则必须添加提供方说明文本和 开源许可。最好 将提供方说明作为独立菜单项或关于 。

您可以在“third_party_licenses.txt”中找到许可信息文件 已取消归档的 AAR 文件。

如需了解如何操作，请参阅 https://developers.google.com/android/guides/opensource 包含开源声明。

后续步骤

获取身份验证令牌