Maps SDK for Android 示例代码

请选择平台: Android iOS JavaScript

GitHub 上的 Maps SDK for Android 代码库中包含一些示例,说明了如何在 Android 应用中使用 Maps SDK for Android。

该代码库中包含 ApiDemos 应用,这是一个示例应用,可让您通过单个 Android 应用构建和运行示例。您可以导入并构建应用、添加 API 密钥、查看演示版功能,并以提供的示例代码为基础开发您的应用。

当您运行示例应用时,它会显示一个包含可用示例的列表,您可以在自己的设备上运行这些示例。选择其中一个选项。例如,点击基本地图

问题排查:如果示例应用可成功运行,但您看不到地图,请确认您已按使用 API 密钥中所述向应用的清单文件中添加了 API 密钥。

Maps SDK for Android 示例应用列表

下面列出了 Maps SDK for Android ApiDemos 应用中包含的关键示例活动,并且在链接页中进行了介绍,以便于您快速查看。有关可用示例的完整列表,请查看 KotlinJava 文件夹。

克隆并运行示例

您必须拥有 Git,才能在本地运行此示例。以下命令会克隆示例应用代码库。

git clone git@github.com:googlemaps-samples/android-samples.git

将示例项目导入到 Android Studio:

  1. 在 Android Studio 中,依次选择 File > New > Import Project
  2. 前往代码库的保存位置并选择 Kotlin 或 Java 的项目目录:

    • KotlinPATH-REPO/android-samples/ApiDemos/kotlin
    • JavaPATH-REPO/android-samples/ApiDemos/java
  3. 选择 Open。Android Studio 会使用 Gradle 构建工具来构建您的项目。
  4. 在项目的 local.properties 文件所在的同一目录中,创建一个空白 secrets.properties 文件。如需了解详情,请参阅将您的 API 密钥添加到项目中
  5. secrets.properties 中添加以下字符串,并将 YOUR_API_KEY 替换为您的 API 密钥的值:

    MAPS_API_KEY=YOUR_API_KEY
  6. 运行应用。

Wear OS 上地图的示例应用

GitHub 上提供了适用于 Wear OS 的 Maps SDK for Android 示例应用,您可以将其作为基础来开发穿戴式应用。该示例向您展示了如何在 Wear OS 上设置基本 Google 地图。