出自百度地图API

跳转到: 导航 , 搜索
核心类 基础类 控件类 覆盖物类 地图类型类 地图图层类 服务类

map MapOptions

此类是地图API的map类,用来实例化一个地图。

目录

构造函数

构造函数描述
Map(container:String|HTMLElement[, opts:MapOptions]) 在指定的容器内创建地图实例,之后需要调用Map.centerAndZoom()方法对地图进行初始化。未进行初始化的地图将不能进行任何操作。

配置方法

方法返 回 值描述
enableDragging() none 启用地图拖拽,默认启用。
disableDragging() none 禁用地图拖拽。

地图状态方法

方法返回值描述
getBounds() Bounds 返回地图可视区域,以地理坐标表示。
getCenter() Point返回地图当前中心点。
getMapType() MapTypes返回地图类型。
getSize() Size 返回地图视图的大小,以像素表示。
getViewport(view: Array<Point>[, viewportOptions: ViewportOptions]) Viewport 根据提供的地理区域或坐标获得最佳的地图视野,返回的对象中包含center和zoom属性,分别表示地图的中心点和级别。此方法仅返回视野信息,不会将新的中心点和级别做用到当前地图上。
getZoom() 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除了可以为坐标点以外,还支持城市名。
setViewport(view:Array<Point>|Viewport[, viewportOptions: ViewportOptions]) none 根据提供的地理区域或坐标设置地图视野,调整后的视野会保证包含提供的地理区域或坐标。
setZoom(zoom:Number) none 将视图切换到指定的缩放等级,中心点坐标不变。注意:当有信息窗口在地图上打开时,地图缩放将保证信息窗口所在的坐标位置不动。
highResolutionEnabled() Boolean是否使用高分辨率底图。仅当mapOptions.enableHighResolution属性为true且设备支持高分辨率时返回true。

控件方法

方法返回值描述
addControl(control:Control) none 将控件添加到地图,一个控件实例只能向地图中添加一次。
removeControl(control:Control) none从地图中移除控件。如果控件从未被添加到地图中,则该移除不起任何作用。

覆盖物方法

方法返回值描述
addOverlay(overlay:Overlay) none 将覆盖物添加到地图中,一个覆盖物实例只能向地图中添加一次。
removeOverlay(overlay:Overlay) none 从地图中移除覆盖物。如果覆盖物从未被添加到地图中,则该移除不起任何作用。
clearOverlays() none 清除地图上所有覆盖物。
pointToOverlayPixel(point:Point) Pixel 根据地理坐标获取对应的覆盖物容器的坐标,此方法用于自定义覆盖物。
overlayPixelToPoint(pixel:Pixel) Point 根据覆盖物容器的坐标获取对应的地理坐标。
getOverlays() Array<Overlay>返回地图上的所有覆盖物。
getPanes() MapPanes返回地图覆盖物容器列表。

地图图层方法

方法返回值描述
addTileLayer(tileLayer:TileLayer) none 添加一个自定义地图图层。
removeTileLayer(tilelayer:TileLayer) none 移除一个自定义地图图层。

坐标变换

方法返回值描述
pixelToPoint(pixel:Pixel) Point 像素坐标转换为经纬度坐标。
pointToPixel(point:Point) Pixel 经纬度坐标转换为像素坐标。

事件

事件参数描述
click {type, target, point, pixel, overlay}左键单击地图时触发此事件。

当双击时,产生的事件序列为: click click dblclick

dblclick {type, target, pixel, point}鼠标双击地图时会触发此事件。
moveend {type, target}地图移动结束时触发此事件。
zoomend {type, target}地图更改缩放级别结束时触发触发此事件。
addoverlay {type, target}当使用Map.addOverlay()方法向地图中添加单个覆盖物时会触发此事件。
addcontrol {type, target}当使用Map.addControl()方法向地图中添加单个控件时会触发此事件。
removecontrol {type, target}当使用Map.removeControl()方法移除单个控件时会触发此事件。
removeoverlay {type, target}当使用Map.removeOverlay()方法移除单个覆盖物时会触发此事件。
clearoverlays {type, target}当使用Map.clearOverlays()方法一次性移除全部覆盖物时会触发此事件。
addtilelayer {type, target}添加一个自定义地图图层时触发此事件。
removetilelayer {type, target}移除一个自定义地图图层时触发此事件。
load {type, target, pixel, point, zoom}调用Map.centerAndZoom()方法时会触发此事件。这表示位置、缩放层级已经确定,但可能还在载入地图图块。
resize {type, target, size}地图可视区域大小发生变化时会触发此事件。
touchmove {type, target, point,pixel}触摸移动时触发此事件,仅适用移动设备。
touchend {type, target, point,pixel}触摸结束时触发此事件,仅适用移动设备。
查看
Class:极速版核心类/map

类参考