bigemap地图下载器 百度离线地图API接口文档及接口调用实例——添加自定义覆盖物

 

 

自定义覆盖物

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

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

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

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

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

4.实现draw方法。

定义构造函数并继承Overlay

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

// 定义自定义覆盖物的构造函数 

function SquareOverlay(center, length, color){   

 this._center = center;   

 this._length = length;   

 this._color = color;   

}   

// 继承API的BMap.Overlay   

SquareOverlay.prototype = new BMap.Overlay();

初始化自定义覆盖物

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

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

floatPane

markerMouseTarget

floatShadow

labelPane

markerPane

mapPane

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

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

// 实现初始化方法 

SquareOverlay.prototype.initialize = function(map){   

// 保存map对象实例  

 this._map = map;       

 // 创建div元素，作为自定义覆盖物的容器  

 var div = document.createElement("div");   

 div.style.position = "absolute";       

 // 可以根据参数设置元素外观  

 div.style.width = this