核心类

Map
此类是地图API的核心类,用来实例化一个地图。
构造函数
构造函数 描述
Map(container: String | HTMLElement, opts: MapOptions) 在指定的容器内创建地图实例,之后需要调用Map.centerAndZoom()方法对地图进行初始化。未进行初始化的地图将不能进行任何操作
方法
方法 返回值 描述
enableDragging() none 启用地图拖拽,默认启用
disableDragging() none 禁用地图拖拽
enableScrollWheelZoom() none 启用滚轮放大缩小,默认禁用
disableScrollWheelZoom() none 禁用滚轮放大缩小
enableDoubleClickZoom() none 启用双击放大,默认启用
disableDoubleClickZoom() none 禁用双击放大
enableKeyboard() none 启用键盘操作,默认禁用。键盘的上、下、左、右键可连续移动地图。同时按下其中两个键可使地图进行对角移动。PgUp、PgDn、Home和End键会使地图平移其1/2的大小。+、-键会使地图放大或缩小一级
disableKeyboard() none 禁用键盘操作
enableInertialDragging() none 启用地图惯性拖拽,默认禁用
disableInertialDragging() none 禁用地图惯性拖拽
enableContinuousZoom() none 启用连续缩放效果,默认禁用
disableContinuousZoom() none 禁用连续缩放效果
enablePinchToZoom() none 启用双指操作缩放,默认启用
disablePinchToZoom() none 禁用双指操作缩放
enableAutoResize() none 启用自动适应容器尺寸变化,默认启用
disableAutoResize() none 禁用自动适应容器尺寸变化
setDefaultCursor(cursor: String) none 设置地图默认的鼠标指针样式。参数cursor应符合CSS的cursor属性规范
getDefaultCursor() String 返回地图默认的鼠标指针样式
setDraggingCursor(cursor: String) none 设置拖拽地图时的鼠标指针样式。参数cursor应符合CSS的cursor属性规范
getDraggingCursor() String 返回拖拽地图时的鼠标指针样式
setMinZoom(zoom: Number) none 设置地图允许的最小级别。取值不得小于地图类型所允许的最小级别
setMaxZoom(zoom: Number) none 设置地图允许的最大级别。取值不得大于地图类型所允许的最大级别
setMapStyle() none 设置地图样式,样式包括地图底图颜色和地图要素是否展示两部分
setPanorama(pano: Panorama) none 将全景实例与Map类进行绑定
getBounds() Bounds 返回地图可视区域,以地理坐标表示
getCenter() Point 返回地图当前中心点
getDistance(start: Point, end: Point) Number 返回两点之间的距离,单位是米
getMapType() MapType 返回地图类型
getSize() Size 返回地图视图的大小,以像素表示
getViewport(view: Array< Point>, viewportOptions: ViewportOptions) Viewport 根据提供的地理区域或坐标获得最佳的地图视野,返回的对象中包含center和zoom属性,分别表示地图的中心点和级别。此方法仅返回视野信息,不会将新的中心点和级别做用到当前地图上
getZoom() Number 返回地图当前缩放级别
getPanorama() Panorama 获取与Map类绑定的全景实例
centerAndZoom(center: Point, zoom: Number) none 设初始化地图。 如果center类型为Point时,zoom必须赋值,范围3-19级,若调用高清底图(针对移动端开发)时,zoom可赋值范围为3-18级。如果center类型为字符串时,比如“北京”,zoom可以忽略,地图将自动根据center适配最佳zoom级别
panTo(center: Point, opts: PanOptions) none 将地图的中心点更改为给定的点。如果该点在当前的地图视图中已经可见,则会以平滑动画的方式移动到中心点位置。可以通过配置强制移动过程不使用动画效果
panBy(x: Number, y: Number, opts: PanOptions) none 将地图在水平位置上移动x像素,垂直位置上移动y像素。如果指定的像素大于可视区域范围或者在配置中指定没有动画效果,则不执行滑动效果
reset() none 重新设置地图,恢复地图初始化时的中心点和级别
setCenter(center: Point| String) none 设置地图中心点。center除了可以为坐标点以外,还支持城市名
setCurrentCity(city: String) none 设置地图城市,注意当地图初始化时的类型设置为BMAP_PERSPECTIVE_MAP时,需要在调用centerAndZoom之前调用此方法设置地图所在城市。例如: var map = new BMap.Map(“container”, {mapType: BMAP_PERSPECTIVE_MAP}); map.setCurrentCity(“北京市”); map.centerAndZoom(new BMap.Point(116.404, 39.915), 18); 注意:初始化的坐标应与您设置的城市对应,否则地图将无法正常显示。如果地图初始化为BMAP_NORMAL_MAP类型,则在调用setMapType切换地图类型时也要调用此方法
setMapType(mapType: MapTypes) none 设置地图类型。注意,当设置地图类型为BMAP_PERSPECTIVE_MAP时,需要调用map.setCurrentCity方法设置城市
setViewport(view: Array<Point> | Viewport, viewportOptions: ViewportOptions) none 根据提供的地理区域或坐标设置地图视野,调整后的视野会保证包含提供的地理区域或坐标
setZoom(zoom: Number) none 将视图切换到指定的缩放等级,中心点坐标不变。注意:当有信息窗口在地图上打开时,地图缩放将保证信息窗口所在的坐标位置不动
highResolutionEnabled() Boolean 是否使用高分辨率底图。仅当mapOptions.enableHighResolution属性为true且设备支持高分辨率时返回true
zoomIn() none 放大一级视图
zoomOut() none 缩小一级视图
addHotspot(hotspot: Hotspot) none 为地图添加热区
removeHotspot(hotspot: Hotspot) none 移除某个地图热区
clearHotspots() none 清空地图所有热区
addControl(control: Control) none 将控件添加到地图,一个控件实例只能向地图中添加一次
removeControl(control: Control) none 从地图中移除控件。如果控件从未被添加到地图中,则该移除不起任何作用
getContainer() HTMLElement 返回地图的容器元素。当创建用户自定义控件时,需要自行实现Control.initialize()方法,并将控件的容器元素添加到地图上,通过此方法可获得地图容器
addContextMenu(menu: ContextMenu) none 添加右键菜单
removeContextMenu(menu: ContextMenu) none 移除右键菜单
addOverlay(overlay: Overlay) none 将覆盖物添加到地图中,一个覆盖物实例只能向地图中添加一次
removeOverlay(overlay: Overlay) none 从地图中移除覆盖物。如果覆盖物从未被添加到地图中,则该移除不起任何作用
clearOverlays() none 清除地图上所有覆盖物
openInfoWindow(infoWnd: InfoWindow, point: Point) none 在地图上打开信息窗口
closeInfoWindow() none 关闭在地图上打开的信息窗口。在标注上打开的信息窗口也可通过此方法进行关闭
pointToOverlayPixel(point: Point) Pixel 根据地理坐标获取对应的覆盖物容器的坐标,此方法用于自定义覆盖物
overlayPixelToPoint(pixel: Pixel) Point 根据覆盖物容器的坐标获取对应的地理坐标
getInfoWindow() InfoWindow| Null 返回地图上处于打开状态的信息窗的实例。当地图没有打开的信息窗口时,此方法返回null
getOverlays() Array< Overlay> 返回地图上的所有覆盖物
getPanes() MapPanes 返回地图覆盖物容器列表
addTileLayer(tileLayer: TileLayer) none 添加一个自定义地图图层
removeTileLayer(tileLayer: TileLayer) none 移除一个自定义地图图层
getTileLayer(mapType: String) TileLayer 通过地图类型得到一个地图图层对象
pixelToPoint(pixel: Pixel) Point 像素坐标转换为经纬度坐标
pointToPixel(point: Point) Pixel 经纬度坐标转换为像素坐标
事件
事件 参数 描述
click {type, target, point, pixel, overlay} 左键单击地图时触发此事件。 当双击时,产生的事件序列为: click click dblclick
dblclick {type, target, pixel, point} 鼠标双击地图时会触发此事件
rightclick {type, target, point, pixel, overlay} 右键单击地图时触发此事件。 当双击时,产生的事件序列为: rightclick rightclick rightdblclick
rightdblclick {type, target, point, pixel, overlay} 右键双击地图时触发此事件
maptypechange {type, target} 地图类型发生变化时触发此事件
mousemove {type, target, point, pixel, overlay} 鼠标在地图区域移动过程中触发此事件
mouseover {type, target} 鼠标移入地图区域时触发此事件
mouseout {type, target} 鼠标移出地图区域时触发此事件
movestart {type, target} 地图移动开始时触发此事件
moving {type, target} 地图移动过程中触发此事件
moveend {type, target} 地图移动结束时触发此事件
zoomstart {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()方法一次性移除全部覆盖物时会触发此事件
dragstart {type, target, pixel, point} 开始拖拽地图时触发
dragging {type, target, pixel, point} 拖拽地图过程中触发
dragend {type, target, pixel, point} 停止拖拽地图时触发
addtilelayer {type, target} 添加一个自定义地图图层时触发此事件
removetilelayer {type, target} 移除一个自定义地图图层时触发此事件
load {type, target, pixel, point, zoom} 调用Map.centerAndZoom()方法时会触发此事件。这表示位置、缩放层级已经确定,但可能还在载入地图图块
resize {type, target, size} 地图可视区域大小发生变化时会触发此事件
hotspotclick {type, target, spots} 点击热区时触发此事件
hotspotover {type, target, spots} 鼠标移至热区时触发此事件
hotspotout {type, target, spots} 鼠标移出热区时触发此事件
tilesloaded {type, target} 当地图所有图块完成加载时触发此事件
touchstart {type, target, point,pixel} 触摸开始时触发此事件,仅适用移动设备
touchmove {type, target, point,pixel} 触摸移动时触发此事件,仅适用移动设备
touchend {type, target, point,pixel} 触摸结束时触发此事件,仅适用移动设备
longpress {type, target, point,pixel} 长按事件,仅适用移动设备
MapOptions
此类表示Map构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。
属性
属性 类型 描述
minZoom Number 地图允许展示的最小级别
maxZoom Number 地图允许展示的最大级别
mapType MapType 地图类型,默认为BMAP_NORMAL_MAP
enableHighResolution Boolean 是否启用使用高分辨率地图。在iPhone4及其后续设备上,可以通过开启此选项获取更高分辨率的底图,v1.2,v1.3版本默认不开启,v1.4默认为开启状态
enableAutoResize Boolean 是否自动适应地图容器变化,默认启用
enableMapClick Boolean 是否开启底图可点功能,默认启用
PanOptions
此类是panBy和panTo方法的可选参数,没有构造函数,通过对象字面量形式表示。
属性
属性 类型 描述
noAnimation Boolean 是否在平移过程中禁止动画
Viewport
此类代表视野,不可实例化,通过对象字面量形式表示。
属性
属性 类型 描述
center Point 视野中心点
zoom Number 视野级别
ViewportOptions
此类作为map.getViewport与map.setViewport方法的可选参数,不可实例化。
属性
属性 类型 描述
enableAnimation Boolean 是否启用动画效果移动地图,默认为true。当调整后的级别与当前地图级别一致时,将使用动画效果移动地图
margins Array<Number> 视野调整的预留边距,例如: margins: [30, 20, 0, 20] 表示坐标点会限制在上述区域内
zoomFactor Number 地图级别的偏移量,您可以在方法得出的结果上增加一个偏移值。例如map.setViewport计算出地图的级别为10,如果zoomFactor为-1,则最终的地图级别为9
delay Number 改变地图视野的延迟执行时间,单位毫秒,默认为200ms。此延时仅针对动画效果有效
APIVersion
此常量表示API版本号,通过字符串进行描述。
常量
常量 描述
BMAP_API_VERSION 返回当前API版本。例如,1.2版本返回字符串“1.2”
MapStyle
该类用于设置地图样式,使用对象字面量形式表示,不可实例化。
属性
属性 类型 描述
features Array 设置地图上展示的元素种类,支持point(兴趣点)、road(道路)、water(河流)、land(陆地)、building(建筑物)
style string 设置地图底图样式,目前支持normal(默认样式),dark(深色样式),light(浅色样式)三种

基础类

Point
此类表示一个地理坐标点。
构造函数
构造函数 描述
Point(lng: Number, lat: Number) 以指定的经度和纬度创建一个地理点坐标
属性
属性 类型 描述
lng Number 地理经度
lat Number 地理纬度
方法
方法 返回值 描述
equals(other: Point) Boolean 判断坐标点是否相等,当且仅当两点的经度和纬度均相等时返回true
Pixel
此类表示地图上的一点,单位为像素。
构造函数
构造函数 描述
Pixel(x: Number, y: Number) 创建像素点对象实例。像素坐标的坐标原点为地图区域的左上角
属性
属性 类型 描述
x Number x坐标
y Number y坐标
方法
方法 返回值 描述
equals(other: Pixel) Boolean 判断坐标点是否相等,当且仅当两点的x坐标和y坐标均相等时返回true
Bounds
此类表示地理坐标的矩形区域。
构造函数
构造函数 描述
Bounds(sw: Point, ne: Point) 创建一个包含所有给定点坐标的矩形区域。其中sw表示矩形区域的西南角,参数ne表示矩形区域的东北角
方法
方法 返回值 描述
equals(other: Bounds) Boolean 当且仅当此矩形中的两点参数都等于其他矩形的两点参数时,返回true
containsPoint(point: Point) Boolean 如果点的地理坐标位于此矩形内,则返回true
containsBounds(bounds: Bounds) Boolean 传入的矩形区域完全包含于此矩形区域中,则返回true
intersects(other: Bounds) Bounds 计算与另一矩形的交集区域
extend(point: Point) none 放大此矩形,使其包含给定的点
getCenter() Point 返回矩形的中心点
isEmpty() Boolean 如果矩形为空,则返回true
getSouthWest() Point 返回矩形区域的西南角
getNorthEast() Point 返回矩形区域的东北角
toSpan() Point 返回矩形区域的跨度
Size
此类以像素表示一个矩形区域的大小。
构造函数
构造函数 描述
Size(width: Number, height: Number) 以指定的宽度和高度创建一个矩形区域大小对象
属性
属性 类型 描述
width Number 水平方向的数值
height Number 竖直方向的数值
方法
方法 返回值 描述
equals(other: Size) Boolean 当且仅当此矩形中的宽度和高度都等于其他矩形的宽度和高度时,返回true

控件类

Control
此类是所有控件的基类,您可以通过此类来实现自定义控件。所有控件均包含Control类的属性、方法和事件。通过Map.addControl()方法可将控件添加到地图上。
构造函数
构造函数 描述
Control() 创建一个控件原型实例,通过该原型实例可创建自定义控件
属性
属性 类型 描述
defaultAnchor ControlAnchor 控件默认的停靠位置。自定义控件时需要提供此属性,作为控件的默认停靠位置
defaultOffset Size 控件默认的位置偏移值。自定义控件时需要提供此属性,作为控件的默认偏移位置
方法
方法 返回值 描述
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
此类表示地图的平移缩放控件,可以对地图进行上下左右四个方向的平移和缩放操作。
构造函数
构造函数 描述
NavigationControl(type: NavigationControlOptions) 创建一个特定样式的地图平移缩放控件
方法
方法 返回值 描述
getType() NavigationControlType 返回平移缩放控件的类型
setType(type: NavigationControlType) none 设置平移缩放控件的类型
NavigationControlOptions
此类表示NavigationControl构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。
属性
属性 类型 描述
anchor ControlAnchor 控件的停靠位置
offset Size 控件的水平偏移值
type NavigationControlType 平移缩放控件的类型
showZoomInfo Boolean 是否显示级别提示信息
enableGeolocation Boolean 控件是否集成定位功能,默认为false
NavigationControlType
此常量表示平移缩放控件的类型。
常量
常量 描述
BMAP_NAVIGATION_CONTROL_LARGE 标准的平移缩放控件(包括平移、缩放按钮和滑块)
BMAP_NAVIGATION_CONTROL_SMALL 仅包含平移和缩放按钮
BMAP_NAVIGATION_CONTROL_PAN 仅包含平移按钮
BMAP_NAVIGATION_CONTROL_ZOOM 仅包含缩放按钮
GeolocationControl
此类是负责进行地图定位的控件,使用html5浏览器定位功能,此类继承Control所有功能。
构造函数
构造函数 描述
GeolocationControl(type: GeolocationControlOptions) 创建一个特定样式的地图定位控件
方法
方法 返回值 描述
location() none 开始进行定位
getAddressComponent() AddressComponent 返回当前的定位信息。若当前还未定位,则返回null
事件
事件 参数 描述
locationSuccess {point, AddressComponent} 定位成功后触发此事件
locationError {StatusCode} 定位失败后触发此事件
GeolocationControlOptions
此类表示GeolocationControl构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。
属性
属性 类型 描述
anchor ControlAnchor 控件的停靠位置,默认定位到地图的右下角
offset Size 控件的水平偏移值
showAddressBar Boolean 是否显示定位信息面板。默认显示定位信息面板
enableAutoLocation Boolean 添加控件时是否进行定位。默认添加控件时不进行定位
locationIcon Icon 可自定义定位中心点的Icon样式
OverviewMapControl
此类表示缩略地图控件。
构造函数
构造函数 描述
OverviewMapControl(opts: OverviewMapControlOptions) 创建一个缩略地图控件实例
方法
方法 返回值 描述
changeView() none 切换缩略地图控件的开合状态
setSize(size: Size) none 设置缩略地图的大小
getSize() Size 返回缩略地图的大小
事件
事件 参数 描述
viewchanged event{type, target, isOpen} 缩略地图开合状态发生变化后触发此事件
viewchanging event{type, target} 缩略地图开合状态发生变化过程中触发此事件
OverviewMapControlOptions
此类表示OverviewMapControl构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。
属性
属性 类型 描述
anchor ControlAnchor 控件的停靠位置
offset Size 控件的偏移值
size Size 缩略地图控件的大小
isOpen Boolean 缩略地图添加到地图后的开合状态,默认为关闭
ScaleControl
此类表示比例尺控件。
构造函数
构造函数 描述
ScaleControl(opts: ScaleControlOptions) 创建一个比例尺控件
方法
方法 返回值 描述
getUnit() LengthUnit 返回比例尺单位制
setUnit(unit: LengthUnit) none 设置比例尺单位制
ScaleControlOptions
此类表示ScaleControl构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。
属性
属性 类型 描述
anchor ControlAnchor 控件的停靠位置
offset Size 控件的偏移值
LengthUnit
常量表示长度单位制。
常量
常量 描述
BMAP_UNIT_METRIC 公制单位
BMAP_UNIT_IMPERIAL 英制单位
CopyrightControl
此类表示版权控件,您可以在地图上添加自己的版权信息。每一个版权信息需要包含如下内容:版权的唯一标识、版权内容和其适用的区域范围。
构造函数
构造函数 描述
CopyrightControl(opts: CopyrightControlOptions) 创建一个版权控件实例
方法
方法 返回值 描述
addCopyright(copyright: Copyright) none 添加版权信息
removeCopyright(id: number) none 移除版权信息
getCopyright(id: number) Copyright 返回单个版权信息
getCopyrightCollection() Array< Copyright> 返回版权信息列表
CopyrightControlOptions
此类表示CopyrightControl构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。
属性
属性 类型 描述
anchor ControlAnchor 控件的停靠位置
offset Size 控件的偏移值
Copyright
此类表示一条版权信息。可作为CopyrightControl.addCopyright()方法的参数。它没有构造函数,但可通过对象字面量形式表示。
属性
属性 类型 描述
id Number 该版权信息的唯一标识符
content String 该版权的文本信息,用于显示在地图上,支持HTML内容
bounds Bounds 该版权信息所适用的地理区域
MapTypeControl
此类是负责切换地图类型的控件,此类继承Control所有功能。
构造函数
构造函数 描述
MapTypeControl(opts: MapTypeControlOptions) 创建地图类型控件
MapTypeControlOptions
此类表示MapTypeControl构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。
属性
属性 类型 描述
type MapTypeControlType 控件样式
mapTypes Array< MapType> 控件展示的地图类型,默认为普通图、卫星图、卫星加路网混合图和三维图。通过此属性可配置控件展示的地图类型
MapTypeControlType
此常量表示MapTypeControl的外观样式。
常量
常量 描述
BMAP_MAPTYPE_CONTROL_HORIZONTAL 按钮水平方式展示,默认采用此类型展示
BMAP_MAPTYPE_CONTROL_DROPDOWN 按钮呈下拉列表方式展示
BMAP_MAPTYPE_CONTROL_MAP 以图片方式展示类型控件,设置该类型后无法指定maptypes属性
PanoramaControl
此类是负责切换至全景地图的控件,此类继承Control所有功能。
构造函数
构造函数 描述
PanoramaControl() 创建全景控件实例
StatusCode
此常量用于描述对象当前状态。
常量
常量 描述
BMAP_STATUS_PERMISSION_DENIED 没有权限。对应数值“6”
BMAP_STATUS_SERVICE_UNAVAILABLE 服务不可用。对应数值“7”
BMAP_STATUS_TIMEOUT 超时。对应数值“8”

覆盖物类

Overlay
覆盖物的抽象基类,所有覆盖物均继承基类的方法。此类不可实例化。
方法
方法 返回值 描述
initialize(map: Map) HTMLElement 抽象方法,用于初始化覆盖物,当调用map.addOverlay时,API将调用此方法。自定义覆盖物时需要实现此方法。自定义覆盖物时需要将覆盖物对应的HTML元素返回
isVisible() Boolean 判断覆盖物是否可见
draw() none 抽象方法,当地图状态发生变化时,由系统调用对覆盖物进行绘制。自定义覆盖物需要实现此方法
show() none 显示覆盖物。对于自定义覆盖物,此方法会自动将initialize方法返回的HTML元素样式的display属性设置为空
hide() none 隐藏覆盖物。对于自定义覆盖物,此方法会自动将initialize方法返回的HTML元素样式的display属性设置为none
MapPanes
此类表示地图上所有覆盖物的容器集合,没有构造函数,通过对象字面量形式表示。通过Map的getPanes方法可获得该对象实例。
属性
属性 类型 描述
floatPane HTMLElement 信息窗口所在的容器
markerMouseTarget HTMLElement 标注点击区域所在的容器
floatShadow HTMLElement 信息窗口阴影所在的容器
labelPane HTMLElement 文本标注所在的容器
markerPane HTMLElement 标注图标所在的容器
markerShadow HTMLElement 标注阴影所在的容器
mapPane HTMLElement 折线、多边形等矢量图形所在的容器
Marker
此类表示地图上一个图像标注。
构造函数
构造函数 描述
Marker(point: Point, opts: MarkerOptions) 创建一个图像标注实例。point参数指定了图像标注所在的地理位置
方法
方法 返回值 描述
openInfoWindow(infoWnd: InfoWindow) none 打开信息窗
closeInfoWindow() none 关闭信息窗
setIcon(icon: Icon) none 设置标注所用的图标对象
getIcon() Icon 返回标注所用的图标对象
setPosition(position: Point) none 设置标注的地理坐标
getPosition() Point 返回标注的地理坐标
setOffset(offset: Size) none 设置标注的偏移值
getOffset() Size 返回标注的偏移值
getLabel() Label 返回标注的文本标注
setLabel(label: Label) none 为标注添加文本标注
setTitle(title: String) none 设置标注的标题,当鼠标移至标注上时显示此标题
getTitle() String 返回标注的标题
setTop(isTop: Boolean) none 将标注置于其他标注之上。默认情况下,纬度较低的标注会覆盖在纬度较高的标注之上,从而形成一种立体效果。通过此方法可使某个标注覆盖在其他所有标注之上。注意:如果在多个标注对象上调用此方法,则这些标注依旧按照纬度产生默认的覆盖效果
enableDragging() none 开启标注拖拽功能
disableDragging() none 关闭标注拖拽功能
enableMassClear() none 允许覆盖物在map.clearOverlays方法中被清除
disableMassClear() none 禁止覆盖物在map.clearOverlays方法中被清除
setZIndex(zIndex: Number) none 设置覆盖物的zIndex
getMap() Map 返回覆盖物所在的map对象
addContextMenu(menu: ContextMenu) none 添加右键菜单
removeContextMenu(menu: ContextMenu) none 移除右键菜单
setAnimation(animation: Animation| Null) none 设置标注动画效果。如果参数为null,则取消动画效果。该方法需要在addOverlay方法后设置
setRotation(rotation: Number) none 设置点的旋转角度
getRotation() Number 获取点的旋转角度
setShadow(shadow: Icon) none 设置标注阴影图标
getShadow() Icon 获取标注阴影图标
addEventListener(event: String, handler: Function) none 添加事件监听函数
removeEventListener(event: String, handler: Function) none 移除事件监听函数
事件
事件 参数 描述
click event{type, target} 点击标注图标后会触发此事件
dblclick event{type, target, point,pixel} 双击标注图标后会触发此事件
mousedown event{type, target, point,pixel} 鼠标在标注图上按下触发此事件
mouseup event{type, target, point,pixel} 鼠标在标注图上释放触发此事件
mouseout event{type, target, point,pixel} 鼠标离开标注时触发此事件
mouseover event{type, target, point,pixel} 当鼠标进入标注图标区域时会触发此事件
remove event{type, target} 移除标注时触发
infowindowclose event{type, target} 信息窗在此标注上关闭时触发此事件
infowindowopen event{type, target} 信息窗在此标注上打开时触发此事件
dragstart event{type, target} 开始拖拽标注时触发此事件
dragging event{type, target, pixel, point} 拖拽标注过程中触发此事件
dragend event{type, target, pixel, point} 拖拽结束时触发此事件
rightclick event{type, target} 右键点击标注时触发此事件
MarkerOptions
此类表示Marker构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。
属性
属性 类型 描述
offset Size 标注的位置偏移值
icon Icon 标注所用的图标对象
enableMassClear Boolean 是否在调用map.clearOverlays清除此覆盖物,默认为true
enableDragging Boolean 是否启用拖拽,默认为false
enableClicking Boolean 是否响应点击事件。默认为true
raiseOnDrag Boolean 拖拽标注时,标注是否开启离开地图表面效果。默认为false
draggingCursor String 拖拽标注时的鼠标指针样式。此属性值需遵循CSS的cursor属性规范
rotation Number 旋转角度
shadow Icon 阴影图标
title String 鼠标移到marker上的显示内容
Animation
此常量表示标注的动画效果。
常量
常量 描述
BMAP_ANIMATION_DROP 坠落动画
BMAP_ANIMATION_BOUNCE 跳动动画
Icon
此类表示标注覆盖物所使用的图标。
构造函数
构造函数 描述
Icon(url: String, size: Size, opts: IconOptions) 以给定的图像地址和大小创建图标对象实例
属性
属性 类型 描述
anchor Size 图标的定位点相对于图标左上角的偏移值
size Size 图标可视区域的大小
imageOffset Size 图标所用的图片相对于可视区域的偏移值,此功能的作用等同于CSS中的background-position属性
imageSize Size 图标所用的图片的大小,此功能的作用等同于CSS中的background-size属性。可用于实现高清屏的高清效果
imageUrl String 图标所用图像资源的位置
infoWindowAnchor Size 信息窗口开启位置相对于图标左上角的偏移值
printImageUrl String 设置icon打印图片的url,该打印图片只针对IE6有效,解决IE6使用PNG滤镜导致的错位问题。如果您的icon没有使用PNG格式图片或者没有使用CSS Sprites技术,则可忽略此配置
方法
方法 返回值 描述
setImageUrl(imageUrl: String) none 设置图片资源的地址
setSize(size: Size) none 设置图标可视区域的大小
setImageSize(offset: Size) none 设置图标的大小
setAnchor(anchor: Size) none 设置图标定位点相对于其左上角的偏移值
setImageOffset(offset: Size) none 设置图片相对于可视区域的偏移值
setInfoWindowAnchor(anchor: Size) none 设置信息窗口开启位置相对于图标左上角的偏移值
setPrintImageUrl(url: String) none 设置icon的打印图片,该打印图片只针对IE6有效,解决IE6使用PNG滤镜导致的错位问题。如果您的icon没有使用PNG格式图片或者没有使用CSS Sprites技术,则可忽略此配置
IconOptions
此类表示Icon构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。
属性
属性 类型 描述
anchor Size 图标的定位锚点。此点用来决定图标与地理位置的关系,是相对于图标左上角的偏移值,默认等于图标宽度和高度的中间值
imageOffset Size 图片相对于可视区域的偏移值
infoWindowAnchor Size 信息窗口定位锚点。开启信息窗口时,信息窗口底部尖角相对于图标左上角的位置,默认等于图标的anchor
printImageUrl String 用于打印的图片,此属性只适用于IE6,为了解决IE6在包含滤镜的情况下打印样式不正确的问题
InfoWindow
此类表示地图上包含信息的窗口。
构造函数
构造函数 描述
InfoWindow(content: String | HTMLElement, opts: InfoWindowOptions) 创建一个信息窗实例,其中content支持HTML内容。1.2版本开始content参数支持传入DOM结点
方法
方法 返回值 描述
setWidth(width: Number) none 设置信息窗口的宽度,单位像素。取值范围:220 - 730
setHeight(height: Number) none 设置信息窗口的高度,单位像素。取值范围:60 - 650
redraw() none 重绘信息窗口,当信息窗口内容发生变化时进行调用
setTitle(title: String | HTMLElement) none 设置信息窗口标题。支持HTML内容。1.2版本开始title参数支持传入DOM结点
getTitle() String | HTMLElement 返回信息窗口标题
setContent(content: String | HTMLElement) none 设置信息窗口内容。支持HTML内容。1.2版本开始content参数支持传入DOM结点
getContent() String | HTMLElement 返回信息窗口内容
getPosition() Point 返回信息窗口的位置
enableMaximize() none 启用窗口最大化功能。需要设置最大化后信息窗口里的内容,该接口才生效
disableMaximize() none 禁用窗口最大化功能
isOpen() Boolean 返回信息窗口的打开状态
setMaxContent(content: String) none 信息窗口最大化时所显示内容,支持HTML内容
maximize() none 最大化信息窗口
restore() none 还原信息窗口
enableAutoPan() none 开启打开信息窗口时地图自动平移
disableAutoPan() none 关闭打开信息窗口时地图自动平移
enableCloseOnClick() none 开启点击地图时关闭信息窗口
disableCloseOnClick() none 关闭点击地图时关闭信息窗口
addEventListener(event: String, handler: Function) none 添加事件监听函数
removeEventListener(event: String, handler: Function) none 移除事件监听函数
事件
事件 参数 描述
close event{type, target, point} 信息窗口被关闭时触发此事件
open event{type, target, point} 信息窗口被打开时触发此事件
maximize event{type, target} 信息窗口最大化后触发此事件
restore event{type, target} 信息窗口还原时触发此事件
clickclose event{type, target} 点击信息窗口的关闭按钮时触发此事件
InfoWindowOptions
此类表示InfoWindow构造函数的可选参数,它没有构造函数,但可通过对象字面量形式表示。
属性
属性 类型 描述
width Number 信息窗宽度,单位像素。取值范围:0, 220 - 730。如果您指定宽度为0,则信息窗口的宽度将按照其内容自动调整
height Number 信息窗高度,单位像素。取值范围:0, 60 - 650。如果您指定高度为0,则信息窗口的高度将按照其内容自动调整
maxWidth Number 信息窗最大化时的宽度,单位像素。取值范围:220 - 730
offset Size 信息窗位置偏移值。默认情况下在地图上打开的信息窗底端的尖角将指向其地理坐标,在标注上打开的信息窗底端尖角的位置取决于标注所用图标的infoWindowOffset属性值,您可以为信息窗添加偏移量来改变默认位置
title String 信息窗标题文字,支持HTML内容
enableAutoPan Boolean 是否开启信息窗口打开时地图自动移动(默认开启)
enableCloseOnClick Boolean 是否开启点击地图关闭信息窗口(默认开启)
enableMessage Boolean 是否在信息窗里显示短信发送按钮(默认开启)
message String 自定义部分的短信内容,可选项。完整的短信内容包括:自定义部分+位置链接,不设置时,显示默认短信内容。短信内容最长为140个字
Label
此类表示地图上的文本标注。
构造函数
构造函数 描述
Label(content: String, opts: LabelOptions) 创建一个文本标注实例。point参数指定了文本标注所在的地理位置
方法
方法 返回值 描述
setStyle(styles: Object) none 设置文本标注样式,该样式将作用于文本标注的容器元素上。其中styles为JavaScript对象常量,比如: setStyle({ color : "red", fontSize : "12px" }) 注意:如果css的属性名中包含连字符,需要将连字符去掉并将其后的字母进行大写处理,例如:背景色属性要写成:backgroundColor
setContent(content: String) none 设置文本标注的内容。支持HTML
setPosition(position: Point) none 设置文本标注坐标。仅当通过Map.addOverlay()方法添加的文本标注有效
getPosition() Point 获取Label的地理坐标
setOffset(offset: Size) none 设置文本标注的偏移值
getOffset() Size 返回文本标注的偏移值
setTitle(title: String) none 设置文本标注的标题,当鼠标移至标注上时显示此标题
getTitle() String 返回文本标注的标题
enableMassClear() none 允许覆盖物在map.clearOverlays方法中被清除
disableMassClear() none 禁止覆盖物在map.clearOverlays方法中被清除
setZIndex(zIndex: Number) none 设置覆盖物的zIndex
setPosition(position: Point) none 设置地理坐标
getMap() Map 返回覆盖物所在的map对象
addEventListener(event: String, handler: Function) none 添加事件监听函数
removeEventListener(event: String, handler: Function) none 移除事件监听函数
事件
事件 参数 描述
click event{type, target} 点击文本标注后会触发此事件
dblclick event{type, target} 双击文本标注后会触发此事件
mousedown event{type, target} 鼠标在文本标注上按下触发此事件
mouseup event{type, target} 鼠标在文本标注释放触发此事件
mouseout event{type, target} 鼠标离开文本标注时触发此事件
mouseover event{type, target} 当鼠标进入文本标注区域时会触发此事件
remove event{type, target} 移除文本标注时触发
rightclick event{type, target} 右键点击标注时触发此事件
LabelOptions
此类表示Lable构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。
属性
属性 类型 描述
offset Size 文本标注的位置偏移值
position Point 文本标注的地理位置
enableMassClear Boolean 是否在调用map.clearOverlays清除此覆盖物,默认为true
Polyline
使用浏览器的矢量制图工具(如果可用)在地图上绘制折线的地图叠加层。
构造函数
构造函数 描述
Polyline(points: Array< Point>, opts: PolylineOptions) 创建折线覆盖物对象
方法
方法 返回值 描述
setPath(path: Array< Point>) none 设置折线的点数组
getPath() Array< Point> 返回折线的点数组
setStrokeColor(color: String) none 设置折线的颜色
getStrokeColor() String 返回折线的颜色
setStrokeOpacity(opacity: Number) none 设置透明度,取值范围0 - 1
getStrokeOpacity() Number 返回透明度
setStrokeWeight(weight: Number) none 设置线的宽度,范围为大于等于1的整数
getStrokeWeight() Number 返回线的宽度
setStrokeStyle(style: String) none 设置是为实线或虚线,solid或dashed
getStrokeStyle() String 返回当前线样式状态,实线或者虚线
getBounds() Bounds 返回覆盖物的地理区域范围
enableEditing() none 开启编辑功能
disableEditing() none 关闭编辑功能
enableMassClear() none 允许覆盖物在map.clearOverlays方法中被清除
disableMassClear() none 禁止覆盖物在map.clearOverlays方法中被清除
setPositionAt(index: Number, point: Point) none 修改指定位置的坐标。索引index从0开始计数。例如setPointAt(2, point)代表将折线的第3个点的坐标设为point
getMap() Map 返回覆盖物所在的map对象
addEventListener(event: String, handler: Function) none 添加事件监听函数
removeEventListener(event: String, handler: Function) none 移除事件监听函数
事件
事件 参数 描述
click event{type, target, point, pixel} 点击折线后会触发此事件
dblclick event{type, target, point, pixel} 双击折线后会触发此事件
mousedown event{type, target, point, pixel} 鼠标在折线上按下触发此事件
mouseup event{type, target, point, pixel} 鼠标在折线释放触发此事件
mouseout event{type, target, point, pixel} 鼠标离开折线时触发此事件
mouseover event{type, target, point, pixel} 当鼠标进入折线区域时会触发此事件
remove event{type, target} 移除折线时触发
lineupdate event{type, target} 覆盖物的属性发生变化时触发
PolylineOptions
此类表示Polyline构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。
属性
属性 类型 描述
strokeColor String 折线颜色
strokeWeight Number 折线的宽度,以像素为单位
strokeOpacity Number 折线的透明度,取值范围0 - 1
strokeStyle String 折线的样式,solid或dashed
enableMassClear Boolean 是否在调用map.clearOverlays清除此覆盖物,默认为true
enableEditing Boolean 是否启用线编辑,默认为false
enableClicking Boolean 是否响应点击事件,默认为true
IconSequence
此类用于设置polyline上的符号显示。
构造函数
构造函数 描述
IconSequence(symbol: Symbol, offset: string, repeat: string, fixedRotation: boolean) 创建线上的符号类。symbol为符号样式;offset为符号相对于线起点的位置,取值可以是百分比也可以是像素位置,默认为"100%";repeat为符号在线上重复显示的距离,可以是百分比也可以是距离值,同时设置repeat与offset时,以repeat为准;fixedRotation设置图标的旋转角度是否与线走向一致,默认为true
Polygon
此类表示一个多边形覆盖物。
构造函数
构造函数 描述
Polygon(points: Array< Point>, opts: PolygonOptions) 创建多边形覆盖物
方法
方法 返回值 描述
setPath(path: Array< Point>) none 设置多边型的点数组
getPath() Array< Point> 返回多边型的点数组
setStrokeColor(color: String) none 设置多边型的边线颜色,参数为合法的CSS颜色值
getStrokeColor() String 返回多边型的边线颜色
setFillColor(color: String) none 设置多边形的填充颜色,参数为合法的CSS颜色值。当参数为空字符串时,折线覆盖物将没有填充效果
getFillColor() String 返回多边形的填充颜色
setStrokeOpacity(opacity: Number) none 设置多边形的边线透明度,取值范围0 - 1
getStrokeOpacity() Number 返回多边形的边线透明度
setFillOpacity(opacity: Number) none 设置多边形的填充透明度,取值范围0 - 1
getFillOpacity() Number 返回多边形的填充透明度
setStrokeWeight(weight: Number) none 设置多边形边线的宽度,取值为大于等于1的整数
getStrokeWeight() Number 返回多边形边线的宽度
setStrokeStyle(style: String) none 设置多边形边线样式为实线或虚线,取值solid或dashed
getStrokeStyle() String 返回多边形边线样式
getBounds() Bounds 返回覆盖物的地理区域范围
enableEditing() none 开启编辑功能
disableEditing() none 关闭编辑功能
enableMassClear() none 允许覆盖物在map.clearOverlays方法中被清除
disableMassClear() none 禁止覆盖物在map.clearOverlays方法中被清除
setPositionAt(index: Number, point: Point) none 修改指定位置的坐标。索引index从0开始计数。例如setPositionAt(2, point)代表将折线的第3个点的坐标设为point
getMap() Map 返回覆盖物所在的map对象
addEventListener(event: String, handler: Function) none 添加事件监听函数
removeEventListener(event: String, handler: Function) none 移除事件监听函数
事件
事件 参数 描述
click event{type, target, point, pixel} 点击多边形后会触发此事件
dblclick event{type, target, point, pixel} 双击多边形后会触发此事件
mousedown event{type, target, point, pixel} 鼠标在多边形上按下触发此事件
mouseup event{type, target, point, pixel} 鼠标在多边形释放触发此事件
mouseout event{type, target, point, pixel} 鼠标离开多边形时触发此事件
mouseover event{type, target, point, pixel} 当鼠标进入多边形区域时会触发此事件
remove event{type, target} 移除多边形时触发
lineupdate event{type, target} 覆盖物的属性发生变化时触发
PolygonOptions
此类表示Polygon构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。
属性
属性 类型 描述
strokeColor String 边线颜色
fillColor String 填充颜色。当参数为空时,折线覆盖物将没有填充效果
strokeWeight Number 边线的宽度,以像素为单位
strokeOpacity Number 边线透明度,取值范围0 - 1
fillOpacity Number 填充的透明度,取值范围0 - 1
strokeStyle String 边线的样式,solid或dashed
enableMassClear Boolean 是否在调用map.clearOverlays清除此覆盖物,默认为true
enableEditing Boolean 是否启用线编辑,默认为false
enableClicking Boolean 是否响应点击事件,默认为true
Circle
此类表示地图上的圆覆盖物。
构造函数
构造函数 描述
Circle(center: Point, radius: Number, opts: CircleOptions) 创建圆覆盖物
方法
方法 返回值 描述
setCenter(center: Point) none 设置圆形的中心点坐标
getCenter() Point 返回圆形的中心点坐标
setRadius(radius: Number) none 设置圆形的半径,单位为米
getRadius() Number 返回圆形的半径,单位为米
getBounds() Bounds 返回圆形的地理区域范围
setStrokeColor(color: String) none 设置圆形的边线颜色,参数为合法的CSS颜色值
getStrokeColor() String 返回圆形的边线颜色
setFillColor(color: String) none 设置圆形的填充颜色,参数为合法的CSS颜色值。当参数为空字符串时,圆形覆盖物将没有填充效果
getFillColor() String 返回圆形的填充颜色
setStrokeOpacity(opacity: Number) none 设置圆形的边线透明度,取值范围0 - 1
getStrokeOpacity() Number 返回圆形的边线透明度
setFillOpacity(opacity: Number) none 设置圆形的填充透明度,取值范围0 - 1
getFillOpacity() Number 返回圆形的填充透明度
setStrokeWeight(weight: Number) none 设置圆形边线的宽度,取值为大于等于1的整数
getStrokeWeight() Number 返回圆形边线的宽度
setStrokeStyle(style: String) none 设置圆形边线样式为实线或虚线,取值solid或dashed
getStrokeStyle() String 返回圆形边线样式
enableEditing() none 开启编辑功能
disableEditing() none 关闭编辑功能
enableMassClear() none 允许覆盖物在map.clearOverlays方法中被清除
disableMassClear() none 禁止覆盖物在map.clearOverlays方法中被清除
getMap() Map 返回覆盖物所在的map对象
addEventListener(event: String, handler: Function) none 添加事件监听函数
removeEventListener(event: String, handler: Function) none 移除事件监听函数
事件
事件 参数 描述
click event{type, target, point, pixel} 鼠标点击圆形后会触发此事件
dblclick event{type, target, point, pixel} 鼠标双击圆形后会触发此事件
mousedown event{type, target, point, pixel} 鼠标在圆形上按下触发此事件
mouseup event{type, target, point, pixel} 鼠标在圆形释放触发此事件
mouseout event{type, target, point, pixel} 鼠标离开圆形时触发此事件
mouseover event{type, target, point, pixel} 当鼠标进入圆形区域时会触发此事件
remove event{type, target} 移除圆形时触发此事件
lineupdate event{type, target} 圆形覆盖物的属性发生变化时触发此事件
CircleOptions
Circle类构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。
属性
属性 类型 描述
strokeColor String 圆形边线颜色
fillColor String 圆形填充颜色。当参数为空时,圆形将没有填充效果
strokeWeight Number 圆形边线的宽度,以像素为单位
strokeOpacity Number 圆形边线透明度,取值范围0 - 1
fillOpacity Number 圆形填充的透明度,取值范围0 - 1
strokeStyle String 圆形边线的样式,solid或dashed
enableMassClear Boolean 是否在调用map.clearOverlays清除此覆盖物,默认为true
enableEditing Boolean 是否启用线编辑,默认为false
enableClicking Boolean 是否响应点击事件,默认为true
GroundOverlay
此类表示地图上的地面叠加层。
构造函数
构造函数 描述
GroundOverlay(bounds: Bounds, opts: GroundOverlayOptions) 创建地面叠加层
方法
方法 返回值 描述
setBounds(bounds: Bounds) none 设置图层显示的矩形区域
getBounds() Bounds 返回图层显示的矩形区域
setOpacity(opcity: Number) none 设置图层的透明度
getOpacity() Number 返回图层的透明度
setImageURL(url: String) none 返回图层地址
getImageURL() String 返回图层地址
setDisplayOnMinLevel(level: Number) none 设置图层显示的最小级别
getDisplayOnMinLevel() Number 返回图层显示的最小级别
setDispalyOnMaxLevel(level: Number) none 设置图层显示的最大级别
getDispalyOnMaxLevel() Number 返回图层显示的最大级别
事件
事件 参数 描述
click event{type, target} 鼠标点击图层后会触发此事件
dblclick event{type, target} 鼠标双击图层后会触发此事件
GroundOverlayOptions
GroundOverlay类构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。
属性
属性 类型 描述
opacity Number 图层透明度
imageURL String 图层地址
displayOnMinLevel Number 图层显示的最小级别
displayOnMaxLevel Number 图层显示的最大级别
PointCollection
此类表示海量点类,利用该类可同时在地图上展示万级别的点,目前仅适用于html5浏览器。
构造函数
构造函数 描述
PointCollection(points: Array< Point>, opts: PointCollectionOptions) 创建海量点类。points为点的坐标集合,opts为点的绘制样式
方法
方法 返回值 描述
setPoints(points: Array< Point>) none 设置要在地图上展示的点坐标集合
setStyles(styles: PointCollectionOption) none 点的样式,包括:大小"size"(可选,默认正常尺寸10*10px,SizeType类型),形状"shape"(可选,默认圆形,ShapeType类型),颜色"color"(可选,字符串类型)
clear() none 清除海量点
事件
事件 参数 描述
click event{type, target,point} 鼠标点击点时会触发此事件
mouseover event{type, target,point} 鼠标移入点时会触发该事件
mouseout event{type, target,point} 鼠标移出点时会触发该事件
PointCollectionOptions
该类是PointCollections的可选参数,没有构造函数,通过对象字面量形式表示。
属性
属性 类型 描述
shape ShapeType 海量点的预设形状
color String 海量点的颜色,默认为'#fa937e',同时支持颜色字符串,如'red';哈希字符串'#000000';rgb字符串,如'rgb(0,0,0)’;rgba字符串,如'rgb(255,0,0,0.1)';hsl字符串,如'hsl(0,100%,50%)';hsla字符串,如'hsla(0,100%,50%,0.4)'
size SizeType 海量点的预设尺寸
ShapeType
此枚举类型表示海量点预设的不同形状。
常量
常量 描述
BMAP_POINT_SHAPE_CIRCLE 圆形,为默认形状
BMAP_POINT_SHAPE_STAR 星形
BMAP_POINT_SHAPE_SQUARE 方形
BMAP_POINT_SHAPE_RHOMBUS 菱形
BMAP_POINT_SHAPE_WATERDROP 水滴状,该类型无size和color属性
SizeType
此枚举类型表示海量点预设的不同尺寸。
常量
常量 描述
BMAP_POINT_SIZE_TINY 定义点的尺寸为超小,宽高为2px*2px
BMAP_POINT_SIZE_SMALLER 定义点的尺寸为很小,宽高为4px*4px
BMAP_POINT_SIZE_SMALL 定义点的尺寸为小,宽高为8px*8px
BMAP_POINT_SIZE_NORMAL 定义点的尺寸为正常,宽高为10px*10px,为海量点默认尺寸
BMAP_POINT_SIZE_BIG 定义点的尺寸为大,宽高为16px*16px
BMAP_POINT_SIZE_BIGGER 定义点的尺寸为很大,宽高为20px*20px
BMAP_POINT_SIZE_HUGE 定义点的尺寸为超大,宽高为30px*30px
Hotspot
此类表示地图上的一个热区。
构造函数
构造函数 描述
Hotspot(position: Point, options: HotspotOptions) 创建Hotspot对象实例
方法
方法 返回值 描述
getPosition() Point 获取热区位置坐标
setPosition(position: Point) None 设置热区位置坐标
getText() String 获取热区提示文本
setText(text: String) None 设置热区提示文本
getUserData() Mix 获取热区对应的用户数据
setUserData(data: Mix) None 设置热区对应的用户数据
HotspotOptions
此类是addHotspot方法的可选参数,没有构造函数,通过对象字面量形式表示。
属性
属性 类型 描述
text String 当鼠标移至某一热区上时出现的文字提示
offsets Array 热区响应区域距中心点的扩展偏移值。数组的四个数值分别表示上、右、下、左距离中心点的扩展偏移量。默认偏移量为[5, 5, 5, 5]
userData Mix 由用户填入的自定义数据
minZoom Number 热区生效的最小级别
maxZoom Number 热区生效的最大级别
Symbol
此类表示通过svg的path string创建的矢量图标类。
构造函数
构造函数 描述
Symbol(path: String | SymboShapeType, opts: SymbolOptions) 创建一个矢量图标实例。path为svg中的path字符串或者已定义的符号常量,opts为矢量图标的样式
方法
方法 返回值 描述
setPath(path: string | SymbolShape) none 设置矢量图标的路径
setAnchor(anchor: Size) none 设置矢量图标的定位点,该定位点的位置以图标自身为基准
setRotation(rotation: number) none 设置矢量图标的旋转角度,参数为角度
setScale(scale: number) none 设置矢量图标的缩放比例
setStrokeWeight(strokeWeight: number) none 设置矢量图标的线宽
setStrokeColor(color: string) none 设置矢量图标的线填充颜色,支持颜色常量字符串、十六进制、RGB、RGBA等格式
setStrokeOpacity(opacity: number) none 设置矢量图标线的透明度,opacity范围0~1
setFillOpacity(opacity: number) none 设置矢量图标填充透明度,opacity范围0~1
setFillColor(color: string) none 设置矢量图标的填充颜色。支持颜色常量字符串、十六进制、RGB、RGBA等格式
SymbolOptions
此类表示Symbol构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。
属性
属性 类型 描述
anchor Size 符号的位置偏移值
fillColor string 设置矢量图标的填充颜色。支持颜色常量字符串、十六进制、RGB、RGBA等格式
fillOpacity Number 设置矢量图标填充透明度,范围0~1
scale Number 设置矢量图标的缩放比例
rotation Number 设置矢量图标的旋转角度,参数为角度
strokeColor string 设置矢量图标的线填充颜色,支持颜色常量字符串、十六进制、RGB、RGBA等格式
strokeOpacity Number 设置矢量图标线的透明度,opacity范围0~1
strokeWeight Number 旋设置线宽。如果此属性没有指定,则线宽跟scale数值相同
SymbolShapeType
此枚举类型表示矢量图标类预设的图标样式。
常量
常量 描述
BMap_Symbol_SHAPE_CIRCLE 圆形,默认半径为1px
BMap_Symbol_SHAPE_RECTANGLE 矩形,默认宽度4px、高度2px
BMap_Symbol_SHAPE_RHOMBUS 菱形,默认外接圆半径10px
BMap_Symbol_SHAPE_STAR 五角星,五角星外接圆半径为10px
BMap_Symbol_SHAPE_BACKWARD_CLOSED_ARROW 箭头方向向下的闭合箭头
BMap_Symbol_SHAPE_FORWARD_CLOSED_ARROW 箭头方向向上的闭合箭头
BMap_Symbol_SHAPE_BACKWARD_OPEN_ARROW 箭头方向向下的非闭合箭头
BMap_Symbol_SHAPE_FORWARD_OPEN_ARROW 箭头方向向上的非闭合箭头
BMap_Symbol_SHAPE_POINT 定位点图标
BMap_Symbol_SHAPE_PLANE 预设的飞机形状
BMap_Symbol_SHAPE_CAMERA 预设的照相机形状
BMap_Symbol_SHAPE_WARNING 预设的警告符号
BMap_Symbol_SHAPE_SMILE 预设的笑脸形状
BMap_Symbol_SHAPE_CLOCK 预设的钟表形状

右键菜单类

ContextMenu
此类表示右键菜单。您可以在地图上添加自定义内容的右键菜单。
构造函数
构造函数 描述
ContextMenu() 创建一个右键菜单实例
方法
方法 返回值 描述
addItem(item: MenuItem) none 添加菜单项
getItem(index: Number) MenuItem 返回指定索引位置的菜单项,第一个菜单项的索引为0
removeItem(item: MenuItem) none 移除菜单项
addSeparato() none 添加分隔符
removeSeparator(index: Number) none 移除指定索引位置的分隔符,第一个分隔符的索引为0
事件
事件 参数 描述
open event{type, target, point, pixel} 右键菜单打开时触发,事件参数point和pixel分别表示菜单开启时的地理和像素坐标点
close event{type, target, point, pixel} 右键菜单关闭时触发,事件参数point和pixel分别表示菜单开启时的地理和像素坐标点
MenuItem
此类表示一个菜单项。
构造函数
构造函数 描述
MenuItem(text: String, callback: Function, opts: MenuItemOptions) 创建一个菜单项。当菜单项被点击时,系统将会以当前菜单弹出的地理坐标点作为参数调用回调函数callback
方法
方法 返回值 描述
setText(text: String) none 设置菜单项显示的文本
setIcon(iconUrl: String) none 设置菜单项的icon
enable() none 启用菜单项
disable() none 禁用菜单项
MenuItemOptions
此类表示MenuItem构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。
属性
属性 类型 描述
width Number 指定此菜单项的宽度,菜单以最长的菜单项宽度为准
id String 指定此菜单项dom的id
iconUrl String | ContextMenuIcon 指定此菜单项的icon URL(大小为17