Android--百度地图之基础地图（三）

2022-02-04 00:47:38

开发者可利用SDK提供的接口，使用百度为您提供的基础地图数据。目前百度地图SDK所提供的地图等级为3-21级，所包含的信息有建筑物、道路、河流、学校、公园等内容。

V3.7.0起，地图支持缩放至21级，暂不支持卫星图、热力图、交通路况图层的21级显示，打开以上类型图层，地图会自动缩放到20级。

所有叠加或覆盖到地图的内容，我们统称为地图覆盖物。如标注、矢量图形元素（包括：折线、多边形和圆等）、定位图标等。覆盖物拥有自己的地理坐标，当您拖动或缩放地图时，它们会相应的移动。

百度地图SDK为广大开发者提供的基础地图和上面的各种覆盖物元素，具有一定的层级压盖关系，具体如下（从下至上的顺序）：

1、基础底图（包括底图、底图道路、卫星图等）；

2、瓦片图层（TileOverlay）；

3、地形图图层（GroundOverlay）；

4、热力图图层（HeatMap）；

5、实时路况图图层（BaiduMap.setTrafficEnabled(true);）；

6、百度城市热力图（BaiduMap.setBaiduHeatMapEnabled(true);）；

7、底图标注（指的是底图上面自带的那些POI元素）；

8、几何图形图层（点、折线、弧线、圆、多边形）；

9、标注图层（Marker），文字绘制图层（Text）；

10、指南针图层（当地图发生旋转和视角变化时，默认出现在左上角的指南针）；

11、定位图层（BaiduMap.setMyLocationEnabled(true);）；

12、弹出窗图层（InfoWindow）；

13、自定义View（MapView.addView(View);）；

地图类型

百度地图Android SDK为您提供了3种类型的地图资源（普通矢量地图、卫星图和空白地图），开发者可以利用BaiduMap中的mapType()方法来设置地图类型。核心代码如下：


[java] view plain copy  print?Android--百度地图之基础地图（三）Android--百度地图之基础地图（三）
  1. mMapView = (MapView) findViewById(R.id.bmapView);    
  2. mBaiduMap = mMapView.getMap();    
  3.    
  4. //普通地图    
  5. mBaiduMap.setMapType(BaiduMap.MAP_TYPE_NORMAL);    
  6.    
  7. //卫星地图    
  8. mBaiduMap.setMapType(BaiduMap.MAP_TYPE_SATELLITE);    
  9.    
  10. //空白地图, 基础地图瓦片将不会被渲染。在地图类型中设置为NONE，将不会使用流量下载基础地图瓦片图层。使用场景：与瓦片图层一起使用，节省流量，提升自定义瓦片图下载速度。  
  11. mBaiduMap.setMapType(BaiduMap.MAP_TYPE_NONE);  

实时交通图

当前，全国范围内已支持多个城市实时路况查询，且会陆续开通其他城市。

在地图上打开实时路况的核心代码如下：

[java] view plain copy  print?Android--百度地图之基础地图（三）Android--百度地图之基础地图（三）
  1. mMapView = (MapView) findViewById(R.id.bmapView);    
  2. mBaiduMap = mMapView.getMap();    
  3. //开启交通图     
  4. mBaiduMap.setTrafficEnabled(true);  

百度城市热力图

百度地图SDK继为广大开发者开放热力图本地绘制能力之后，再次进一步开放百度自有数据的城市热力图层，帮助开发者构建形式更加多样的移动端应用。

百度城市热力图的性质及使用与实时交通图类似，只需要简单的接口调用，即可在地图上展现样式丰富的百度城市热力图。

在地图上开启百度城市热力图的核心代码如下：

[java] view plain copy  print?Android--百度地图之基础地图（三）Android--百度地图之基础地图（三）
  1. mMapView = (MapView) findViewById(R.id.bmapView);    
  2. mBaiduMap = mMapView.getMap();    
  3. //开启交通图     
  4. mBaiduMap.setBaiduHeatMapEnabled(true);  

