百度地图API-覆盖物

时间 2019-11-10

标签百度地图 api 覆盖物繁體版

原文原文链接

这两天一直在研究百度地图开放平台的各类好玩的东西，闲暇之余本身动手体验了一番，果真是妙不可言，并且还能够自定义理想中的地图，不得不说，百度地图的开放平台为咱们的应用提供了不少的便利，以前咱们已经学习了地图的基础应用和相关的控件的使用，今天，咱们继续深刻学习，百度地图API给咱们提供的覆盖物。javascript

1、地图覆盖物概述：css

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

地图API提供了以下几种覆盖物：浏览器

Overlay：覆盖物的抽象基类，全部的覆盖物均继承此类的方法。
Marker：标注表示地图上的点，可自定义标注的图标。
Label：表示地图上的文本标注，您能够自定义标注的文本内容。
Polyline：表示地图上的折线。
Polygon：表示地图上的多边形。多边形相似于闭合的折线，另外您也能够为其添加填充颜色。
Circle: 表示地图上的圆。
InfoWindow：信息窗口也是一种特殊的覆盖物，它能够展现更为丰富的文字和多媒体信息。注意：同一时刻只能有一个信息窗口在地图上打开。

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

2、标注：dom

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

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

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);                     // 将标注添加到地图中

3、定义标注图标学习

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

var map = new BMap.Map("container");    
var point = new BMap.Point(116.404, 39.915);    
map.centerAndZoom(point, 15);  // 编写自定义函数，建立标注   
function addMarker(point, index){  // 建立图标对象   
var myIcon = new BMap.Icon("markers.png", new BMap.Size(23, 25), {    
// 指定定位位置。   
// 当标注显示在地图上时，其所指向的地理位置距离图标左上    
// 角各偏移10像素和25像素。您能够看到在本例中该位置便是   
   // 图标中央下端的尖角位置。    
   offset: new BMap.Size(10, 25),    
   // 设置图片偏移。   
   // 当您须要从一幅较大的图片中截取某部分做为标注图标时，您   
   // 须要指定大图的偏移位置，此作法与css sprites技术相似。    
   imageOffset: new BMap.Size(0, 0 - index * 25)   // 设置图片偏移    
 });      
// 建立标注对象并添加到地图   
 var marker = new BMap.Marker(point, {icon: myIcon});    
 map.addOverlay(marker);    
}    
// 随机向地图添加10个标注    
var bounds = map.getBounds();    
var lngSpan = bounds.maxX - bounds.minX;    
var latSpan = bounds.maxY - bounds.minY;    
for (var i = 0; i < 10; i ++) {    
 var point = new BMap.Point(bounds.minX + lngSpan * (Math.random() * 0.7 + 0.15),    
                            bounds.minY + latSpan * (Math.random() * 0.7 + 0.15));    
 addMarker(point, i);    
}

4、监听标注事件

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

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

5、可托拽的标注

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

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

6、内存释放

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

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

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

7、信息窗口

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

var opts = {    
 width : 250,     // 信息窗口宽度    
 height: 100,     // 信息窗口高度    
 title : "Hello"  // 信息窗口标题   
}    
var infoWindow = new BMap.InfoWindow("World", opts);  // 建立信息窗口对象    
map.openInfoWindow(infoWindow, map.getCenter());      // 打开信息窗口

8、折线

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

添加折线

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

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

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

var polyline = new BMap.Polyline([    
   new BMap.Point(116.399, 39.910),    
   new BMap.Point(116.405, 39.920)    
 ],    
 {strokeColor:"blue", strokeWeight:6, strokeOpacity:0.5}    
);    
map.addOverlay(polyline);

9、自定义覆盖物

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._length + "px";    
 div.style.height = this._length + "px";    
 div.style.background = this._color;      
// 将div添加到覆盖物容器中   
 map.getPanes().markerPane.appendChild(div);      
// 保存div实例   
 this._div = div;      
// 须要将div元素做为方法的返回值，当调用该覆盖物的show、   
// hide方法，或者对覆盖物进行移除时，API都将操做此元素。   
 return div;    
}

绘制覆盖物

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

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

移除覆盖物

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

显示和隐藏覆盖物

自定义覆盖物会自动继承Overlay的show和hide方法，方法会修改由initialize方法返回的DOM元素的style.display属性。若是自定义覆盖物元素较为复杂，您也能够本身实现show和hide方法。

// 实现显示方法    
SquareOverlay.prototype.show = function(){    
 if (this._div){    
   this._div.style.display = "";    
 }    
}      
// 实现隐藏方法  
SquareOverlay.prototype.hide = function(){    
 if (this._div){    
   this._div.style.display = "none";    
 }    
}

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

// 添加自定义方法   
SquareOverlay.prototype.toggle = function(){    
 if (this._div){    
   if (this._div.style.display == ""){    
     this.hide();    
   }    
   else {    
     this.show();    
   }    
 }    
}

添加覆盖物

您如今已经完成了一个完整的自定义覆盖物的编写，能够添加到地图上了。

// 初始化地图  
var map = new BMap.Map("container");    
var point = new BMap.Point(116.404, 39.915);    
map.centerAndZoom(point, 15);    
// 添加自定义覆盖物   
var mySquare = new SquareOverlay(map.getCenter(), 100, "red");    
map.addOverlay(mySquare);

好啦，关于百度地图覆盖物的相关知识咱们已经学习的差很少啦，但学以至用，理论和实践相结合，勤学勤练才是提高自身技能的惟一方法，小伙伴们，加油吧！