入门指南最后更新时间: 2023年12月15日

本指南是向 Android 应用添加地图的快速入门指南。

第 1 步：下载并安装 Android Studio

按照 Android Studio 编译器安装指南下载并安装 Android Studio。（注：下载地址为Google官方网站）

第 2 步：获取高德Key

使用高德 SDK 需要您在官网控制台获取Key。

如果您第一次使用，可以按照获取 Key 指南注册生成高德 Key。

第 3 步：创建项目

按以下步骤新建一个 Empty Activity 的应用项目。

启动 Android Studio。如果您看到 Welcome to Android Studio 对话框，请选择 Start a new Android Studio project，否则，请点击 Android Studio 菜单栏中的 File，然后点击 New->New Project，按提示输入您的应用名称、公司域和项目位置。然后点击 Next。
选择您的应用所需的机型。如果您不能确定自己的需要，只需选择 Phone and Tablet。然后点击 Next。
在“Add an activity to Mobile”对话框中选择 Empty Activity。然后点击 Next。
按提示输入 Activity 名称、布局名称和标题。使用默认值即可。然后点击 Finish。

第 4 步：下载并安装定位开发包

从官网下载按照需求下载开发包并解压。

解压后，会得到一个jar文件，请您将jar文件添加到工程中，操作步骤请参考开发指南的 Android Stuido jar 文件安装步骤。

第 5 步：Hello AMapLocation！

请查看 Android Studio 项目中的下列文件。

1、配置 AndroidManifest.xml 文件

默认情况下，AndroidManifest.xml 位于所设置项目目录main文件下。主要用于配置高德Key和申请权限：

在AndroidManifest.xml的application标签中配置Key：

XML


<meta-data android:name="com.amap.api.v2.apikey" android:value="您的Key">
</meta-data>

在application标签中声明service组件：

XML


<service android:name="com.amap.api.location.APSService"></service>

在AndroidManifest.xml中配置权限:

XML

<!--允许访问网络，必选权限-->
<uses-permission android:name="android.permission.INTERNET" />  

<!--允许获取精确位置，精准定位必选-->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> 
 
<!--允许获取粗略位置，粗略定位必选-->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> 

<!--允许获取网络状态，用于网络定位（无gps情况下的定位），若需网络定位功能则必选-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> 

<!--允许获取wifi网络信息，用于网络定位（无gps情况下的定位），若需网络定位功能则必选-->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> 

<!--允许获取wifi状态改变，用于网络定位（无gps情况下的定位），若需网络定位功能则必选-->
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" /> 

<!--后台获取位置信息，若需后台定位则必选-->
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" /> 

<!--用于申请调用A-GPS模块,卫星定位加速-->
<uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" /> 

<!--允许写设备缓存，用于问题排查-->
<uses-permission android:name="android.permission.WRITE_SETTINGS" />  

<!--允许写入扩展存储，用于写入缓存定位数据-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> 

<!--允许读设备等信息，用于问题排查-->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

2、实现定位

如下几行代码可以帮助您实现最基础的定位功能，您也可以参考

Java


//声明AMapLocationClient类对象
public AMapLocationClient mLocationClient = null;
//初始化定位
mLocationClient = new AMapLocationClient(getApplicationContext());
//设置定位回调监听
mLocationClient.setLocationListener(mLocationListener);
//启动定位
mLocationClient.startLocation();
//异步获取定位结果
AMapLocationListener mAMapLocationListener = new AMapLocationListener(){
@Override
public void onLocationChanged(AMapLocation amapLocation) {
    if (amapLocation != null) {
        if (amapLocation.getErrorCode() == 0) {
        //解析定位结果
    }
  }
}

第 6 步：连接 Android 设备

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

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

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

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

提示您选择设备时，选择下列选项之一：

选择与您的计算机相连的 Android 设备此外，还可以选择 Launch emulator 单选按钮，然后选择您之前配置过的虚拟设备点击 OK。 Android Studio 将调用 Gradle 构建您的应用，然后在设备或模拟器上显示结果。应用打开可能需要几分钟的时间。

后续步骤

您可能想观摩一些示例代码，可以前往示例中心下载官方示例Demo。

或者您也可以前往开发指南，阅读更多相关内容。

入门指南 最后更新时间: 2023年12月15日