地图控制和手势

地图控制

地图Logo

  • 默认在左下角显示，不可以移除。

通过mMapView.setLogoPosition(LogoPosition.logoPostionleftBottom);方法，使用枚举类型控制显示的位置，共支持6个显示位置(左下，中下，右下，左上，中上，右上)。

  • 地图Logo不允许遮挡，可通过mBaiduMap.setPadding(paddingLeft, paddingTop, paddingRight, paddingBottom);方法可以设置地图边界区域，来避免UI遮挡。

其中参数paddingLeft、paddingTop、paddingRight、paddingBottom参数表示距离屏幕边框的左、上、右、下边距的距离，单位为屏幕坐标的像素密度。

指南针

指南针默认为开启状态，可以关闭显示 。

比例尺

比例尺默认为开启状态，可以关闭显示。同时支持设置MaxZoomLevel和minZoomLevel，可通过mMapView.getMapLevel获取当前地图级别下比例尺所表示的距离大小。

地图手势

地图平移

控制是否启用或禁用平移的功能，默认开启。如果启用，则用户可以平移地图

地图缩放

控制是否启用或禁用缩放手势，默认开启。如果启用，用户可以双指点击或缩放地图视图。

地图俯视（3D）

控制是否启用或禁用俯视（3D）功能，默认开启。如果启用，则用户可使用双指 向下或向上滑动到俯视图。

地图旋转

控制是否启用或禁用地图旋转功能，默认开启。如果启用，则用户可使用双指 旋转来旋转地图。

禁止所有手势

控制是否一并禁止所有手势，默认关闭。如果启用，所有手势都将被禁用。

标注覆盖物

地图标注

开发者可根据自己实际的业务需求，利用标注覆盖物，在地图指定的位置上添加标注信息。具体实现方法如下：

//定义Maker坐标点  
LatLng point = new LatLng(39.963175, 116.400244);  
//构建Marker图标  
BitmapDescriptor bitmap = BitmapDescriptorFactory  
    .fromResource(R.drawable.icon_marka);  
//构建MarkerOption，用于在地图上添加Marker  
OverlayOptions option = new MarkerOptions()  
    .position(point)  
    .icon(bitmap);  
//在地图上添加Marker，并显示  
mBaiduMap.addOverlay(option);
Android--百度地图之基础地图（三）

针对已经添加在地图上的标注，可采用如下方式进行手势拖拽：

第一步，设置可拖拽：

OverlayOptions options = new MarkerOptions()
    .position(llA)  //设置marker的位置
    .icon(bdA)  //设置marker图标
    .zIndex(9)  //设置marker所在层级
    .draggable(true);  //设置手势拖拽
//将marker添加到地图上
marker = (Marker) (mBaiduMap.addOverlay(options));
第二步，设置监听方法：

[java] view plain copy  print?Android--百度地图之基础地图（三）Android--百度地图之基础地图（三）
  1. //调用BaiduMap对象的setOnMarkerDragListener方法设置marker拖拽的监听  
  2. mBaiduMap.setOnMarkerDragListener(new OnMarkerDragListener() {  
  3.     public void onMarkerDrag(Marker marker) {  
  4.         //拖拽中  
  5.     }  
  6.     public void onMarkerDragEnd(Marker marker) {  
  7.         //拖拽结束  
  8.     }  
  9.     public void onMarkerDragStart(Marker marker) {  
  10.         //开始拖拽  
  11.     }  
  12. });  

自v3.3.0版本起，SDK提供了给Marker增加动画的能力，具体实现方法如下：

