思享工具箱

【07】覆盖物（百度地图覆盖物笔记）

摘要：
覆盖地图覆盖概括了叠加或覆盖在地图上的所有内容，统称为地图覆盖。封面有自己的地理坐标。当您拖动或缩放地图时，它们将相应地移动。地图API提供了以下几种覆盖：覆盖：覆盖的抽象基类。所有覆盖都继承该类的方法。你可以使用地图。addOverlay方法将覆盖范围添加到地图removeOverlay法移除覆盖范围。请注意，此方法不适用于InfoWindow。标注表示地图上的点。添加多段线多段线在地图上绘制为一系列直线段。

【07】覆盖物

地图覆盖物概述

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

地图API提供了如下几种覆盖物：

Overlay：覆盖物的抽象基类，所有的覆盖物均继承此类的方法。

Marker：标注表示地图上的点，可自定义标注的图标。

Label：表示地图上的文本标注，您可以自定义标注的文本内容。

Polyline：表示地图上的折线。

Polygon：表示地图上的多边形。多边形类似于闭合的折线，另外您也可以为其添加填充颜色。

Circle: 表示地图上的圆。

InfoWindow：信息窗口也是一种特殊的覆盖物，它可以展示更为丰富的文字和多媒体信息。注意：同一时刻只能有一个信息窗口在地图上打开。

可以使用map.addOverlay方法向地图添加覆盖物，使用map.removeOverlay方法移除覆盖物，注意此方法不适用于InfoWindow。

标注

标注表示地图上的点。API提供了默认图标样式，您也可以通过Icon类来指定自定义图标。Marker的构造函数的参数为Point和 MarkerOptions（可选）。注意：当您使用自定义图标时，标注的地理坐标点将位于标注所用图标的中心位置，您可通过Icon的offset属性 修改标定位置。

下面的示例向地图中心点添加了一个标注，并使用默认的标注样式。

var map = new BMap.Map("container");var point = new BMap.Point(116.404, 39.915);    
map.centerAndZoom(point, 15);var marker = new BMap.Marker(point);        // 创建标注    
map.addOverlay(marker);                     // 将标注添加到地图中

定义标注图标

  1. varmap =newBMap.Map("container");
  2. varpoint =newBMap.Point(116.404,39.915);
  3. map.centerAndZoom(point,15);
  4. varmarker =newBMap.Marker(point);// 创建标注
  5. map.addOverlay(marker);// 将标注添加到地图中

通过Icon类可实现自定义标注的图标，下面示例通过参数MarkerOptions的icon属性进行设置，您也可以使用marker.setIcon()方法。

  1. varmap =newBMap.Map("container");
  2. varpoint =newBMap.Point(116.404,39.915);
  3. map.centerAndZoom(point,15);// 编写自定义函数，创建标注
  4. functionaddMarker(point,index){// 创建图标对象
  5. varmyIcon =newBMap.Icon("markers.png",newBMap.Size(23,25),{
  6. // 指定定位位置。
  7. // 当标注显示在地图上时，其所指向的地理位置距离图标左上
  8. // 角各偏移10像素和25像素。您可以看到在本例中该位置即是
  9. // 图标中央下端的尖角位置。
  10. offset:newBMap.Size(10,25),
  11. // 设置图片偏移。
  12. // 当您需要从一幅较大的图片中截取某部分作为标注图标时，您
  13. // 需要指定大图的偏移位置，此做法与css sprites技术类似。
  14. imageOffset:newBMap.Size(0,0-index *25)// 设置图片偏移
  15. });
  16. // 创建标注对象并添加到地图
  17. varmarker =newBMap.Marker(point,{icon:myIcon});
  18. map.addOverlay(marker);
  19. }
  20. // 随机向地图添加10个标注
  21. varbounds =map.getBounds();
  22. varlngSpan =bounds.maxX -bounds.minX;
  23. varlatSpan =bounds.maxY -bounds.minY;
  24. for(vari =0;i <10;i ++){
  25. varpoint =newBMap.Point(bounds.minX +lngSpan *(Math.random()*0.7+0.15),
  26. bounds.minY +latSpan *(Math.random()*0.7+0.15));
  27. addMarker(point,i);
  28. }

监听标注事件

事件方法与Map事件机制相同。可参考事件部分。

  1. marker.addEventListener("click",function(){
  2. alert("您点击了标注");
  3. });

可托拽的标注

marker的enableDragging和disableDragging方法可用来开启和关闭标注的拖拽功能。默认情况下标注不支持 拖拽，您需要调用marker.enableDragging()方法来开启拖拽功能。在标注开启拖拽功能后，您可以监听标注的dragend事件来捕获 拖拽后标注的最新位置。

  1. marker.enableDragging();
  2. marker.addEventListener("dragend",function(e){
  3. alert("当前位置："+e.point.lng +", "+e.point.lat);
  4. })

内存释放

在API 1.0版本中，如果您需要在地图中反复添加大量的标注，这可能会占用较多的内存资源。如果您的标注在移除后不再使用，可调用 Overlay.dispose()方法来释放内存。注意在1.0版本中，调用此方法后标注将不能再次添加到地图上。自1.1版本开始，您不在需要使用此 方法来释放内存资源，API会自动帮助您完成此工作。

