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