[java] view plain copy  print?Android--百度地图之基础地图（三）Android--百度地图之基础地图（三）
  1. // 通过marker的icons设置一组图片，再通过period设置多少帧刷新一次图片资源  
  2. ArrayList<BitmapDescriptor> giflist = new ArrayList<BitmapDescriptor>();  
  3. giflist.add(bdA);  
  4. giflist.add(bdB);  
  5. giflist.add(bdC);  
  6. OverlayOptions ooD = new MarkerOptions().position(pt).icons(giflist)  
  7.                 .zIndex(0).period(10);    
  8. mMarkerD = (Marker) (mBaiduMap.addOverlay(ooD));  
  9.   
  10. 针对已添加在地图上的标注覆盖物，可利用如下方法进行修改和删除操作：  
  11.   
  12. marker.remove();   //调用Marker对象的remove方法实现指定marker的删除  
  13.   
  14. 自v3.6.0版本起，SDK提供了给加载Marker增加动画的能力，加载maker时包含两种加载动画方式：从地上生长和从天上落下。  
  15.   
  16. 以生长动画为例，具体实现方法如下：  
  17.   
  18. MarkerOptions ooD = new MarkerOptions().position(llD).icons(giflist)  
  19.                 .zIndex(0).period(10);  
  20.  if (animationBox.isChecked()) {  
  21.      // 生长动画  
  22.      ooD.animateType(MarkerAnimateType.grow);  
  23.  }  
  24.  Marker  mMarkerD = (Marker) (mBaiduMap.addOverlay(ooD));  
  25.   
  26. 自v3.6.0版本起，SDK提供了给Marker设置透明度的方法，具体实现方法如下：  
  27.   
  28. MarkerOptions ooA = new MarkerOptions().position(llD).icons(giflist)  
  29.                 .zIndex(0).period(10).alpha(0.5);  
  30. mBaiduMap.addOverlay(ooA);  
  31.   
  32. 具体源码请在OverlayDemo中查看。   

点聚合功能

自v3.6.0版本起，新增点聚合功能，可通过缩小地图层级，将定义范围内的多个标注点，聚合显示成一个标注点，并在MarkerClusterDemo中开放源码，方便开发者自行修改。

[java] view plain copy  print?Android--百度地图之基础地图（三）Android--百度地图之基础地图（三）
  1. // 初始化点聚合管理类  
  2. ClusterManager mClusterManager = new ClusterManager<>(this, mBaiduMap);  
  3. // 向点聚合管理类中添加Marker实例  
  4. LatLng llA = new LatLng(39.963175, 116.400244);  
  5. List<MyItem> items = new ArrayList<>();  
  6. items.add(new MyItem(llA));  
  7. mClusterManager.addItems(items);  

具体源码请在MarkerClusterDemo中查看。

底图标注

自v3.6.0版本起，SDK在BaiduMap提供了控制底图标注的showMapPoi方法，默认显示底图标注。利用此属性可得到仅显示道路信息的地图，方法如下：

[java] view plain copy  print?Android--百度地图之基础地图（三）Android--百度地图之基础地图（三）
  1. // 将底图标注设置为隐藏，方法如下：  
  2. mBaiduMap.showMapPoi(false)  

运行后，底图标注被隐藏，效果如图：

Android--百度地图之基础地图（三）

几何图形覆盖物

地图SDK提供多种结合图形覆盖物，利用这些图形，可帮助您构建更加丰富多彩的地图应用。目前提供的几何图形有：点（Dot）、折线（Polyline）、弧线（Arc）、圆（Circle）、多边形（Polygon）。

下面以多边形为例，向大家介绍如何使用几何图形覆盖物：

[java] view plain copy  print?Android--百度地图之基础地图（三）Android--百度地图之基础地图（三）
  1. //定义多边形的五个顶点    
  2. LatLng pt1 = new LatLng(39.93923, 116.357428);    
  3. LatLng pt2 = new LatLng(39.91923, 116.327428);    
  4. LatLng pt3 = new LatLng(39.89923, 116.347428);    
  5. LatLng pt4 = new LatLng(39.89923, 116.367428);    
  6. LatLng pt5 = new LatLng(39.91923, 116.387428);    
  7. List<LatLng> pts = new ArrayList<LatLng>();    
  8. pts.add(pt1);    
  9. pts.add(pt2);    
  10. pts.add(pt3);    
  11. pts.add(pt4);    
  12. pts.add(pt5);    
  13. //构建用户绘制多边形的Option对象    
  14. OverlayOptions polygonOption = new PolygonOptions()    
  15.     .points(pts)    
  16.     .stroke(new Stroke(5, 0xAA00FF00))    
  17.     .fillColor(0xAAFFFF00);    
  18. //在地图上添加多边形Option，用于显示    
  19. mBaiduMap.addOverlay(polygonOption);  

