Files
notes_estom/HTML/html5/baidu-map.md
2022-04-18 23:03:54 +08:00

9.2 KiB
Raw Blame History

如何使用

HTML 页面

  • 引入百度地图提供的JS文件
<script src="http://api.map.baidu.com/api?v=2.0&ak=HbUVYMUg6PwbOnXkztdgSQlQ"></script>
  • 定义容器元素<div></div>
<!doctype html>
<html lang="en">
 <head>
  <meta charset="UTF-8">
  <title>百度地图如何使用</title>
  <style type="text/css">
	body, html,#allmap {
		width: 100%;
		height: 100%;
		overflow: hidden;
		margin:0;
		font-family:"微软雅黑";
	}
  </style>
  <!--
	  引入百度地图提供的JS文件
	  * 是在线提供的JS文件 - 必须可以联网
	  http://api.map.baidu.com/api?v=2.0&ak=您的密钥
	  * v=2.0 - 使用的百度地图的版本
	  * ak=您的密钥 - 传递当前应用的秘钥
	    * 只有秘钥正确,正常地使用百度地图的功能
  -->
  <script src="http://api.map.baidu.com/api?v=2.0&ak=HbUVYMUg6PwbOnXkztdgSQlQ"></script>
 </head>
 <body>
  <!-- 定义一个容器元素 - 用于显示百度地图 -->
  <div id="allmap"></div>
 </body>
</html>

JavaScript 逻辑

  • 创建百度地图对象
var map = new BMap.Map(容器元素id);
  • 初始化百度地图
map.centerAndZoom(中心点坐标,显示级别)

如下述示例代码:

/*
	1. 通过Map()构造函数,创建百度地图对象
		var map = new BMap.Map(容器元素id属性值);
*/
var map = new BMap.Map("allmap");
/*
	2. (必要)初始化百度地图 - 设置中心点和显示级别
		map.centerAndZoom(center,zoom)
		* center - 设置百度地图当前的中心点坐标
			* Point类型,zoom参数必须设置
			* String类型,zoom参数可有可无
				* 如果不设置zoom,自动匹配最佳显示级别
		* zoom - 设置百度地图当前的显示级别
			* 一般情况下,值范围为 3-19
			* 高清地图(移动端),值范围为 3-18
*/
map.centerAndZoom("北京",12);

核心类

Map类

构造器

构造函数 参数 说明
Map(container) container:页面容器元素id 创建地图实例对象

配置方法

方法名称 参数 说明
enableScrollWheelZoom() 开启鼠标滚轮放大或缩小地图的显示级别
disableScrollWheelZoom() 禁用鼠标滚轮功能
enableDragging() 启用鼠标拖拽功能
disableDragging() 禁用鼠标拖拽功能

地图状态方法

方法名称 参数 说明
getCenter() 返回地图当前中心点(Point类型)
getZoom() 返回地图当前缩放级别(Number类型)

修改地图状态方法

方法名称 参数 说明
centerAndZoom(center,zoom) center:设置地图的中心点坐标;zoom:设置地图的显示级别 初始化地图中心点和级别
setCenter(center) center:设置地图的中心点坐标 设置地图中心点(Point
setCurrentCity(city) city:设置地图城市 设置地图城市
setZoom(zoom) zoom:设置地图的显示级别 设置显示级别

控件方法

方法名称 参数 说明
addControl(control) 将控件添加到地图
removeControl(control) 从地图中移除控件

覆盖物方法

方法名称 参数 说明
addOverlay(overlay) 将覆盖物添加到地图中
removeOverlay(overlay) 从地图中移除覆盖物
openInfoWindow(InfoWindow, Point) InfoWindow:设置信息窗口;Point:在指定点打开 设置信息窗口

控件类

ScaleControl类

表示比例尺控件。

构造器

构造函数 参数 说明
ScaleControl(ScaleControlOptions) - 创建地图比例尺对象

ScaleControlOptions类

表示ScaleControl构造函数的可选参数。

选项

  • anchor:设置当前控件显示的位置。
    • BMAP_ANCHOR_TOP_LEFT:左上角
    • BMAP_ANCHOR_BOTTOM_LEFT:左下角
    • BMAP_ANCHOR_TOP_RIGHT:右上角
    • BMAP_ANCHOR_BOTTOM_RIGHT:右下角

NavigationControl类

表示地图的平移缩放控件。

构造器

构造函数 参数 说明
NavigationControl(NavigationControlOptions) - 创建地图平移缩放对象

MapTypeControl类

负责切换地图类型的控件。

构造器

构造函数 参数 说明
MapTypeControl(MapTypeControlOptions) - 创建地图类型对象

OverviewMapControl类

表示缩略地图控件。

构造器

构造函数 参数 说明
OverviewMapControl(OverviewMapControlOptions) - 创建缩略地图对象
<!doctype html>
<html lang="en">
 <head>
  <meta charset="UTF-8">
  <title>百度地图的控件类</title>
  <style type="text/css">
	body, html,#allmap {
		width: 100%;
		height: 100%;
		overflow: hidden;
		margin:0;
		font-family:"微软雅黑";
	}
  </style>
  <script src="http://api.map.baidu.com/api?v=2.0&ak=HbUVYMUg6PwbOnXkztdgSQlQ"></script>
 </head>
 <body>
  <div id="allmap"></div>
  <script>
	// 1. 创建地图对象
	var map = new BMap.Map("allmap");
	// 2. 初始化地图
	map.centerAndZoom("北京",13);
	map.enableScrollWheelZoom();
	/*
	   3. 添加比例尺控件
	      * 创建比例尺控件对象
		  * 将比例尺控件添加到地图中
	 */
	var scale = new BMap.ScaleControl({
		anchor: BMAP_ANCHOR_TOP_RIGHT
	});
	map.addControl(scale);
	/*
	   4. 添加平移缩放控件
	      * 创建平移缩放控件对象
		  * 将平移缩放控件添加到地图中
	 */
	var nav = new BMap.NavigationControl({
		anchor: BMAP_ANCHOR_TOP_RIGHT
	});
	map.addControl(nav);
	// 5. 添加地图类型切换控件
	var type = new BMap.MapTypeControl({
		anchor: BMAP_ANCHOR_TOP_LEFT
	});
	map.addControl(type);
	// 6. 添加缩略地图控件
	var overview = new BMap.OverviewMapControl({
		isOpen : true//表示是否自动打开
	});
	map.addControl(overview);
  </script>
 </body>
