Google Map 官方指定文档地址:
https://developers.google.cn/maps/documentation/android-api/config
概览
向 Android 应用添加地图的完整过程如下:
安装 Android SDK。
安装并配置 Google Play 服务 SDK,其中包括 Google Maps Android API。 如果您使用 Google Maps Mobile SDK for Work,则必须下载并配置 Google Maps Mobile SDK for Work 静态内容库。
获取 API 密钥。 为实现此目的,您需要在 Google Developers Console 中注册一个项目,找到您的应用的签名证书,然后创建一个 API 密钥。
向您的应用的清单文件添加所需设置。
以下是有关整个过程各步骤的更多详情。
安装 Android SDK
Android Studio 是使用 Google Maps Android API 开发应用的推荐开发环境。 此外也提供了针对其他开发环境的指南。 选择与您的开发环境对应的选项卡。
ANDROID STUDIO
带 ADT 的 ECLIPSE
其他
按照指南 download 并install Android Studio。 然后添加所需的 packages,包括 Google Play 服务以及其他推荐软件包。
安装并配置 Google Play 服务 SDK
您需要为应用创建一个 Android 项目,以便完成此部分的步骤。 如果您尚未创建 Android 应用,可以按照指南创建一个“hello world”应用。 请参阅创建 Android 项目。
Google Maps Android API 作为 Google Play 服务 SDK 的一部分进行分发。 您可以通过 Android SDK 管理器下载 Google Play 服务 SDK。
如需了解详细说明,请参阅 Google Play 服务 文档。
获取 Google Maps API 密钥
如需使用 Google Maps Android API,您必须在 Google Developers Console 上注册您的应用项目,并获取可添加到应用中的 Google API 密钥。
您需要的 API 密钥类型是 Android 密钥。
如需了解详情,请参阅注册和 API 密钥。
向您的应用的清单文件添加所需设置
编辑您的应用的 AndroidManifest.xml
文件并添加以下设置。
指定 Google Play 服务版本号
在 AndroidManifest.xml
的 <application>
元素内添加以下声明。 其作用是嵌入编译应用时所用 Google Play 服务的版本。
<meta-data android:name="com.google.android.gms.version" android:value="@integer/google_play_services_version" />
指定您的 API 密钥
务必按注册和 API 密钥中所述在 AndroidManifest.xml
文件中加入您的 API 密钥。
指定 Android 权限
通过在 AndroidManifest.xml
中将 <uses-permission>
元素添加为 <manifest>
元素的子项,指定您的应用需要的权限。
位置权限
如果您的应用通过启用 My Location 层访问用户的当前位置,您必须按位置数据指南中所述请求位置权限。
外部存储权限
如果您以 Google Play 服务 SDK 8.3 版或更高版本为目标,使用 Google Maps Android API 时不再需要 WRITE_EXTERNAL_STORAGE
权限。
如果您以 Google Play 服务 SDK 的早期版本为目标,则必须请求 android.permission.WRITE_EXTERNAL_STORAGE
权限。
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
注:如果您的应用的目标平台是需要使用运行时权限的 API 级别 23 (Android 6.0),则应以 Google Play 服务 SDK 8.3 或更高版本为目标。
自动合并到清单文件中的权限
以下权限在 Google Play 服务清单文件中定义,它们会在编译时自动合并到您的应用的清单文件中。您不需要显式地将它们添加到清单文件中:
android.permission.INTERNET
- 由 API 用于从 Google 地图服务器下载地图图块
android.permission.ACCESS_NETWORK_STATE
- 允许 API 检查连接状态,以确定是否可以下载数据
指定对 OpenGL ES 第 2 版的要求
Google Maps Android API 使用 OpenGL ES 第 2 版来渲染地图。 如果未安装 OpenGL ES 第 2 版,您的地图将不会出现。 我们建议您在 AndroidManifest.xml
中添加以下 <uses-feature>
元素作为 <manifest>
元素的子元素:
<uses-feature android:glEsVersion="0x00020000" android:required="true"/>
其作用是将要求通知外部服务。 具体地讲,其作用是防止 Google Play 商店在不支持 OpenGL ES 第 2 版的设备上显示您的应用。