Android百度地图开发02之添加覆盖物 + 地理编码和反地理编码

下面来看一下地图上覆盖物的添加，以及地理编码和反地理编码。

添加覆盖物

在地图上添加覆盖物，一般需要以下几个步骤：

1. 定义坐标点，有可能是一个，有可能是多个（比如：多边形覆盖物）。

2. 构造OverlayOptions（地图覆盖物选型基类）。

3. 在地图上添加覆盖物。

4. 添加相应的监听事件。

在API中可以看到，BaiDuMap类中有一个方法：

这个方法就是用来在地图上添加覆盖物的。此方法需要一个OverlayOptions参数。

进而查看这个类。从API中可以看到这是个抽象类，实例化它就必须用它的子类。api中已经把它的所有子类列出来了，分别是：ArcOptions(弧线 形覆盖物选型类)、CircleOptions(圆形覆盖物选型类)、DotOptions(圆点覆盖物选型类)、 GroundOverlayOptions(地形图图层选型类)、MarkerOptions(标注覆盖物选型类)、PolygonOptions(多边 形选型类)、PolylineOptions(折线选型类)、TextOptions(文本选型类)。

MarkerOptions--标注覆盖物。

查看一下API，只需关注返回值是MarkerOptions的方法即可。

此时很简单就可以构造出一个MarkerOptions对象了。此时需要注意的是：必须添加图标，不然会报错！

添加图标的话，就可以使用icon(BitmapDescriptor icon)这个方法：

BitmapDescriptor是一个bitmap描述信息类。但是在api中没有看到任何关于构造这个类的方法，只有一个回收对象的方法recycle()。其实在android中，提到bitmap，一般都会跟一个“xxxFactory” 工厂类联系到一起。所以才想百度api中也会有一个关于构造BitmapDescriptor的工厂类。果不其然，看到了一个BitmapDescriptorFactory这个类。 
  

这个类中包括了很多构造bitmap描述信息类的静态方法：

OK，有了这一步，就可以构造出一个BitmapDescriptor对象了，进而对marker添加一个图片。

接下来对marker添加监听事件。一开始我猜想，应该是MarkerOptions这个类中有一个 “setOnxxx” 这种形式的方法来绑定事件，但是没有找到。最后还是在BaiDuMap这个类下面找到了两个静态的接口。

先看一下点击事件。onMarkerClickListener接口中只有一个函数：

此时就需要你添加overlay的返回值（marker）了。实际上BaiDuMap的添加覆盖物的方法addOverlay(OverlayOptions options)的返回值是Overlay。而Overlay恰好是一个好抽象类。

它的子类分别是Arc、Circle、Dot、GroundOverlay、Marker、Polygon、Polyline、Text。

正好与verlayOption的子类一一对应。

下面是点击事件的代码：

此时有一个问题，我得到了LatLng地理坐标这个对象了，怎么得到正常的地理信息呢（xx省xx市）？不要着急，慢慢往后看，反地理编码会解决这个问题的！
    下面看一下，拖拽事件（onMarkerDragListener）：

这三个方法有点类似于onTouch方法（按下，拖动，抬起）。

此时需要注意：拖拽事件，需要长按才能响应。

PolygonOptions(多边形覆盖)

继续查看API，查看这个类中的返回值是PolygonOptions的方法：

设置多边形覆盖物，当然需要多个地图上的点了。正好有一个points(List<LatLng> points)的方法用于设置多边形坐标点列表。OK，此时构造出一个PolygonOptions就不难了。

TextOptions(文字覆盖物)

设置文字覆盖物的时候，需要注意文字的颜色，字体大小，位置等属性：

GroundOverlay(地形图图层覆盖物)

地形图图层可以跟随地图进行平移，伸缩等变换，位于底图和标注图层之家，不会遮挡地图标注的信息。定义这个覆盖物的时候，需要指定宽高。这里百度API提供了两种方法：

1. 指定一个地理坐标（LatLng），在用dimensions方法来指定宽度和高度。

2. 使用positionFromBounds(LagLngBounds bounds)方法。LatLngBounds方法表示一个地理范围，包括一个东北角坐标和一个西南角坐标，这样也能确定一个矩形。
    在LatLng中有一个静态内部类Builder--地理范围构造器。

PolylineOptions(折线覆盖物)

添加折线与添加多边形的方法大致相同。这里就不多赘述了。

DotOptions(圆点覆盖物)

CircleOptions(圆形（空心）覆盖物)

ArcOptions(弧线覆盖物)

弹出窗覆盖物

在百度地图上可以添加一种可以弹出的覆盖物，弹出的窗口布局可以自定义。

API中说的很清楚，第二个构造函数，只能做显示用，没有响应事件。通过第一个构造方法，可以添加点击事件。

地理编码与反地理编码

地理编码指的是将地理信息转化成坐标关系的过程。分为正向的和反向的编码。

正向的就是指将地址信息转成坐标点的过程。比如：北京市天安门--> （123.23111， 123.23231）（我瞎写的）。反地理编码就是将地理坐标转换成具体的地址信息，通过百度的坐标定位引擎，插叙出坐标对应的物体所在的行政区划、街道等信息。

所以我们，在地图上点击的时候，或者拖动marker的时候得到的LatLng对象，就可以通过反地理编码得到具体的地址了。

实现起来也比较简单：

demo下载：