百度地图API开发指南（二）

百度地图API开发指南（二）

作者:幽鸿   

控件位置偏移

除了指定停靠位置外，还可以通过偏移量来指示控件距离地图边界有多少像素。如果两个控件的停靠位置相同，那么控件可能会重叠在一起，这时就可以通过偏移值使二者分开显示。

1. var opts = {offset: new BMap.Size(150, 5)} map.addControl(new BMap.ScaleControl(opts)); 修改控件配置 

地图API的控件提供了丰富的配置参数，您可参考API文档来修改它们以便得到符合要求的控件外观。例如，NavigationControl控件就提供了如下类型：

BMAP_NAVIGATION_CONTROL_LARGE 表示显示完整的平移缩放控件。

BMAP_NAVIGATION_CONTROL_SMALL 表示显示小型的平移缩放控件。

BMAP_NAVIGATION_CONTROL_PAN 表示只显示控件的平移部分功能。

BMAP_NAVIGATION_CONTROL_ZOOM 表示只显示控件的缩放部分功能。

下图从左向右依次展示了上述不同类型的控件外观：

下面的示例将调整平移缩放地图控件的外观。

var opts = {type: BMAP_NAVIGATION_CONTROL_SMALL} map.addControl(new BMap.NavigationControl(opts)); 自定义控件

百度地图API允许您通过继承Control来创建自定义地图控件。

要创建可用的自定义控件，您需要做以下工作：

定义一个自定义控件的构造函数。

设置自定义控件构造函数的prototype属性为Control的实例，以便继承控件基类。

实现initialize()方法并提供defaultAnchor和defaultOffset属性。

定义构造函数并继承Control

首先您需要定义自定义控件的构造函数，并在构造函数中提供defaultAnchor和defaultOffset两个属性，以便API正确定位控件位置，接着让其继承于Control。在下面的示例中我们定义一个名为ZoomControl的控件，每一次点击将地图放大两个级别。它具有文本标识，而不是平移缩放控件中使用的图形图标。

// 定义一个控件类，即function function ZoomControl(){   
// 设置默认停靠位置和偏移量 this.defaultAnchor = BMAP_ANCHOR_TOP_LEFT;   
this.defaultOffset = new BMap.Size(10, 10); }   
// 通过JavaScript的prototype属性继承于BMap.Control ZoomControl.prototype = new BMap.Control();  
 初始化自定义控件 

当调用map.addControl()方法添加自定义控件时，API会调用该对象的initialize()方法用来初始化控件，您需要实现此方法并在其中创建控件所需的DOM元素，并添加DOM事件。所有自定义控件中的DOM元素最终都应该添加到地图容器（即地图所在的DOM元素）中去，地图容器可以通过map.getContainer()方法获得。最后initialize()方法需要返回控件容器的DOM元素。

// 自定义控件必须实现initialize方法，并且将控件的DOM元素返回  
 // 在本方法中创建个div元素作为控件的容器，并将其添加到地图容器中 
ZoomControl.prototype.initialize = function(map){   
// 创建一个DOM元素 var div = document.createElement("div");   
// 添加文字说明 div.appendChild(document.createTextNode("放大2级"));  
 // 设置样式 div.style.cursor = "pointer"; 
div.style.border = "1px solid gray"; 
div.style.backgroundColor = "white";   
// 绑定事件，点击一次放大两级 div.onclick = function(e){ map.zoomTo(map.getZoom() + 2); }   
// 添加DOM元素到地图中 map.getContainer().appendChild(div);   
// 将DOM元素返回 return div; } 添加自定义控件 

添加自定义控件与添加其他控件方法一致，调用map.addControl()方法即可。

// 创建控件实例 var myZoomCtrl = new ZoomControl(); // 添加到地图当中 map.addControl(myZoomCtrl); 覆盖物 地图覆盖物概述

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

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

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

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); } 监听标注事件 

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

1. marker.addEventListener("click", function(){ alert("您点击了标注"); }); 可托拽的标注 

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

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

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

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

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

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

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

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); 自定义覆盖物 

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

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

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

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

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

实现draw方法。