开发 Android 定位SDK 概述

概述 最后更新时间: 2021年11月23日

重要:由于个人信息保护法的实施,从定位5.6.0版本起对旧版本SDK不兼容,请务必确保调用SDK任何接口前先调用更新隐私合规updatePrivacyShow、updatePrivacyAgree两个接口,否则可能导致编译不通过等异常情况。具体可参考开发指南-开发注意事项-隐私合规接口说明传入相关参数。

Flutter兼容性:Flutter3.0.0版本已发布,兼容Android定位5.6.0、iOS定位2.8.0、地图8.1.0及以上版本,可前往 Flutter插件下载页面 获取对应版本。

什么是定位SDK

Android 定位 SDK 是一套简单的LBS服务定位接口,您可以使用这套定位API获取定位结果、逆地理编码(地址文字描述)、以及地理围栏功能。

面向的读者

Android 定位 SDK 是提供给具有一定 Android 编程经验和了解面向对象概念的读者使用的。

功能介绍与体验

  • 基础定位
    //声明mlocationClient对象 
    public AMapLocationClient mlocationClient;
    //声明mLocationOption对象
    public AMapLocationClientOption mLocationOption = null;
    mlocationClient = new AMapLocationClient(this);
    //初始化定位参数
    mLocationOption = new AMapLocationClientOption();
    //设置定位监听
    mlocationClient.setLocationListener(this);
    //设置定位模式为高精度模式,Battery_Saving为低功耗模式,Device_Sensors是仅设备模式
    mLocationOption.setLocationMode(AMapLocationMode.Hight_Accuracy);
    //设置定位间隔,单位毫秒,默认为2000ms
    mLocationOption.setInterval(2000);
    //设置定位参数
    mlocationClient.setLocationOption(mLocationOption);
    // 此方法为每隔固定时间会发起一次定位请求,为了减少电量消耗或网络流量消耗,
    // 注意设置合适的定位时间的间隔(最小间隔支持为1000ms),并且在合适时间调用stopLocation()方法来取消定位请求
    // 在定位结束后,在合适的生命周期调用onDestroy()方法
    // 在单次定位情况下,定位无论成功与否,都无需调用stopLocation()方法移除请求,定位sdk内部会移除
    //启动定位
    mlocationClient.startLocation();
    @Override
    	public void onLocationChanged(AMapLocation amapLocation) {
    		if (amapLocation != null) {
            if (amapLocation.getErrorCode() == 0) {
            //定位成功回调信息,设置相关消息
            amapLocation.getLocationType();//获取当前定位结果来源,如网络定位结果,详见定位类型表
            amapLocation.getLatitude();//获取纬度
            amapLocation.getLongitude();//获取经度
            amapLocation.getAccuracy();//获取精度信息
            SimpleDateFormat df = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
            Date date = new Date(amapLocation.getTime());
            df.format(date);//定位时间
        } else {
                  //显示错误信息ErrCode是错误码,errInfo是错误信息,详见错误码表。
            Log.e("AmapError","location Error, ErrCode:"
                + amapLocation.getErrorCode() + ", errInfo:"
                + amapLocation.getErrorInfo());
            }
        }
    	}
  • 逆地理编码
    //声明mLocationOption对象
    public AMapLocationClientOption mLocationOption = null;
    mlocationClient = new AMapLocationClient(this);
    //初始化定位参数
    mLocationOption = new AMapLocationClientOption();
    //设置返回地址信息,默认为true
    mLocationOption.setNeedAddress(true);
    //设置定位监听
    mlocationClient.setLocationListener(this);
    //设置定位模式为高精度模式,Battery_Saving为低功耗模式,Device_Sensors是仅设备模式
    mLocationOption.setLocationMode(AMapLocationMode.Hight_Accuracy);
    //设置定位间隔,单位毫秒,默认为2000ms
    mLocationOption.setInterval(2000);
    //设置定位参数
    mlocationClient.setLocationOption(mLocationOption);
    // 此方法为每隔固定时间会发起一次定位请求,为了减少电量消耗或网络流量消耗,
    // 注意设置合适的定位时间的间隔(最小间隔支持为1000ms),并且在合适时间调用stopLocation()方法来取消定位请求
    // 在定位结束后,在合适的生命周期调用onDestroy()方法
    // 在单次定位情况下,定位无论成功与否,都无需调用stopLocation()方法移除请求,定位sdk内部会移除
    //启动定位
    mlocationClient.startLocation();
    @Override
    	public void onLocationChanged(AMapLocation amapLocation) {
    	    if (amapLocation != null) {
            if (amapLocation.getErrorCode() == 0) {
            	//定位成功回调信息,设置相关消息
            	amapLocation.getLocationType();//获取当前定位结果来源,如网络定位结果,详见定位类型表
            	amapLocation.getLatitude();//获取纬度
            	amapLocation.getLongitude();//获取经度
            	amapLocation.getAccuracy();//获取精度信息
            	SimpleDateFormat df = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
            	Date date = new Date(amapLocation.getTime());
           	  df.format(date);//定位时间
            	amapLocation.getAddress();//地址,如果option中设置isNeedAddress为false,则没有此结果,网络定位结果中会有地址信息,GPS定位不返回地址信息。
            	amapLocation.getCountry();//国家信息
            	amapLocation.getProvince();//省信息
            	amapLocation.getCity();//城市信息
            	amapLocation.getDistrict();//城区信息
            	amapLocation.getStreet();//街道信息
              amapLocation.getStreetNum();//街道门牌号信息
            	amapLocation.getCityCode();//城市编码
            	amapLocation.getAdCode();//地区编码
              amapLocation.getAOIName();//获取当前定位点的AOI信息
        } else {
            //显示错误信息ErrCode是错误码,errInfo是错误信息,详见错误码表。
            Log.e("AmapError","location Error, ErrCode:"
                + amapLocation.getErrorCode() + ", errInfo:"
                + amapLocation.getErrorInfo());
            }
        }
    	}

下载完整示例代码


账号与Key的申请

注册成为高德开发者需要分三步:

第一步,注册高德开发者;

第二步,去控制台创建应用;

第三步,获取Key。

具体步骤可参看下图

获取 API Key

兼容性

高德定位SDK支持Android 2.2及以上系统。

给开发者的建议

(1)对于高德开放平台提供的地图API/SDK,若您以非商业目的使用,则均可免费使用 。若您以商业目的使用,则您需事先从高德获取商用授权。您需要先申请Key,才能使用该服务。关于具体使用规则,请参阅《高德地图开放平台服务协议》获得详细信息。 

(2)您可以通过开发指南和参考手册来掌握Android 定位SDK 的开发。

返回顶部 示例中心 常见问题 智能客服 公众号
二维码