Android百度地图(二):百度地图sdk显示位置点、图层绘制

转载、引用请标明出处
http://www.jianshu.com/p/fdd1ba783495

本文出自zhh_happig的简书博客，谢谢

上一篇文章介绍定位sdk 类方法参数、定位原理，讲述了如何利用定位sdk进行定位。这篇文章将讲解如何显示定位位置和绘制图层，以及地图相关api的讲解。

一 百度地图sdk介绍

通过定位sdk获取的BDLocation类中包含了当前位置的：经纬度，省、市、区、街道等地址信息。如果应用只需要获取用户当前位置所在的市、县、区等信息，那么定位sdk就可以满足你的需求。如果要具体显示位置在哪，除了通过定位sdk获取经纬度之外，还需要通过百度地图来显示。

百度地图sdk提供了Mapview、BaiduMap、OverlayOptions、Overlay等api，用于地图的操作与图层绘制。

MapView就是一张图，就是一个View，它不会产生位置。

定位sdk能获取经纬度，相当于x、y坐标；地图根据坐标找到对应的点，在地图图层上画一个图标标识，这就是我们在地图上看到的定位

地图+定位位置

了解这些，如何在地图上显示出定位点就简单了，我们需要地图与位置。

二 百度地图与定位sdk的结合使用

1.初始化地图

//伪代码// 地图初始化MapView mMapView = (MapView) findViewById(R.id.bmapView);BaiduMap mBaiduMap = mMapView.getMap();//获取地图实例// 开启定位图层，一定不要少了这句，否则对在地图的设置、绘制定位点将无效mBaiduMap.setMyLocationEnabled(true);

这样地图就获取到了，接着对定位图标进行配置，非常简单，一句代码。也可以不配置，百度会用默认的图标

/*** 对定位的图标进行配置，需要MyLocationConfiguration实例，这个类是用设置定位图标的显示方式的 */mBaiduMap.setMyLocationConfiguration(new MyLocationConfiguration(locationMode, true, bitmapDescriptor));

MyLocationConfiguration有2个构造方法

new MyLocationConfiguration(LocationMode lm, boolean direction, BitmapDescriptor bd);new MyLocationConfiguration(LocationMode lm, boolean direction, BitmapDescriptor bd,int fillColor,int strokeColor);

LocationMode：图标类型
有三种：
LocationMode.NORMAL：普通

普通图标：圆点，不显示方向；地图方位固定，上北下南左西右东

LocationMode.FOLLOWING：跟随

跟随图标：地图方位固定，上北下南左西右东；箭头转动，箭头表示手机头部所朝的方向，

LocationMode.COMPASS：罗盘

罗盘图标：地图会随方向转动，有指南针的方向标识；可观察箭头方向偏离北的情况

direction：是否允许显示方向信息，如果设置为false，则图标任何情况下都不会有箭头

BitmapDescriptor：用户自定义定位图标，可以更换定位图标样式

fillColor：精度圈填充颜色(半径等于location.getRadius())
strokeColor：精度圈边框颜色
如果不想要这个精度圈，使用location.getRadius() = 0；

3.定位sdk初始化

// 定位初始化LocationClient mLocClient = new LocationClient(this);mLocClient.registerLocationListener(myListener);//注册定位位置监听回调LocationClientOption option = new LocationClientOption();//定位方式参数设置option.setOpenGps(true); // 打开gpsoption.setCoorType("bd09ll"); // 设置坐标类型option.setScanSpan(1000);//周期性请求定位，1秒返回一次位置mLocClient.setLocOption(option);//参数设置mLocClient.start();//开始定位

定位sdk更多api详解请阅读百度地图(一):百度地图定位sdk 类方法参数、定位原理详细介绍

4.位置监听回调

//伪代码public class MyLocationListenner implements BDLocationListener {    @Override    public void onReceiveLocation(BDLocation location) {        //定位位置回调        /**        * MyLocationData 定位数据类，地图上的定位位置需要经纬度、精度、方向这几个参数，所以这里我们把这个几个参数传给地图        * 如果不需要要精度圈，推荐builder.accuracy(0);        * mCurrentDirection 是通过手机方向传感器获取的方向；也可以设置option.setNeedDeviceDirect(true)获取location.getDirection()，          但是这不会时时更新位置的方向，因为周期性请求定位有时间间隔。        * location.getLatitude()和location.getLongitude()经纬度，如果你只需要在地图上显示某个固定的位置，完全可以写入固定的值，          如纬度36.958454，经度114.137588，这样就不要要同过定位sdk来获取位置了        */        MyLocationData locData = new MyLocationData.Builder().accuracy(location.getRadius())        .direction(mCurrentDirection).latitude(location.getLatitude()).longitude(location.getLongitude()).build();        mBaiduMap.setMyLocationData(locData);//给地图设置定位数据，这样地图就显示位置了        /**        *当首次定位时，记得要放大地图，便于观察具体的位置        * LatLng是缩放的中心点，这里注意一定要和上面设置给地图的经纬度一致；        * MapStatus.Builder 地图状态构造器        */        if (isFirstLoc) {            isFirstLoc = false;            LatLng ll = new LatLng(location.getLatitude(), location.getLongitude());            MapStatus.Builder builder = new MapStatus.Builder();            //设置缩放中心点；缩放比例；            builder.target(ll).zoom(18.0f);           //给地图设置状态            mBaiduMap.animateMapStatus(MapStatusUpdateFactory.newMapStatus(builder.build()));        }    }}

