Baidu Map API
核心类Map
构造函数 | 描述 |
---|---|
Map(container: String | HTMLElement, opts: MapOptions) | 在指定的容器内创建地图实例,之后需要调用Map.centerAndZoom()方法对地图进行初始化。未进行初始化的地图将不能进行任何操作 |
1 | var map = new BMap.Map("MAP"); |
方法 | 返回值 | 描述 |
---|---|---|
enableDragging() | none | 启用地图拖拽,默认启用 |
enableScrollWheelZoom() | none | 启用滚轮放大缩小,默认禁用 |
enableDoubleClickZoom() | none | 启用双击放大,默认启用 |
enableKeyboard() | none | 启用键盘操作,默认禁用。 |
enablePinchToZoom() | none | 启用双指操作缩放,默认启用 |
enableAutoResize() | none | 启用自动适应容器尺寸变化,默认启用 |
setMinZoom(zoom: Number) | none | 设置地图允许的最小级别。取值不得小于地图类型所允许的最小级别 |
getCenter() | Point | 返回地图当前中心点 |
getDistance(start: Point, end: Point) | Number | 返回两点之间的距离,单位是米 |
centerAndZoom(center: Point, zoom: Number) | none | 设初始化地图。 如果center类型为Point时,zoom必须赋值,范围3-19级,若调用高清底图(针对移动端开发)时,zoom可赋值范围为3-18级。如果center类型为字符串时,比如“北京”,zoom可以忽略,地图将自动根据center适配最佳zoom级别 |
panTo(center: Point, opts: PanOptions) | none | 将地图的中心点更改为给定的点。如果该点在当前的地图视图中已经可见,则会以平滑动画的方式移动到中心点位置。可以通过配置强制移动过程不使用动画效果 |
setCenter(center: Point | String) | none | 设置地图中心点。center除了可以为坐标点以外,还支持城市名 |
getZoom() | Number | 返回地图当前缩放级别 |
setZoom(zoom: Number) | none | 将视图切换到指定的缩放等级,中心点坐标不变。注意:当有信息窗口在地图上打开时,地图缩放将保证信息窗口所在的坐标位置不动 |
addOverlay(overlay: Overlay) | none | 将覆盖物添加到地图中,一个覆盖物实例只能向地图中添加一次 |
clearOverlays() | none | 清除地图上所有覆盖物 |
控件类
Control基类
initialize(map: Map) | HTMLElement | 抽象方法。调用Map.addControl()方法添加控件时将调用此方法,从而实现该控件的初始化。自定义控件时需要实现此方法,并将元素的DOM元素在该方法中返回。DOM元素需要添加到地图的容器中,使用map.getContainer()方法可获得地图容器元素 |
---|---|---|
setAnchor(anchor: ControlAnchor) | none | 设置控件停靠的位置 |
getAnchor() | ControlAnchor | 返回控件停靠的位置 |
setOffset(offset: Size) | none | 设置控件停靠的偏移量 |
getOffset() | Size | 返回控件停靠的偏移量 |
show() | none | 显示控件 |
hide() | none | 隐藏控件 |
isVisible() | Boolean | 判断控件的可见性 |
ControlAnchor: 此常量表示控件的定位。
常量 | 描述 |
---|---|
BMAP_ANCHOR_TOP_LEFT | 控件将定位到地图的左上角 |
BMAP_ANCHOR_TOP_RIGHT | 控件将定位到地图的右上角 |
BMAP_ANCHOR_BOTTOM_LEFT | 控件将定位到地图的左下角 |
BMAP_ANCHOR_BOTTOM_RIGHT | 控件将定位到地图的右下角 |
- NavigationControl
- 此类表示地图的平移缩放控件,可以对地图进行上下左右四个方向的平移和缩放操作。
- GeolocationControl
- 此类是负责进行地图定位的控件,使用html5浏览器定位功能,此类继承Control所有功能。
- OverviewMapControl
- 此类表示缩略地图控件。
- ScaleControl
- 此类表示比例尺控件。
- CopyrightControl
- 此类表示版权控件,您可以在地图上添加自己的版权信息。每一个版权信息需要包含如下内容:版权的唯一标识、版权内容和其适用的区域范围。
覆盖物类
Marker:此类表示地图上一个图像标注。
构造函数 | 描述 |
---|---|
Marker(point: Point, opts: MarkerOptions) | 创建一个图像标注实例。point参数指定了图像标注所在的地理位置 |
1 | markers = new BMap.Marker(new BMap.Point(118.93015,32.1091),{"title":'Point'}); |
Icon此类表示标注覆盖物所使用的图标。
构造函数 | 描述 |
---|---|
Icon(url: String, size: Size, opts: IconOptions) | 以给定的图像地址和大小创建图标对象实例 |
Label此类表示地图上的文本标注。
构造函数 | 描述 |
---|---|
Label(content: String, opts: LabelOptions) | 创建一个文本标注实例。point参数指定了文本标注所在的地理位置 |
1 | label = new BMap.Label("", {offset: new BMap.Size(-20, -20)}); |
Author: Mrli
Link: https://nymrli.top/2018/12/21/BaiduMap-API/
Copyright: All articles in this blog are licensed under CC BY-NC-SA 3.0 unless stating additionally.