运行结果如下：

Android--百度地图之基础地图（三）

Android地图SDK自v3.5.0版本起，新增了折线多段颜色绘制能力，实现的核心代码如下：

[java] view plain copy  print?Android--百度地图之基础地图（三）Android--百度地图之基础地图（三）
  1. //构造纹理资源  
  2. BitmapDescriptor custom1 = BitmapDescriptorFactory  
  3.                 .fromResource(R.drawable.icon_road_red_arrow);  
  4. BitmapDescriptor custom2 = BitmapDescriptorFactory  
  5.                 .fromResource(R.drawable.icon_road_green_arrow);  
  6. BitmapDescriptor custom3 = BitmapDescriptorFactory  
  7.                 .fromResource(R.drawable.icon_road_blue_arrow);  
  8. // 定义点  
  9. LatLng pt1 = newLatLng(39.93923, 116.357428);  
  10. LatLng pt2 = newLatLng(39.91923, 116.327428);  
  11. LatLng pt3 = newLatLng(39.89923, 116.347428);  
  12. LatLng pt4 = newLatLng(39.89923, 116.367428);  
  13. LatLng pt5 = newLatLng(39.91923, 116.387428);  
  14.    
  15. //构造纹理队列  
  16. List<BitmapDescriptor>customList = newArrayList<BitmapDescriptor>();  
  17. customList.add(custom1);  
  18. customList.add(custom2);  
  19. customList.add(custom3);  
  20.    
  21. List<LatLng> points = newArrayList<LatLng>();  
  22. List<Integer> index = newArrayList<Integer>();  
  23. points.add(pt1);//点元素  
  24. index.add(0);//设置该点的纹理索引  
  25. points.add(pt2);//点元素  
  26. index.add(0);//设置该点的纹理索引  
  27. points.add(pt3);//点元素  
  28. index.add(1);//设置该点的纹理索引  
  29. points.add(pt4);//点元素  
  30. index.add(2);//设置该点的纹理索引  
  31. points.add(pt5);//点元素  
  32. //构造对象  
  33. OverlayOptionsooPolyline = newPolylineOptions().width(15).color(0xAAFF0000).points(points).customTextureList(customList).textureIndex(index);  
  34. //添加到地图  
  35. mBaiduMap.addOverlay(ooPolyline);  

效果图如下:

Android--百度地图之基础地图（三）

自v3.6.0版本起，扩展了折线多段颜色绘制能力：增加支持分段纹理绘制、分段颜色绘制,实现的核心代码如下：

构造PolylineOptions对象，添加折线分段颜色绘制覆盖物，核心代码如下：

[java] view plain copy  print?Android--百度地图之基础地图（三）Android--百度地图之基础地图（三）
  1. // 构造折线点坐标  
  2. List<LatLng> points = new ArrayList<LatLng>();  
  3. points.add(new LatLng(39.965,116.404));  
  4. points.add(new LatLng(39.925,116.454));  
  5. points.add(new LatLng(39.955,116.494));  
  6. points.add(new LatLng(39.905,116.554));  
  7. points.add(new LatLng(39.965,116.604));  
  8.    
  9. //构建分段颜色索引数组  
  10. List<Integer> colors = new ArrayList<>();  
  11. colors.add(Integer.valueOf(Color.BLUE));  
  12. colors.add(Integer.valueOf(Color.RED));  
  13. colors.add(Integer.valueOf(Color.YELLOW));  
  14. colors.add(Integer.valueOf(Color.GREEN));  
  15.    
  16. OverlayOptions ooPolyline = new PolylineOptions().width(10)  
  17.         .colorsValues(colors).points(points);  
  18. 添加在地图中  
  19. Polyline  mPolyline = (Polyline) mBaiduMap.addOverlay(ooPolyline);  

