一切就绪!

着手开发前,请先阅读我们的开发者文档

激活 Google Maps Android API

为帮助您起步,我们将引导您在 Google Developers Console 中先完成几项任务:

  1. 创建或选择项目
  2. 激活 Google Maps Android API
  3. 创建相应密钥
继续

入门指南

本指南是向 Android 应用添加地图的快速入门指南。 Android Studio 是使用 Google Maps Android API 开发应用的推荐开发环境。

第 1 步:下载 Android Studio

按照指南下载安装 Android Studio。

第 2 步:安装 Google Play 服务 SDK

Google Play 服务软件包添加到 Android Studio。

第 3 步:创建 Google 地图项目

按以下步骤新建一个包含地图 Activity 的应用项目:

  1. 启动 Android Studio。
  2. 按以下所述创建新项目:

    • 如果您看到 Welcome to Android Studio 对话框,请选择位于对话框右侧“Quick Start”之下的 Start a new Android Studio project

    • 否则,请点击 Android Studio 菜单栏中的 File,然后点击 NewNew Project

  3. 按提示输入您的应用名称、公司域和项目位置。 然后点击 Next

  4. 选择您的应用所需的机型。 如果您不能确定自己的需要,只需选择 Phone and Tablet。 然后点击 Next

  5. 在“Add an activity to Mobile”对话框中选择 Google Maps Activity。 然后点击 Next
  6. 按提示输入 Activity 名称、布局名称和标题。 使用默认值即可。 然后点击 Finish

Android Studio 启动 Gradle 并构建您的项目。 这可能需要几秒钟的时间。 如需了解有关在 Android Studio 中创建项目的详细信息,请参阅 Android Studio 文档

构建完成后,Android Studio 会在编辑器中打开 google_maps_api.xml 文件和 MapsActivity.java 文件。 (请注意,您的 Activity 可能具有不同的名称,但它应是安装期间您配置的名称。) 请注意,google_maps_api.xml 文件包含有关在您尝试运行应用前获取 Google Maps API 密钥的说明。

下一部分会对获取 API 密钥做更详尽的介绍。

第 4 步:获取 Google Maps API 密钥

您的应用需要使用 API 密钥来访问 Google 地图服务器。 您需要的密钥类型是仅限于 Android 应用的 API 密钥。 该密钥免费。 您可将其用于您的任何调用 Google Maps Android API 的应用,并且其支持的用户数量不受限制。

请选择以下方法之一从 Android Studio 中获取您的 API 密钥:

  • 最简单、快捷的方法:使用 Android Studio 为您创建的 google_maps_api.xml 文件中提供的链接:
    1. 复制 google_maps_api.xml 文件中提供的连接,然后将其粘贴到您的浏览器中。该链接跳转至 Google API Console 并通过网址参数向 Google API Console 提供所需的信息,从而减少所需的手动输入。
    2. 按照说明在 Google API Console 上新建一个项目,或者选择某个现有项目。
    3. 为您的项目创建受 Android 限制的 API 密钥。
    4. 复制生成的 API 密钥,返回 Android Studio,并将该 API 密钥粘贴到 google_maps_api.xml 文件中的 <string> 元素中。
  • 速度稍慢的方法:使用 Android Studio 为您创建的 google_maps_api.xml 文件中提供的凭据:
    1. 复制 google_maps_api.xml 文件中提供的凭据。
    2. 转至浏览器中的 Google API Console
    3. 使用所复制的凭据将您的应用添加至某个现有的 API 密钥,或者新建一个 API 密钥。
  • 获取 API 密钥的完整流程:如果以上两种方式对您的情况均不奏效,请执行完整流程

第 5 步:你好,地图!查看代码

检查模板提供的代码。 具体地讲,请查看 Android Studio 项目中的下列文件。

XML 布局文件

默认情况下,定义应用布局的 XML 文件位于 res/layout/activity_maps.xml。 它包含以下代码:

<fragment xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:id="@+id/map"
    tools:context=".MapsActivity"
    android:name="com.google.android.gms.maps.SupportMapFragment" />

地图 Activity Java 文件

默认情况下,定义地图 Activity 的 Java 文件名为 MapsActivity.java。 它在您的软件包名称后应包含以下代码:

import android.os.Bundle;
import android.support.v4.app.FragmentActivity;
import com.google.android.gms.maps.CameraUpdateFactory;
import com.google.android.gms.maps.GoogleMap;
import com.google.android.gms.maps.OnMapReadyCallback;
import com.google.android.gms.maps.SupportMapFragment;
import com.google.android.gms.maps.model.LatLng;
import com.google.android.gms.maps.model.MarkerOptions;

public class MapsActivity extends FragmentActivity implements OnMapReadyCallback {

    private GoogleMap mMap;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_maps);
        SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager()
                .findFragmentById(R.id.map);
        mapFragment.getMapAsync(this);
    }

    @Override
    public void onMapReady(GoogleMap googleMap) {
        mMap = googleMap;

        // Add a marker in Sydney, Australia, and move the camera.
        LatLng sydney = new LatLng(-34, 151);
        mMap.addMarker(new MarkerOptions().position(sydney).title("Marker in Sydney"));
        mMap.moveCamera(CameraUpdateFactory.newLatLng(sydney));
    }
}

如果您的地图 Activity 文件不包含以上代码,请将文件软件包名称后的内容替换为以上代码。

第 6 步:连接 Android 设备

了解您的应用实际运行情况的最简单方法是将 Android 设备与计算机相连。 按照说明在您的 Android 设备上启用开发者选项,并配置您的应用和系统以检测设备。

此外,您也可以使用 Android Emulator 来运行您的应用。 使用 Android Virtual Device (AVD) Manager 来配置一台或多台虚拟设备,您可以将设备与 Android Emulator 联用来构建和运行您的应用。

选择模拟器时,请确保您使用的是 Android 4.2.2 或更高版本,并谨慎选择包含 Google API 的映像,否则此应用将不具有执行所需的运行时 API。

另请注意有关配置虚拟机加速的说明,您应该按照说明中所述将其用于 x86 目标 AVD

这可以改善您的模拟器使用体验。

第 7 步:构建和运行您的应用

在 Android Studio 中,点击 Run 菜单选项(或 play 按钮图标)运行您的应用。

提示您选择设备时,选择下列选项之一:

  • 选择与您的计算机相连的 Android 设备
  • 此外,还可以选择 Launch emulator 单选按钮,然后选择您之前配置过的虚拟设备

点击 OK。 Android Studio 将调用 Gradle 构建您的应用,然后在设备或模拟器上显示结果。 应用打开可能需要几分钟的时间。

您看到的地图应该在澳大利亚悉尼位置带有一个标记。 如果您未看到地图,请确认您已完成本页面上介绍的所有步骤。

具体地讲,请确认您已按上文所述添加了 API 密钥。

后续步骤

您可能想观摩一些示例代码

您可以在开发者指南中阅读更多有关地图对象的内容。

发送以下问题的反馈:

此网页
Google Maps Android API
Google Maps Android API
需要帮助?请访问我们的支持页面