例如，您可以在标注被移除后调用此方法：

  1. map.removeOverlay(marker);
  2. marker.dispose();// 1.1 版本不需要这样调用

信息窗口

信息窗口在地图上方的浮动显示HTML内容。信息窗口可直接在地图上的任意位置打开，也可以在标注对象上打开（此时信息窗口的坐标与标注的坐标一致）。 您可以使用InfoWindow来创建一个信息窗实例，注意同一时刻地图上只能有一个信息窗口处于打开状态。

  1. varopts ={
  2. width :250,// 信息窗口宽度
  3. height:100,// 信息窗口高度
  4. title :"Hello"// 信息窗口标题
  5. }
  6. varinfoWindow =newBMap.InfoWindow("World",opts);// 创建信息窗口对象
  7. map.openInfoWindow(infoWindow,map.getCenter());// 打开信息窗口
折线

Polyline表示地图上的折线覆盖物。它包含一组点，并将这些点连接起来形成折线。

添加折线

折线在地图上绘制为一系列直线段。可以自定义这些线段的颜色、粗细和透明度。颜色可以是十六进制数字形式（比如：#ff0000）或者是颜色关键字（比如：red）。

Polyline的绘制需要浏览器支持矢量绘制功能。在Internet Explorer中，地图使用VML绘制折线；在其他浏览器中使用SVG或者Canvas

以下代码段会在两点之间创建6像素宽的蓝色折线：

  1. varpolyline =newBMap.Polyline([
  2. newBMap.Point(116.399,39.910),
  3. newBMap.Point(116.405,39.920)
  4. ],
  5. {strokeColor:"blue",strokeWeight:6,strokeOpacity:0.5}
  6. );
  7. map.addOverlay(polyline);

自定义覆盖物

API自1.1版本起支持用户自定义覆盖物。

要创建自定义覆盖物，您需要做以下工作：

1.定义一个自定义覆盖物的构造函数，通过构造函数参数可以传递一些自由的变量。

2.设置自定义覆盖物对象的prototype属性为Overlay的实例，以便继承覆盖物基类。

3.实现initialize方法，当调用map.addOverlay方法时，API会调用此方法。

4.实现draw方法。

定义构造函数并继承Overlay

首先您需要定义自定义覆盖物的构造函数，在下面的示例中我们定义一个名为SquareOverlay的构造函数，它包含中心点和边长两个参数，用来在地图上创建一个方形覆盖物。

  1. // 定义自定义覆盖物的构造函数
  2. functionSquareOverlay(center,length,color){
  3. this._center =center;
  4. this._length =length;
  5. this._color =color;
  6. }
  7. // 继承API的BMap.Overlay
  8. SquareOverlay.prototype =newBMap.Overlay();

初始化自定义覆盖物

当调用map.addOverlay方法添加自定义覆盖物时，API会调用该对象的initialize方法用来初始化覆盖物，在初始化过程中需要创建覆盖物所需要的DOM元素，并添加到地图相应的容器中。

地图提供了若干容器供覆盖物展示，通过map.getPanes方法可以得到这些容器元素，它们包括：

floatPane

markerMouseTarget

floatShadow

labelPane

markerPane

mapPane

这些对象代表了不同的覆盖物容器元素，它们之间存在着覆盖关系，最上一层为floatPane，用于显示信息窗口内容，下面依次为标注点击区域层、信息窗口阴影层、文本标注层、标注层和矢量图形层。

我们自定义的方形覆盖物可以添加到任意图层上，这里我们选择添加到markerPane上，作为其一个子结点。

  1. // 实现初始化方法
  2. SquareOverlay.prototype.initialize =function(map){
  3. // 保存map对象实例
  4. this._map =map;
  5. // 创建div元素，作为自定义覆盖物的容器
  6. vardiv =document.createElement("div");
  7. div.style.position ="absolute";
  8. // 可以根据参数设置元素外观
  9. div.style.width =this._length +"px";
  10. div.style.height =this._length +"px";
  11. div.style.background =this._color;
  12. // 将div添加到覆盖物容器中
  13. map.getPanes().markerPane.appendChild(div);
  14. // 保存div实例
  15. this._div =div;
  16. // 需要将div元素作为方法的返回值，当调用该覆盖物的show、
  17. // hide方法，或者对覆盖物进行移除时，API都将操作此元素。
  18. returndiv;
  19. }

绘制覆盖物

到目前为止，我们仅仅把覆盖物添加到了地图上，但是并没有将它放置在正确的位置上。您需要在draw方法中设置覆盖物的位置，每当地图状态 发生变化（比如：位置移动、级别变化）时，API都会调用覆盖物的draw方法，用于重新计算覆盖物的位置。通过 map.pointToOverlayPixel方法可以将地理坐标转换到覆盖物的所需要的像素坐标。

  1. // 实现绘制方法
  2. SquareOverlay.prototype.draw =function(){
  3. // 根据地理坐标转换为像素坐标，并设置给容器
  4. varposition =this._map.pointToOverlayPixel(this._center);
  5. this._div.style.left =position.x -this._length /2+"px";
  6. this._div.style.top =position.y -this._length /2+"px";
  7. }