5.绘制图层

/*** 绘制Marker，地图上常见的类似气球形状的图层*/MarkerOptions markerOptions = new MarkerOptions();//参数设置类markerOptions.position(latLng);//marker坐标位置markerOptions.icon(icon);//marker图标，可以自定义markerOptions.draggable(false);//是否可拖拽，默认不可拖拽markerOptions.anchor(0.5f, 1.0f);//设置 marker覆盖物与位置点的位置关系，默认（0.5f, 1.0f）水平居中，垂直下对齐markerOptions.alpha(0.8f);//marker图标透明度，0~1.0，默认为1.0markerOptions.animateType(MarkerAnimateType.drop);//marker出现的方式，从天上掉下markerOptions.flat(false);//marker突变是否平贴地面markerOptions.zIndex(1);//index//Marker动画效果markerOptions.icons(bitmapList);//如果需要显示动画，可以设置多张图片轮番显示markerOptions.period(10);//每个10ms显示bitmapList里面的图片...mMarker = (Marker) mBaiduMap.addOverlay(markerOptions);//在地图上增加mMarker图层/*** 绘制折线*/PolylineOptions polylineOptions= new PolylineOptions();//参数设置类polylineOptions.width(10);//宽度,单位：像素polylineOptions.color(0xAAFF0000);//设置折线颜色polylineOptions.points(points);//折线顶点坐标集/*** colorValue：List<Integer>，折线颜色集合* 如果这里设置了折现颜色集合，那么options.color()中设置的颜色会被覆盖* 例：5个点能画出4条线段，每条线段绘制时按照索引依次取值，  如果颜色个数小于线段个数，剩余线段取最后一个颜色绘制*/polylineOptions.colorsValues(colorValue);polylineOptions.dottedLine(false);//是否是虚线，默认为falsepolylineOptions.zIndex(9);//indexpolylineOptions.visible(true);//是否可见，默认可见polylineOptions.extraInfo(bundle);//附加bundle/*** 设置线段纹理样式，所以折线纹理样式是可以自己定义的* textureList:折现纹理样式集合 * textureIndexs:折线纹理索引，绘制时按照索引从textureList里面取样式，  如下面代码中，0和1就是textureList的索引，这样就会先取a再取b，  如果textureIndexs.add(1)然后再textureIndexs.add(0)就先取b再取a了，  所以textureIndexs里面的值不能乱加，应该是小于等于textureList个数的值，不然就出错了。*/List<BitmapDescriptor> textureList = new ArrayList<BitmapDescriptor>();textureList.add(BitmapDescriptorFactory.fromResource(R.drawable.a));textureList.add(BitmapDescriptorFactory.fromResource(R.drawable.b));polylineOptions.customTextureList(textureList);//设置折现纹理样式List<Integer> textureIndexs = new ArrayList<Integer>();textureIndexs.add(0);textureIndexs.add(1);polylineOptions.textureIndex(textureIndexs);...mPolyline = (Polyline) mBaiduMap.addOverlay(polylineOptions);//在地图上增加mPolyline图层/*** 绘制多边形*/PolygonOptions polygonOptions = new PolygonOptions();polygonOptions.points(pts);//多边形顶点坐标集polygonOptions.stroke(new Stroke(5, 0xAA00FF00));//边框样式polygonOptions.fillColor(0xAAFFFF00);//填充颜色mPolygon = mBaiduMap.addOverlay(polygonOptions);//在地图上增加mPolygon 图层/*** 绘制圆形*/OverlayOptions oCircle = new CircleOptions().fillColor(0x000000FF)                .center(latLngCircle).stroke(new Stroke(5, 0xAA000000))                .radius(1400);mBaiduMap.addOverlay(oCircle);/*** 绘制弧形*/OverlayOptions oArc = new ArcOptions().color(0xAA00FF00).width(4)                .points(p1, p2, p3);//三点绘制一个弧形mBaiduMap.addOverlay(oArc);/*** 绘制文本文字*/OverlayOptions ooText = new TextOptions().bgColor(0xAAFFFF00)                .fontSize(24).fontColor(0xFFFF00FF).text("文字内容").rotate(-30)                .position(latLngText);mBaiduMap.addOverlay(ooText);

