用法介绍高德定位SDK(定位SDK使用)

一、SDK概述

高德定位SDK是一款面向Android、iOS等移动操作系统，可进行移动端定位、导航等功能的高德地图服务软件开发工具包。SDK提供了定位功能、逆地理编码功能、搜索车站、导航等功能。使用SDK，开发者无需关心定位技术实现细节，仅需简单调用API即可轻松实现定位功能。

对于开发者而言，除了具备定位功能以外，高德定位SDK 还用于提升用户体验和优化业务流程。利用该 SDK，能够更好的实现需求，为移动端开发提供一种高效可靠的解决方案。

二、SDK功能介绍

1. 定位功能

高德 SDK 提供了定位能力，支持包括 GPS、Wi-Fi、基站等多种定位方式，并基于多种定位技术，提供高精准度的定位服务。采用Android SDK 提供的 AMapLocationClient 类实现，能够快速、可靠地实现定位功能，同时提供了丰富的定位信息，包括经度、纬度、地址、速度等。详细代码如下：

//创建AMapLocationClient实例对象
mLocationClient = new AMapLocationClient(mContext.getApplicationContext());
//设置定位回调监听
mLocationClient.setLocationListener(mLocationListener);

//初始化AMapLocationClientOption对象
AMapLocationClientOption mLocationOption = new AMapLocationClientOption();
//设置定位模式为高精度模式，Battery_Saving为低功耗模式，Device_Sensors是仅设备(GPS定位)
mLocationOption.setLocationMode(AMapLocationClientOption.AMapLocationMode.Hight_Accuracy);
//设置单次定位
mLocationOption.setOnceLocation(true);
//设置定位间隔,单位毫秒,默认为2000ms，最低1000ms
mLocationOption.setInterval(2000);
//设置定位参数
mLocationClient.setLocationOption(mLocationOption);
//启动定位
mLocationClient.startLocation();

2. 逆地理编码功能

逆地理编码指将一组经纬度坐标转换为对应的地址信息，包括中文地址、邮政编码、城市信息、省份信息等。高德SDK提供了逆地理编码功能。采用 Android SDK 提供的 GeocodeSearch 类实现，能够获取到对应的地址信息、门牌号等详细地址信息。

//创建GeocodeSearch实例
GeocodeSearch geocoderSearch = new GeocodeSearch(mContext);
//设置地址查询监听
geocoderSearch.setOnGeocodeSearchListener(new GeocodeSearch.OnGeocodeSearchListener() {
            @Override
            public void onRegeocodeSearched(RegeocodeResult result, int rCode) {
                if(rCode == AMapException.CODE_AMAP_SUCCESS){
                   if(result != null && result.getRegeocodeAddress() != null 
                          && result.getRegeocodeAddress().getFormatAddress() != null){
                      String address = result.getRegeocodeAddress().getFormatAddress();
                   }
                }
            }
            @Override
            public void onGeocodeSearched(GeocodeResult result, int rCode) {}
});

//根据经纬度查询地址信息
LatLonPoint latLonPoint = new LatLonPoint(30.657060,104.065735);
RegeocodeQuery query = new RegeocodeQuery(latLonPoint, 200,
RegeocodeQuery.AMAP);
geocoderSearch.getFromLocationAsyn(query);

三、集成SDK步骤

1. 添加依赖库

首先，在module的build.gradle文件中，添加高德 Android SDK 的相关依赖库。在dependencies标签中添加如下代码：

dependencies {
	//高德定位SDK依赖库
    implementation 'com.amap.api:location:x.x.x'
}

2. 获取高德Key

获取高德 Key是使用高德 SDK 前的必要操作。进入高德开发者平台，创建应用，获得对应的高德 key:

//配置高德Key

3. 初始化定位SDK

在代码中使用 AMapLocationClient、AMapLocationClientOption 来配置定位 SDK，生成客户端实例，并将参数配置到客户端中

//初始化AMapLocationClient实例，执行定位操作
public void initLocator() {
    mLocationClient = new AMapLocationClient(getApplicationContext());
    mLocationOption = getDefaultOption();
    //设置定位参数
    mLocationClient.setLocationOption(mLocationOption);
    //设置定位回调监听
    mLocationClient.setLocationListener(mLocationListener);
}

//获取AMapLocationClientOption对象
private AMapLocationClientOption getDefaultOption() {
    AMapLocationClientOption mOption = new AMapLocationClientOption();
    //获取最近3s内精度最高的一次定位结果（快）
    mOption.setLocationMode(AMapLocationClientOption.AMapLocationMode.Hight_Accuracy);
    //只定位一次
    mOption.setOnceLocation(true);
    //设置定位间隔,单位毫秒,默认为2000ms，最低1000ms
    mOption.setInterval(2000);
    //设置是否使用缓存定位，默认为true
    mOption.setLocationCacheEnable(true);
    return mOption;
}

四、总结

高德定位 SDK 提供了易用性、精度高等特点，满足了各类地图应用的需求。根据上述介绍，我们可以看出：定位功能、逆地理编码功能等能力是高德定位 SDK 的核心优势，通过 SDK 强大的基础能力，定位结果准确可靠、覆盖范围广泛、使用方便易操作。