百度地图API--控件

百度地图API--控件


这里介绍一下百度题图的空间，控件主要负责地图交互。百度地图API中提供了丰富的控件，您还可以通过Control类来实现自定义控件。


地图API中提供的控件有：


[html] view plaincopy
Ø Control：控件的抽象基类，所有控件均继承此类的方法、属性。通过此类您可实现自定义控件。  
Ø NavigationControl：地图平移缩放控件，PC端默认位于地图左上方，它包含控制地图的平移和缩放的功能。移动端提供缩放控件，默认位于地图右下方。  
Ø OverviewMapControl：缩略地图控件，默认位于地图右下方，是一个可折叠的缩略地图。  
Ø ScaleControl：比例尺控件，默认位于地图左下方，显示地图的比例关系。  
Ø MapTypeControl：地图类型控件，默认位于地图右上方。  
Ø CopyrightControl：版权控件，默认位于地图左下方。  
Ø GeolocationControl：定位控件，针对移动端开发，默认位于地图左下方。  
可以使用Map.addControl()方法向地图添加控件。在此之前地图需要进行初始化。例如，要将标准地图控件添加到地图中，可在代码中添加如下内容：


[html] view plaincopy
var map = new BMap.Map("container"); //  
var point = new BMap.Point(116.404, 39.915); // 创建一个点  
map.centerAndZoom(point, 15);  
map.addControl(new BMap.NavigationControl());// 地图平移缩放控件  
可以向地图添加多个控件。在本例中我们向地图添加一个平移缩放控件、一个比例尺控件和一个缩略图控件。在地图中添加控件后，它们即刻生效。


[html] view plaincopy
var map = new BMap.Map("container"); //  
 var point = new BMap.Point(116.404, 39.915); // 创建一个点  
 map.centerAndZoom(point, 15);  
 map.addControl(new BMap.NavigationControl());// 地图平移缩放控件  
 map.addControl(new BMap.ScaleControl()); // 比例尺控件  
 map.addControl(new BMap.OverviewMapControl()); // 缩略地图控件  
 map.addControl(new BMap.MapTypeControl()); // 地图类型控件  
 var cr = new BMap.CopyrightControl({  
               anchor :BMAP_ANCHOR_TOP_LEFT,  
               offset : createSize(650, 5)  
        //设置版权控件位置  
        });  
 var bs = map.getBounds(); //返回地图可视区域  
 cr.addCopyright({  
        id : 1,  
        content : "<a href='#'style='font-size:20px;background:yellow'>自定义版权控件</a>",  
        bounds : bs  
 }); //Copyright(id,content,bounds)类作为CopyrightControl.addCopyright()方法的参数  
 map.addControl(cr); //添加版权控件  
map.setCurrentCity("北京"); // 仅当设置城市信息时，MapTypeControl的切换到三维视图功能才能可用  
初始化控件时，可提供一个可选参数，其中的anchor和offset属性共同控制控件在地图上的位置。


anchor表示控件的停靠位置，即控件停靠在地图的哪个角。当地图尺寸发生变化时，控件会根据停靠位置的不同来调整自己的位置。anchor允许的值为：


[html] view plaincopy
Ø BMAP_ANCHOR_TOP_LEFT表示控件定位于地图的左上角。  
Ø BMAP_ANCHOR_TOP_RIGHT表示控件定位于地图的右上角。  
Ø BMAP_ANCHOR_BOTTOM_LEFT表示控件定位于地图的左下角。  
Ø BMAP_ANCHOR_BOTTOM_RIGHT表示控件定位于地图的右下角。  
除了指定停靠位置外，还可以通过偏移量来指示控件距离地图边界有多少像素。如果两个控件的停靠位置相同，那么控件可能会重叠在一起，这时就可以通过偏移值使二者分开显示。


本示例将比例尺放置在地图的左下角，由于API默认会有版权信息，因此需要添加一些偏移值以防止控件重叠。


[html] view plaincopy
var offset = {  
               offset : new BMap.Size(150, 5)  
        }; // 偏移  
        map.addControl(newBMap.NavigationControl(offset)); // 添加一个平移缩放空间，位置是偏移后的位置  
地图API的控件提供了丰富的配置参数，您可参考API文档来修改它们以便得到符合要求的控件外观。例如，NavigationControl控件就提供了如下类型：


[html] view plaincopy
Ø BMAP_NAVIGATION_CONTROL_LARGE表示显示完整的平移缩放控件。  
Ø BMAP_NAVIGATION_CONTROL_SMALL表示显示小型的平移缩放控件。  
Ø BMAP_NAVIGATION_CONTROL_PAN表示只显示控件的平移部分功能。  
Ø BMAP_NAVIGATION_CONTROL_ZOOM表示只显示控件的缩放部分功能。  
下图从左向右依次展示了上述不同类型的控件外观：




上图前4个为PC端平移缩放控件样式，最后一个为移动端缩放控件样式。


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


[html] view plaincopy
var offset1 = {  
         offset : new BMap.Size(250, 5),  
         type :BMAP_NAVIGATION_CONTROL_LARGE  
  }; // 偏移  
  map.addControl(new BMap.NavigationControl(offset1));  
  
  var offset2 = {  
         offset : new BMap.Size(350, 5),  
         type :BMAP_NAVIGATION_CONTROL_SMALL  
  };  
  map.addControl(new BMap.NavigationControl(offset2));  
  var offset3 = {  
         offset : new BMap.Size(450, 5),  
         type : BMAP_NAVIGATION_CONTROL_PAN  
  };  
  map.addControl(new BMap.NavigationControl(offset3));  
  var offset4 = {  
         offset : new BMap.Size(550, 5),  
         type :BMAP_NAVIGATION_CONTROL_ZOOM  
  }; // 偏移  
  map.addControl(new BMap.NavigationControl(offset4));  
百度地图API允许您通过继承Control来创建自定义地图控件。要创建可用的自定义控件，需要做以下工作：


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


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


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


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


[html] view plaincopy
//定义一个控件类，即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元素。


[html] view plaincopy
// 自定义控件必须实现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 = "red";  
             // 绑定事件，点击一次放大两级   
             div.onclick = function(e) {  
                    map.zoomTo(map.getZoom() +2);// 放大两倍  
             }  
             // 添加DOM元素到地图中  
             map.getContainer().appendChild(div);  
             // 将DOM元素返回  
             return div;  
      }  
添加自定义控件与添加其他控件方法一致，调用map.addControl()方法即可。


[html] view plaincopy
function load() {  
       // BMap是百度地图API的命名空间，所有的类都在这里面  
       var map = new BMap.Map("container"); //  
       var point = new BMap.Point(116.404, 39.915); // 创建一个点  
       map.centerAndZoom(point, 15);  
       // 创建控件实例   
       var myZoomCtrl = new ZoomControl();  
       // 添加到地图当中   
       map.addControl(myZoomCtrl);  
}  
访问成功后我们看到左上角有一个红色的区域，点击后地图会放大两倍。






文档代码自己亲测，学习参考百度开发者文档，代码有改变，欢迎留言指正~