6.地图关键api介绍

//是将地理坐标转换为屏幕上的坐标，其中point.y是地理位置点相对于MapView左上角的y轴坐标。Point point = mBaiduMap.getProjection().toScreenLocation(latLng);//截图mBaiduMap.snapshot(new SnapshotReadyCallback() {    @Override    public void onSnapshotReady(Bitmap arg0) {    }});//截图， Rect指定区域mBaiduMap.snapshotScope(new Rect(), new SnapshotReadyCallback() {    @Override    public void onSnapshotReady(Bitmap arg0) {    }});mBaiduMap.setMapType(BaiduMap.MAP_TYPE_SATELLITE);//设置地图类型，卫星地图mBaiduMap.clear();//清空地图所有的 Overlay 覆盖物以及 InfoWindow//Overlay所有图层父类mOverlay.setVisible(true);//设置图层是否可见mOverlay.remove();//删除该图层，只删除这一个；mBaiduMap.clear()会把所有的图层清空，这有时候不是我们需要看到。

更多百度地图api会在后续文章中介绍

7.地图事件监听

// 点击Marker事件响应mBaiduMap.setOnMarkerClickListener(new OnMarkerClickListener() {    @Override    public boolean onMarkerClick(Marker marker) {        if(marker.getZIndex() == mMarker.getZIndex()){//判断是哪个marker            //获取mMarker的信息        }        return false;    }});// Marker拖拽事件响应mBaiduMap.setOnMarkerDragListener(new OnMarkerDragListener() {          @Override    public void onMarkerDragStart(Marker arg0) {        //拖拽开始    }                @Override    public void onMarkerDragEnd(Marker arg0) {        //拖拽结束      }                @Override    public void onMarkerDrag(Marker arg0) {        //拖拽中    }});// 点击Polyline事件响应mBaiduMap.setOnPolylineClickListener(new BaiduMap.OnPolylineClickListener() {    @Override    public boolean onPolylineClick(Polyline polyline) {              if(polyline.getZIndex() == mPolyline.getZIndex()){//判断是哪个mPolyline                mPolyline.getPoints();//获取折线点集合                mPolyline.getExtraInfo();//获取附加的信息                ...        }        return false;    }});//地图点击事件响应mBaiduMap.setOnMapClickListener(new BaiduMap.OnMapClickListener() {    @Override    public void onMapClick(LatLng latLng) {        //点击地图某个位置获取经纬度latLng.latitude、latLng.longitude    }    @Override    public boolean onMapPoiClick(MapPoi mapPoi) {        //点击地图上的poi图标获取描述信息：mapPoi.getName()，经纬度：mapPoi.getPosition()        return false;    }});//地图加载完成事件响应mBaiduMap.setOnMapLoadedCallback(new OnMapLoadedCallback() {    @Override    public void onMapLoaded() {        //地图的有些操作需要再加载完成之后进行    }});//地图中心、缩放状态改变事件响应mBaiduMap.setOnMapStatusChangeListener(new OnMapStatusChangeListener() {    @Override    public void onMapStatusChangeStart(MapStatus status) {        //开始    }                @Override    public void onMapStatusChangeFinish(MapStatus status) {//完成        status.target;//当前中心点        status.zoom;//当前缩放比例        ...    }                @Override    public void onMapStatusChange(MapStatus status) {                    }});//地图定位图标点击响应事件mBaiduMap.setOnMyLocationClickListener(new OnMyLocationClickListener() {    @Override    public boolean onMyLocationClick() {        ...        return false;    }});

地图响应事件还有很多，不一一列举了，想了解更多，阅读api就可以了，比较简单，难的是如何将这些结合起来实现功能，后续文章将会讲到。

退出时记得释放资源

//伪代码protected void onDestroy() {    // 退出时销毁定位    mLocClient.unRegisterLocationListener(myListener);    mLocClient.stop();    // 关闭定位图层    mBaiduMap.setMyLocationEnabled(false);    mBaiduMap.clear();    mMapView.onDestroy();    mMapView = null;}

到这里，百度地图sdk就介绍了，还是很简单的，更多api会在后续文章中讲解。

如果各位看官觉得文章不错，别忘了点个喜欢。
源码下载地址 https://github.com/zhuhaoHappig/BaiduMapApi

作者：zhh_happig
链接：http://www.jianshu.com/p/fdd1ba783495
來源：简书
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。