一 、定位介绍
百度地图Android定位SDK提供GPS、基站、WiFi、地磁、蓝牙、传感器等多种定位方式,适用于室内、室外多种定位场景,具有出色的定位性能:定位精度高、覆盖率广、网络定位请求流量小、定位速度快,在室内无gps时,百度定位就是利用的WiFi和基站定位的,在室外有gps时,百度是利用的android自带的LocationManager进行定位,当然室外也可以用WiFi基站定位。
- GPS定位:精度很高,几米到十几米,但是耗电严重。
- WiFi定位:精度相对于GPS差一点,但是也能到十几米、几十米,也有上百米的误差的,低耗电。
- 基站定位:精度很差,一般都有几百米,上千米的误差。
二 、百度地图配置
implementation 'com.baidu.lbsyun:BaiduMapSDK_Location_All:9.1.8'
- 添加AK
- 添加所需服务
//Application标签中声明service组件,每个App拥有自己单独的定位service
- 添加功能权限:
注意:安卓6.0系统以上,一些权限需要动态申请
三 、百度地图定位
1. 初始化LocationClient类
public LocationClient mLocationClient = null;;public void onCreate(){ mLocationClient = new LocationClient(getApplicationContext());//声明LocationClient类 mLocationClient.registerLocationListener(myListener);//注册监听函数}
2. 配置定位SDK参数
LocationClientOption mOption = new LocationClientOption();/*** 默认高精度,设置定位模式* LocationMode.Hight_Accuracy 高精度定位模式:这种定位模式下,会同时使用* LocationMode.Battery_Saving 低功耗定位模式:这种定位模式下,不会使用GPS,只会使用网络定位。* LocationMode.Device_Sensors 仅用设备定位模式:这种定位模式下,*/mOption.setLocationMode(LocationMode.Hight_Accuracy);/*** 默认是true,设置是否使用gps定位* 如果设置为false,即使mOption.setLocationMode(LocationMode.Hight_Accuracy)也不会gps定位*/mOption.setOpenGps(true);/*** 默认gcj02,设置返回的定位结果坐标系,如果配合百度地图使用,建议设置为bd09ll;* 目前国内主要有以下三种坐标系:1. wgs84:目前广泛使用的GPS全球卫星定位系统使用的标准坐标系;2. gcj02:经过国测局加密的坐标;3. bd09:为百度坐标系,其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标;* 在国内获得的坐标系类型可以是:国测局坐标、百度墨卡托坐标 和 百度经纬度坐标。在海外地区,只能获得WGS84坐标。请在使用过程中注意选择坐标。*/mOption.setCoorType("bd09ll");/*** 默认0,即仅定位一次;设置间隔需大于等于1000ms,表示周期性定位* 如果不在AndroidManifest.xml声明百度指定的Service,周期性请求无法正常工作* 这里需要注意的是:如果是室外gps定位,不用访问服务器,设置的间隔是3秒,那么就是3秒返回一次位置如果是WiFi基站定位,需要访问服务器,这个时候每次网络请求时间差异很大,设置的间隔是3秒,只能大概保证3秒左右会返回就一次位置,有时某次定位可能会5秒才返回*/mOption.setScanSpan(3000);/*** 默认false,设置是否需要地址信息* 返回省、市、区、街道等地址信息,这个api用处很大,很多新闻类app会根据定位返回的市区信息推送用户所在市的新闻*/mOption.setIsNeedAddress(true);/*** 默认false,设置是否需要位置语义化结果* 可以在BDLocation.getLocationDescribe里得到,结果类似于“在北京天安门附近”*/mOption.setIsNeedLocationDescribe(true);/*** 默认false,设置是否需要设备方向传感器的方向结果* 一般在室外gps定位时,返回的位置信息是带有方向的,但是有时候gps返回的位置也不带方向,这个时候可以获取设备方向传感器的方向* wifi基站定位的位置信息是不带方向的,如果需要可以获取设备方向传感器的方向*/mOption.setNeedDeviceDirect(false);/*** 默认false,设置是否当gps有效时按照设定的周期频率输出GPS结果* 室外gps有效时,周期性1秒返回一次位置信息,其实就是设置了locationManager.requestLocationUpdates中的minTime参数为1000ms,1秒回调一个gps位置* 如果设置了mOption.setScanSpan(3000),那minTime就是3000ms了,3秒回调一个gps位置*/mOption.setLocationNotify(false);/*** 默认true,定位SDK内部是一个SERVICE,并放到了独立进程,设置是否在stop的时候杀死这个进程,默认不杀死* 如果你已经拿到了你要的位置信息,不需要再定位了,不杀死留着干嘛*/mOption.setIgnoreKillProcess(true);/*** 默认false,设置是否需要POI结果,可以在BDLocation.getPoiList里得到* POI就是获取到的位置附近的一些商场、饭店、银行等信息*/mOption.setIsNeedLocationPoiList(true);/*** 默认false,设置是否收集CRASH信息,默认收集*/mOption.SetIgnoreCacheException(false);/*** 默认false,设置定位时是否需要海拔高度信息,默认不需要,除基础定位版本都可用*/mOption.setIsNeedAltitude(false);mLocationClient.setLocOption(mOption);//设置定位参数
3. 发起定位
发起定位,便能够从BDAbstractLocationListener监听接口中获取定位结果信息。
//mLocationClient为第二步初始化过的LocationClient对象//调用LocationClient的start()方法,便可发起定位请求mLocationClient.start();//tart():启动定位SDK;stop():关闭定位SDK。调用start()之后只需要等待定位结果自动回调即可。//开发者定位场景如果是单次定位的场景,在收到定位结果之后直接调用stop()函数即可。//如果stop()之后仍然想进行定位,可以再次start()等待定位结果回调即可。//自v7.2版本起,新增LocationClient.reStart()方法,用于在某些特定的异常环境下重启定位。
4.实现BDAbstractLocationListener接口
发起定位后,即可获取所需要的信息
private class MyBDAbstractLocationListener extends BDAbstractLocationListener {@Overridepublic void onReceiveLocation(BDLocation bdLocation) {//此处的BDLocation为定位结果信息类,通过它的各种get方法可获取定位相关的全部结果 if (null != location && location.getLocType() != BDLocation.TypeServerError) {} }}
4.1 获取基本定位信息
bdLocation.getLatitude();//纬度bdLocation.getLongitude();//经度bdLocation.getDirection();//定位方向bdLocation.getRadius();//定位精度bdLocation.getCoorType();//定位坐标类型bdLocation.getLocType();//定位类型、定位错误返回码bdLocation.getLocTypeDescription();//对应的定位类型说明bdLocation.getTime();//获取经纬度服务器时间//判断用户是在室内,还是在室外1:室内,0:室外,这个判断不一定是100%准确的bdLocation.getUserIndoorState();
4.2 获取地址信息
注意:配置定位SDK参数中,添加获取地址信息option.setIsNeedAddress(true);
bdLocation.getAddrStr();//获取详细地址信息bdLocation.getCountry();//获取国家bdLocation.getProvince();//获取省份bdLocation.getCity();//获取城市bdLocation.getDistrict();//获取区县bdLocation.getStreet();//获取街道信息
4.3 获取位置信息描述
注意:首先在配置定位SDK参数中,添加获取位置信息描述option.setIsNeedLocationDescribe(true);
location.getLocationDescribe();//获取位置描述信息
4.4 周边POI信息
获取位置附近的一些商场、饭店、银行等信息
注意:首先在配置定位SDK参数中,添加获取周边信息option.setIsNeedLocationPoiList(true);
在实现的BDAbstractLocationListener接口中,通过getPoiList()方法,即可获取周边信息
List poiList = bdLocation.getPoiList(); //POI信息包括POI ID、名称等,具体信息请参照类参考中POI类的相关说明
4.5 判断定位类型
if (bdLocation.getLocType() == BDLocation.TypeGpsLocation) {// GPS定位结果bdLocation.getSpeed();// 速度 单位:km/hbdLocation.getSatelliteNumber();// 卫星数目bdLocation.getAltitude();// 海拔高度 单位:米bdLocation.getGpsAccuracyStatus();// *****gps质量判断*****Toast.makeText(MainActivity.this, "gps定位成功", Toast.LENGTH_SHORT).show();} else if (bdLocation.getLocType() == BDLocation.TypeNetWorkLocation) {// 网络定位结果 // 运营商信息if (bdLocation.hasAltitude()) {// *****如果有海拔高度*****bdLocation.getAltitude();// 单位:米}(bdLocation.getOperators(); // 运营商信息Toast.makeText(MainActivity.this, "网络定位成功", Toast.LENGTH_SHORT).show();} else if (bdLocation.getLocType() == BDLocation.TypeOffLineLocation) {// 离线定位结果Toast.makeText(MainActivity.this, "离线定位成功,离线定位结果也是有效的", Toast.LENGTH_SHORT).show();} else if (bdLocation.getLocType() == BDLocation.TypeServerError) {Toast.makeText(MainActivity.this, "服务端网络定位失败,可以反馈IMEI号和大体定位时间到loc-bugs@baidu.com,会有人追查原因", Toast.LENGTH_SHORT).show();} else if (bdLocation.getLocType() == BDLocation.TypeNetWorkException) {Toast.makeText(MainActivity.this, "网络不通导致定位失败,请检查网络是否通畅", Toast.LENGTH_SHORT).show();} else if (bdLocation.getLocType() == BDLocation.TypeCriteriaException) {Toast.makeText(MainActivity.this, "法获取有效定位依据导致定位失败,一般是由于手机的原因,处于飞行模式下一般会造成这种结果,可以试着重启手机", Toast.LENGTH_SHORT).show();}
4.6 国内外位置判断
//此处的BDLocation为定位结果信息类,通过它的各种get方法可获取定位相关的全部结果//以下只列举与国内外判断相关的内容//更多结果信息获取说明,请参照类参考中BDLocation类中的说明//BDLocation.getLocationWhere()方法可获得当前定位点是否是国内,它的取值及含义如下://BDLocation.LOCATION_WHERE_IN_CN:当前定位点在国内;//BDLocation.LOCATION_WHERE_OUT_CN:当前定位点在海外;//其他:无法判定。
4.7 位置提醒
定位SDK支持位置提醒功能,位置提醒最多提醒3次,3次过后将不再提醒。假如需要再次提醒、或者要修改提醒点坐标,都可通过函数SetNotifyLocation()来实现。
4.7.1 注册监听函数
//注册监听函数 mLocationClient.registerNotify(myListener);
4.7.2 实现位置监听的回调
定义MyNotifyLister类,继承BDNotifyListener,实现位置监听的回调。public class MyNotifyLister extends BDNotifyListener {public void onNotify(BDLocation mlocation, float distance){//已到达设置监听位置附近} }
4.7.3 实现设置位置消息提醒
调用BDNotifyListener的setNotifyLocation方法,实现设置位置消息提醒。myListener.setNotifyLocation(40.0f, 116.0f, 3000, mLocationClient.getLocOption().getCoorType());//设置位置提醒,四个参数分别是:纬度,经度,距离范围,坐标系类型(gcj02,gps,bd09,bd09ll)
4.7.4 启动定位
启动定位,SDK便会自动开启位置消息提醒的监听。调用LocationClient的start()方法,启动定位。核心代码如下:mLocationClient.start();//mLocationClient为第二步初始化过的LocationClient对象//调用LocationClient的start()方法,开启定位
4.7.5 取消监听
调用BDNotifyListener的removeNotifyEvent方法,实现取消位置监听。核心代码如下:myListener.removeNotifyEvent(myListener);//myListener为第二步中定义过的BDNotifyListener对象//调用执行removeNotifyEvent方法,即可实现取消监听
5. 释放资源
mLocationClient.unregisterListener(myLocationListener); //注销掉监听mLocationClient.stop(); //停止定位
-END