检索结果覆盖物

针对检索功能模块（POI检索、线路规划等），地图SDK还对外提供相应的覆盖物来快速展示结果信息。这些方法都是开源的，开发者可根据自己的实际去求来做个性化的定制。

利用检索结果覆盖物展示POI搜索结果的方式如下：

第一步，构造自定义 PoiOverlay 类；

[java] view plain copy  print?Android--百度地图之基础地图（三）Android--百度地图之基础地图（三）
  1. private class MyPoiOverlay extends PoiOverlay {    
  2.     public MyPoiOverlay(BaiduMap baiduMap) {    
  3.         super(baiduMap);    
  4.     }    
  5.     @Override    
  6.     public boolean onPoiClick(int index) {    
  7.         super.onPoiClick(index);    
  8.         return true;    
  9.     }    
  10. }  

第二步，在POI检索回调接口中添加自定义的PoiOverlay；

[java] view plain copy  print?Android--百度地图之基础地图（三）Android--百度地图之基础地图（三）
  1. public void onGetPoiResult(PoiResult result) {    
  2.     if (result == null || result.error == SearchResult.ERRORNO.RESULT_NOT_FOUND) {    
  3.         return;    
  4.     }    
  5.     if (result.error == SearchResult.ERRORNO.NO_ERROR) {    
  6.         mBaiduMap.clear();    
  7.         //创建PoiOverlay    
  8.         PoiOverlay overlay = new MyPoiOverlay(mBaiduMap);    
  9.         //设置overlay可以处理标注点击事件    
  10.         mBaiduMap.setOnMarkerClickListener(overlay);    
  11.         //设置PoiOverlay数据    
  12.         overlay.setData(result);    
  13.         //添加PoiOverlay到地图中    
  14.         overlay.addToMap();    
  15.         overlay.zoomToSpan();    
  16.         return;    
  17.     }    
  18. }  

运行结果如下：

Android--百度地图之基础地图（三）

利用TransitRouteOverlay展示公交换乘结果：
[java] view plain copy print?Android--百度地图之基础地图（三）Android--百度地图之基础地图（三）
  1. //在公交线路规划回调方法中添加TransitRouteOverlay用于展示换乘信息    
  2. public void onGetTransitRouteResult(TransitRouteResult result) {    
  3.     if (result == null || result.error != SearchResult.ERRORNO.NO_ERROR) {    
  4.         //未找到结果    
  5.         return;    
  6.     }    
  7.     if (result.error == SearchResult.ERRORNO.AMBIGUOUS_ROURE_ADDR) {    
  8.         //起终点或途经点地址有岐义，通过以下接口获取建议查询信息    
  9.         //result.getSuggestAddrInfo()    
  10.         return;    
  11.     }    
  12.     if (result.error == SearchResult.ERRORNO.NO_ERROR) {    
  13.         route = result.getRouteLines().get(0);    
  14.         //创建公交路线规划线路覆盖物     
  15.         TransitRouteOverlay overlay = new MyTransitRouteOverlay(mBaidumap);    
  16.         //设置公交路线规划数据       
  17.         overlay.setData(route);    
  18.         //将公交路线规划覆盖物添加到地图中    
  19.         overlay.addToMap();    
  20.         overlay.zoomToSpan();    
  21.    }    
  22. }  

运行结果如下：
Android--百度地图之基础地图（三）

转载：http://blog.csdn.net/chaoyu168/article/details/51360899
上一篇：说说Android的广播(1) - 普通广播,有序广播和粘性广播


下一篇：RxJava 和 RxAndroid 一 (基础)