设置现有 Android Studio 项目

本页面介绍了如何在不使用快速入门中详细介绍的 Google 地图模板的情况下,将 Android Studio 项目配置为使用 Maps SDK for Android

Google 地图模板可自动配置基本地图并将其添加到新的 Android Studio 项目。不过,您也可以向使用其他 Android Studio 模板的 Android 项目添加地图。为此,您需要先手动配置项目,然后再添加地图

设置 Android Studio

  1. 必须使用 Android Studio。如果您尚未安装,请下载安装

  2. Google Play 服务 SDK 添加到 Android Studio。Maps SDK for Android 是作为 Google Play 服务 SDK 的一部分进行分发的,您可以通过 SDK 管理器添加该 SDK。

设置 Cloud 项目和 API 密钥

设置 Cloud 项目和 API 密钥的步骤如下:

更新应用清单

本部分介绍了要添加到 AndroidManifest.xml 文件中的设置。


Google Play 服务版本号

application 元素中添加以下声明。该操作会嵌入编译应用时所用 Google Play 服务的版本。

<meta-data
    android:name="com.google.android.gms.version"
    android:value="@integer/google_play_services_version" />

位置权限

如果您的应用需要访问用户的位置信息,您就需要在 AndroidManifest.xml 文件中请求位置权限。您可以选择请求 ACCESS_FINE_LOCATION(可提供精确的用户位置信息),也可以选择请求 ACCESS_COARSE_LOCATION(提供的位置信息不太精确)。如需了解详情,请参阅位置数据指南。

要请求 ACCESS_FINE_LOCATION 权限,请将以下代码添加到 manifest 元素中:

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

外部存储权限

如果您定位到 8.3 版或更高版本的 Google Play 服务 SDK,则不需要 WRITE_EXTERNAL_STORAGE 权限。如果您定位到更低版本的 Google Play 服务 SDK,则必须在 manifest 元素中请求 WRITE_EXTERNAL_STORAGE 权限。

<uses-permission
        android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

Apache HTTP 旧版库

如果您使用的是 com.google.android.gms:play-services-maps:16.0.0 或更低版本,并且您的应用以 API 级别 28 (Android 9.0) 或更高级别为目标平台,那么您必须在 AndroidManifest.xml<application> 元素中添加以下声明。否则,请跳过添加声明的这一步。

<uses-library
    android:name="org.apache.http.legacy"
    android:required="false" />

添加地图依赖项

在应用级 build.gradle 文件中,添加地图依赖项。如需了解详情,请参阅版本控制指南。

dependencies {
    implementation 'com.google.android.gms:play-services-maps:18.0.0'
    // ...
}

后续步骤

配置完项目后,您可以添加地图