移除覆盖物

当调用map.removeOverlay或者map.clearOverlays方法时，API会自动将initialize方法返回的DOM元素进行移除。

显示和隐藏覆盖物

自定义覆盖物会自动继承Overlay的show和hide方法，方法会修改由initialize方法返回的DOM元素的style.display属性。如果自定义覆盖物元素较为复杂，您也可以自己实现show和hide方法。

  1. // 实现显示方法
  2. SquareOverlay.prototype.show =function(){
  3. if(this._div){
  4. this._div.style.display ="";
  5. }
  6. }
  7. // 实现隐藏方法
  8. SquareOverlay.prototype.hide =function(){
  9. if(this._div){
  10. this._div.style.display ="none";
  11. }
  12. }

自定义其他方法 通过构造函数的prototype属性，您可以添加任何自定义的方法，比如下面这个方法每调用一次就能改变覆盖物的显示状态：

  1. // 添加自定义方法
  2. SquareOverlay.prototype.toggle =function(){
  3. if(this._div){
  4. if(this._div.style.display ==""){
  5. this.hide();
  6. }
  7. else{
  8. this.show();
  9. }
  10. }
  11. }

添加覆盖物

您现在已经完成了一个完整的自定义覆盖物的编写，可以添加到地图上了。

  1. // 初始化地图
  2. varmap =newBMap.Map("container");
  3. varpoint =newBMap.Point(116.404,39.915);
  4. map.centerAndZoom(point,15);
  5. // 添加自定义覆盖物
  6. varmySquare =newSquareOverlay(map.getCenter(),100,"red");
  7. map.addOverlay(mySquare);
来自为知笔记(Wiz)

标签：#构造函数#地图标注#百度地图api#地图api | 浏览：473 | 发布日期：

免责声明：文章转载自《【07】覆盖物（百度地图覆盖物笔记）》仅用于学习参考。如对内容有疑问，请及时联系本站处理。

上篇API网关 动态路由、监控、授权、安全、调度Android打造带透明圆弧的ImageView下篇

宿迁高防，2C2G15M，22元/月；香港BGP，2C5G5M，25元/月 雨云优惠码：MjYwNzM=

相关文章

JavaScript中创建自定义对象

JavaScript高级培训－自定义对象 一，概述 在Java语言中，我们可以定义自己的类，并根据这些类创建对象来使用，在Javascript中，我们也可以定义自己的类，例如定义User类、Hashtable类等等。 目前在Javascript中，已经存在一些标准的类，例如Date、Array、RegExp、String、Math、Number等等，这为...

C++的隐式类型转换

C++是一种复杂的语言，其中有许多“好玩”的特性，学习C++的过程就像在海边捡一颗颗石头，只要坚持不懈，也许一颗颗小石头也能建起你自己小小的城堡。 废话完后，讲讲自己捡到的石头：隐式类型转换  学习出处：《Effective C++》 lostmouse大人翻译 class TestInt{ public:    int GetData()const{...

ArcGIS for Android地图控件的5大常见操作

目录 获取/设置比例尺、分辨率、中心点、范围 关于地图显示不出来的问题 平移 缩放至指定的分辨率/比例尺和连续放大n倍 设置地图最大最小缩放级别 旋转地图 其它常用方法 手势操作 关于地图显示不出来的问题 其他常用方法 GIS的开发中，什么时候都少不了地图操作。ArcGIS for Android中，地图组件就是MapView，MapVie...

提高程序运行效率的10个简单方法(转)

对于每一个程序员来说，程序的运行效率都是一个值得重视，并为之付出努力的问题。但是程序性能的优化也是一门复杂的学问，需要很多的知识，然而并不是每个程序员都具备这样的知识，而且论述如何优化程序提高程序运行效率的书籍也很少。但是这并不等于我们可以忽略程序的运行效率，下面就介绍一下本人积累的一些简单实用的提高程序运行效率的方法，希望对大家有所帮助。 注：以C/C+...

【转】C++中了类继承和调用父类的构造函数方法

构造方法用来初始化类的对象，与父类的其它成员不同，它不能被子类继承（子类可以继承父类所有的成员变量和成员方法，但不继承父类的构造方法）。因此，在创建子类对象时，为了初始化从父类继承来的数据成员，系统需要调用其父类的构造方法。     如果没有显式的构造函数，编译器会给一个默认的构造函数，并且该默认的构造函数仅仅在没有显式地声明构造函数情况下创建。 构造原则...

Qt C++中的关键字explicit——防止隐式转换（也就是Java里的装箱），必须写清楚

最近在复习QT，准备做项目了，QT Creator 默认生成的代码 explicit Dialog(QWidget *parent = 0)中，有这么一个关键字explicit，用来修饰构造函数。以前在Windows下写程序的时候，基本上没有碰到这个关键字，那么这个关键字是做什么用的呢？ 关键字 explicit 可以禁止“单参数构造函数”被用于自动类型转...

最新文章

随机推荐

思享工具箱导航