Maps SDK for Android 实用程序设置

请选择平台： Android iOS

本页面介绍如何设置 Maps SDK for Android 实用程序库，以及如何运行库中包含的演示版应用。

前提条件和说明

Maps SDK for Android 实用程序库支持 Android API 级别 15 及更高级别。您在设置项目 build 目标时，请务必使用最新的 Android API 级别。

GitHub 上提供了相关参考文档。

第 1 步：安装 Maps SDK for Android 实用程序库

将以下依赖项添加到应用的 build.gradle 文件：

dependencies {


    // Utility Library for Maps SDK for Android
    // You do not need to add a separate dependency for the Maps SDK for Android
    // since this library builds in the compatible version of the Maps SDK.
    implementation 'com.google.maps.android:android-maps-utils:3.8.0'
}

使用库中的某个实用程序，例如标记聚类、热图或其他实用程序。

第 2 步：（可选）安装 Maps SDK for Android 实用程序的 KTX 库

Maps SDK for Android 实用程序库附带了相应的 Kotlin 扩展程序 (KTX) 库。此库提供 Kotlin 语言功能（例如扩展函数、命名参数和默认参数），使您能够编写简洁而规范的 Kotlin 代码。如果您不使用 Kotlin 进行开发，则可以跳过此步骤。

要使用此库，除了 android-maps-utils 依赖项之外，还应将以下依赖项添加到应用的 build.gradle 文件中：

dependencies {

    // KTX for the Maps SDK for Android Utility Library
    implementation 'com.google.maps.android:maps-utils-ktx:5.1.1'
}

如需详细了解此库，请访问 Maps KTX GitHub 页面。

第 3 步：查看 Maps SDK for Android 实用程序库的源代码

由于该实用程序库是开源的，因此您可以将 android-maps-utils 库下载到计算机上，以便对其进行自定义、查看演示版应用，或者单纯了解该库的工作原理。您可以通过克隆代码库（建议采用此方式以便接收自动更新）或下载 zip 文件来实现上述目的。如果您想自定义该库，则应复刻该代码库。

该代码库中包含：

  • 一个演示版应用，位于 demo 目录中。
  • 实用程序库，位于 library 目录中。
  • 各类包含许可、贡献者和自述文件信息的文件。
  • Gradle build 配置，以用于 Android Studio。

运行实用程序演示版应用

实用程序库的 GitHub 代码库自带一个演示版应用，其中包含每个实用程序的实现代码示例。请按以下步骤在您的 Android 设备上运行演示版应用。

  1. 采用上述任一方式下载代码库。
  2. 在 Android Studio 中，依次选择 File -> New -> Import Project。
  3. 浏览到在您克隆实用程序库时创建的 android-maps-utils 目录，并选中（双击）它。现在，Android Studio 将构建该项目。
  4. 如果您使用的是 Android 设备而非模拟器，请务必启用开发者模式。然后将 Android 设备与计算机相连。

  5. 向 local.properties 添加一行代码，如下所示：

    MAPS_API_KEY=YOUR_API_KEY

    其中 YOUR_API_KEY 是您按照使用 API 密钥一文中的说明获取的 API 密钥。

  6. 构建并运行演示版应用。

此应用应在 Android 设备上打开，显示实用程序列表，包括聚类、polyutil、热图等。您还可以在应用列表中找到该应用，它在列表中的名称是 Maps Utils Demo。