</html>

覆盖物类

Marker类

表示地图上一个图像标注。

构造器

构造函数 参数 说明
Marker(point) - 创建标注对象

InfoWindow类

表示地图上包含信息的窗口。

构造器

构造函数 参数 说明
InfoWindow(content) content:设置当前点的地址信息内容 创建信息的窗口对象

方法

方法名称 参数 说明
setWidth(width) 设置信息窗口的宽度
setHeight(height) 设置信息窗口的高度
setTitle(title) 设置信息窗口的标题
<!doctype html>
<html lang="en">
 <head>
  <meta charset="UTF-8">

  <title>为百度地图进行标注</title>
  <style type="text/css">
	body, html,#allmap {
		width: 100%;
		height: 100%;
		overflow: hidden;
		margin:0;
		font-family:"微软雅黑";
	}
  </style>
  <script src="http://api.map.baidu.com/api?v=2.0&ak=HbUVYMUg6PwbOnXkztdgSQlQ"></script>
 </head>
 <body>
  <div id="allmap"></div>
  <script>
	var map = new BMap.Map("allmap");
	var point = new BMap.Point(116.404, 39.915);
	map.centerAndZoom(point, 15);
	/*
	   如何进行标注
	   * 创建标注对象
	   * 将标注添加到地图中
	 */
	var marker = new BMap.Marker(point);
	map.addOverlay(marker);
	marker.setAnimation(BMAP_ANIMATION_BOUNCE);
  </script>
 </body>
</html>

服务类

Geocoder类

用于获取用户的地址解析。

构造器

构造函数 参数 说明
Geocoder() content:设置当前点的地址信息内容 创建地址解析对象

方法

方法名称 参数 说明
getPoint(address,callback,city) address:要解析的地址内容;callback:回调函数(解析address地址成功的话,回调函数具有一个形参);city:当前地址所在的城市名称 对指定的地址进行解析
<!doctype html>
<html lang="en">
 <head>
  <meta charset="UTF-8">
  <title>百度地图案例</title>
  <style type="text/css">
	body, html,#allmap {
		width: 100%;
		height: 100%;
		overflow: hidden;
		margin:0;
		font-family:"微软雅黑";
	}
  </style>
  <script src="http://api.map.baidu.com/api?v=2.0&ak=HbUVYMUg6PwbOnXkztdgSQlQ"></script>
 </head>
 <body>
  <div id="allmap"></div>
  <script>
	// 1. 创建地图对象
	var map = new BMap.Map("allmap");
	// 2. 初始化地图
	//map.centerAndZoom("北京",13);
	// 3. 启用鼠标的滚轮功能
	map.enableScrollWheelZoom();
	/*
	   4. 根据给定的地址获取Point的经度和纬度
	      var geocoder = new BMap.Geocoder();
		  geocoder.getPoint(address,function(point){},city);
	 */
	var geocoder = new BMap.Geocoder();
	geocoder.getPoint("北京市海淀区万寿路西街2号",function(point){
		// 5. 根据Point进行标注
		var marker = new BMap.Marker(point);
		map.addOverlay(marker);
		// 6. 重新设置中心点位置
		map.centerAndZoom(point,16);
		// 7. 设置信息窗口
		var opts = {
			width : 200,
			height: 100,
			title : "文博大厦"
		}
		var info = new BMap.InfoWindow("地址:北京市海淀区万寿路西街2号",opts);
		marker.addEventListener("click",function(){
			map.openInfoWindow(info,point);
		});
	},"北京");
  </script>
 </body>
</html>