示例中心
功能在线体验
控制台
您现在的位置: 开发 > Android 定位SDK > 概述 >

高德 开发 Android 定位SDK 概述

更新时间:2018年10月18日

什么是定位SDK

最新版本为 Android 定位SDK V4.3.0,包含全球定位,同时支持室内定位功能。

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,任何非盈利性网站/应用均可免费使用 。请参阅《高德地图 API 使用条款》获得详细信息。

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

示例中心 功能
在线体验
常见问题