更新时间:2020-06-23
坐标系说明
Android定位SDK产品,支持全球定位,能够精准的获取经纬度信息。根据开发者的设置,在国内获得的坐标系类型可以是:国测局坐标、百度墨卡托坐标 和 百度经纬度坐标。在海外地区,只能获得WGS84坐标。请开发者在使用过程中注意坐标选择。定位SDK默认输出GCJ02坐标,地图SDK默认输出BD09ll坐标。
显示定位
通过如下几步您便可以在自己的地图中展示当前所在位置的定位点。
1确保您的开发包中包含基本定位功能,该选项在您下载开发包时默认不会被选中
2配置AndroidManifest.xml文件
1.加入如下权限使用声明
<!-- 这个权限用于进行网络定位 --> <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> <!-- 这个权限用于访问GPS定位 --> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
2.在Application标签中声明定位的service组件
<service android:name="com.baidu.location.f" android:enabled="true" android:process=":remote"/>
3开启地图的定位图层
mBaiduMap.setMyLocationEnabled(true);
4构造地图数据
我们通过继承抽象类BDAbstractListener并重写其onReceieveLocation方法来获取定位数据,并将其传给MapView。
public class MyLocationListener extends BDAbstractLocationListener { @Override public void onReceiveLocation(BDLocation location) { //mapView 销毁后不在处理新接收的位置 if (location == null || mMapView == null){ return; } MyLocationData locData = new MyLocationData.Builder() .accuracy(location.getRadius()) // 此处设置开发者获取到的方向信息,顺时针0-360 .direction(location.getDirection()).latitude(location.getLatitude()) .longitude(location.getLongitude()).build(); mBaiduMap.setMyLocationData(locData); } }
5通过LocationClient发起定位
//定位初始化 mLocationClient = new LocationClient(this); //通过LocationClientOption设置LocationClient相关参数 LocationClientOption option = new LocationClientOption(); option.setOpenGps(true); // 打开gps option.setCoorType("bd09ll"); // 设置坐标类型 option.setScanSpan(1000); //设置locationClientOption mLocationClient.setLocOption(option); //注册LocationListener监听器 MyLocationListener myLocationListener = new MyLocationListener(); mLocationClient.registerLocationListener(myLocationListener); //开启地图定位图层 mLocationClient.start();
6正确管理各部分的生命周期
@Override protected void onResume() { mMapView.onResume(); super.onResume(); } @Override protected void onPause() { mMapView.onPause(); super.onPause(); } @Override protected void onDestroy() { mLocationClient.stop(); mBaiduMap.setMyLocationEnabled(false); mMapView.onDestroy(); mMapView = null; super.onDestroy(); }
上图为18级缩放下的显示效果。
自定义内容
通过MyLocationConfiguration类来构造包括定位的属性,定位模式、是否开启方向、设置自定义定位图标、精度圈填充颜色以及精度圈边框颜色5个属性。
MyLocationConfiguration(LocationMode mode, boolean enableDirection, BitmapDescriptor customMarker, int accuracyCircleFillColor, int accuracyCircleStrokeColor)
上述代码中五个参数详细介绍如下:
定位模式 地图SDK支持三种定位模式:NORMAL(普通态), FOLLOWING(跟随态), COMPASS(罗盘态)
mCurrentMode = LocationMode.FOLLOWING;//定位跟随态 mCurrentMode = LocationMode.NORMAL; //默认为 LocationMode.NORMAL 普通态 mCurrentMode = LocationMode.COMPASS; //定位罗盘态
自定义定位图标 支持自定义定位图标样式,替换定位icon
mCurrentMarker = BitmapDescriptorFactory.fromResource(R.drawable.icon_geo);
自定义精度圈填充颜色
//自定义精度圈填充颜色 accuracyCircleFillColor = 0xAAFFFF88;
自定义精度圈边框颜色
//自定义精度圈边框颜色 accuracyCircleStrokeColor = 0xAA00FF00;
在定义了以上属性之后,通过如下方法来设置生效:
mBaiduMap.setMyLocationConfiguration(mLocationConfiguration)显示效果如图:
上图为21级缩放下的显示效果。
另外有两个属性不可以通过上述方法设置,说明如下:
定位精度圈大小
定位精度圈大小 ,是根据当前定位精度自动控制的,无法手动控制大小。精度圈越小,代表当前定位精度越高;反之圈越大,代表当前定位精度越低。
定位指针方向
定位指针朝向,是通过获取手机系统陀螺仪数据,控制定位指针的方向,需要开发者自己实现,并不在地图实现范畴。
定位的频次自定义
开发者可以自行设置获取定位的时间间隔,详细的设置方法可以参考定位SDK。