GitHub 上的 Maps SDK for Android 代码库中包含一些示例,说明了如何在 Android 应用中使用 Maps SDK for Android。
该代码库中包含 ApiDemos 应用,这是一个示例应用,可让您通过单个 Android 应用构建和运行示例。您可以导入并构建应用、添加 API 密钥、查看演示版功能,并以提供的示例代码为基础开发您的应用。
当您运行示例应用时,它会显示一个包含可用示例的列表,您可以在自己的设备上运行这些示例。选择其中一个选项。例如,点击基本地图。
问题排查:如果示例应用可成功运行,但您看不到地图,请确认您已按使用 API 密钥中所述向应用的清单文件中添加了 API 密钥。
Maps SDK for Android 示例应用列表
下面列出了 Maps SDK for Android ApiDemos 应用中包含的关键示例活动,并且在链接页中进行了介绍,以便于您快速查看。有关可用示例的完整列表,请查看 Kotlin 或 Java 文件夹。
克隆并运行示例
您必须拥有 Git,才能在本地运行此示例。以下命令会克隆示例应用代码库。
git clone git@github.com:googlemaps-samples/android-samples.git
将示例项目导入到 Android Studio:
- 在 Android Studio 中,依次选择 File > New > Import Project。
前往代码库的保存位置并选择 Kotlin 或 Java 的项目目录:
- Kotlin:
PATH-REPO/android-samples/ApiDemos/kotlin
- Java:
PATH-REPO/android-samples/ApiDemos/java
- Kotlin:
- 选择 Open。Android Studio 会使用 Gradle 构建工具来构建您的项目。
- 在项目的
local.properties
文件所在的同一目录中,创建一个空白secrets.properties
文件。如需了解详情,请参阅将您的 API 密钥添加到项目中。 在
secrets.properties
中添加以下字符串,并将 YOUR_API_KEY 替换为您的 API 密钥的值:MAPS_API_KEY=YOUR_API_KEY
- 运行应用。
Wear OS 上地图的示例应用
GitHub 上提供了适用于 Wear OS 的 Maps SDK for Android 示例应用,您可以将其作为基础来开发穿戴式应用。该示例向您展示了如何在 Wear OS 上设置基本 Google 地图。