百度地图JSAPI WebGL v1.0类参考

百度地图JSAPI WebGL v1.0类参考

核心类

Map

此类是地图API的核心类,用来实例化一个地图。请注意WebGL版本的地图API的命名空间是BMapGL。
示例:const map = new BMapGL.Map('container');

构造函数描述
Map(container: String | HTMLElement, opts: MapOptions )在指定的容器内创建地图实例,之后需要调用Map.centerAndZoom()方法对地图进行初始化。未进行初始化的地图将不能进行任何操作
方法返回值描述
enableDragging()none启用地图拖拽,默认启用
disableDragging()none禁用地图拖拽
enableInertialDragging()none启用地图惯性拖拽,默认禁用
disableInertialDragging()none禁用地图惯性拖拽
enableScrollWheelZoom()none允许地图可被鼠标滚轮缩放,默认禁用
disableScrollWheelZoom()none禁止地图被鼠标滚轮缩放
enableContinuousZoom()none开启双击平滑缩放效果
disableContinuousZoom()none关闭双击平滑缩放效果
enableResizeOnCenter()none开启图区resize中心点不变
disableResizeOnCenter()none关闭图区resize中心点不变
enableDoubleClickZoom()none启用地图双击缩放,左键双击放大、右键双击缩小
disableDoubleClickZoom()none取消地图双击缩放
enableKeyboard()none启用键盘操作,默认禁用。键盘的上、下、左、右键可连续移动地图。同时按下其中两个键可使地图进行对角移动。PgUp、PgDn、Home和End键会使地图平移其1/2的大小。+、-键会使地图放大或缩小一级
disableKeyboard()none禁用键盘操作
enablePinchToZoom()none启用双指缩放地图。
disablePinchToZoom()none禁用双指缩放地图。
setHeading()number设置地图旋转角度
setTilt()number设置地图的倾斜角度
enableAutoResize()none启用自动适应容器尺寸变化,默认启用
disableAutoResize()none禁用自动适应容器尺寸变化
checkResize()none地图容器变化后调用此方法用来重新铺图
setDisplayOptions({option: displayOptions })none设置地图元素
resize()none强制地图调整尺寸,此时会以当前容器尺寸为基准重新计算视野所需图像数据并重新绘制。当关闭自动调整视野时(`enableAutoResize` 配置),需要调用此方法来强制地图刷新。
getSize()Size返回地图当前尺寸,以像素表示
getContainerSize()Size获取地图容器尺寸
getZoomUnits()Number返回当前地图级别,一个像素对应多少单位的平面墨卡托坐标
getContainer()HTMLElement返回地图的DOM容器元素。当创建用户自定义控件时,需要自行实现Control.initialize()方法,并将控件的容器元素添加到地图上,通过此方法可获得地图容器
pixelToPoint(pixel: Pixel )Point像素坐标转换为经纬度坐标
pointToPixel(point: Point )Pixel经纬度坐标转换为像素坐标
lnglatToMercator(lng: Number, lat: Number)[McLng, McLat]经纬度球体坐标转换为墨卡托平面坐标
mercatorToLnglat(McLng: Number, lat: McLat)[lng, lat]墨卡托平面坐标转换为经纬度球体坐标
isLoaded()boolean返回地图是否经过centerAndZoom进行初始化
addSpots(spots: Array, options: Object)number添加地点区域,作为地图上的虚拟可点击区域。其中参数spots为热区点数组,options为可选配置参数;返回区域id。
getSpots(id: string)Array根据id返回地点区域数组
removeSpots(id: number)none根据id移除区域数组
clearSpots()none清除地点区域,此操作将清空所有虚拟可点数据
clearLabels()none清空当前map所有的自定义底图标注
addLabelsToMapTile(labels:Array)none在底图上添加文字,这些文字会和底图文字一同参与避让。
removeLabelsFromMapTile(labelUids:Array)none从底图上移除文字标注,参数为uid数组,根据数组里的uid进行移除
getIconByClickPosition(clickPosition: Pixel)Object | null通过点击坐标获取当前点中的底图icon,如果获取到返回其{name, uid, position},否则返回null
setBounds(bounds:Bounds)none设置地图可拖动区域,参数为地图拖拽的区域范围
getBounds()Bounds获取地图当前视野范围的矩形区域,以地理坐标表示。如果地图尚未初始化则返回一个空的 `Bounds` 实例。
getCoordType()string获取地图坐标类型,为CoordType常量
getMapStyleId()string获取当前地图样式id,对于内置样式则返回样式名称;对于自定义样式,则返回内部自动生成的样式id
getPanes()MapPanes获取覆盖物容器元素,返回地图覆盖物容器对象
getInfoWindow()InfoWindow | null获取当前打开的信息窗口实例,如果当前地图没有处于打开状态信息窗口,则返回 `null`
setDefaultCursor(cursor: String)none设置地图默认的鼠标指针样式。参数cursor应符合CSS的cursor属性规范
getDefaultCursor()String获取地图默认的鼠标指针样式,返回cursor值
setDraggingCursor(cursor: String)none设置拖拽地图时的鼠标指针样式。参数cursor应符合CSS的cursor属性规范
getDraggingCursor()String返回拖拽地图时的鼠标指针样式
setMinZoom(zoom: Number)none设置地图允许的最小级别。取值不得小于地图类型所允许的最小级别
setMaxZoom(zoom: Number)none设置地图允许的最大级别。取值不得大于地图类型所允许的最大级别
getDistance(start: Point , end: Point )Number返回两点之间的距离,单位是米
getMapType()MapTypeId返回地图类型
setViewport(view: Array<Point> | Viewport , viewportOptions: ViewportOptions )none根据提供的地理区域或坐标设置地图视野,调整后的视野会保证包含提供的地理区域或坐标
getViewport(view: Array< Point >, viewportOptions: ViewportOptions )Viewport根据提供的地理区域或坐标获得最佳的地图视野,返回的对象中包含center和zoom属性,分别表示地图的中心点和级别。此方法仅返回视野信息,不会将新的中心点和级别做用到当前地图上
centerAndZoom(center: Point , zoom: Number)none设初始化地图。 如果center类型为Point时,zoom必须赋值,范围3-19级,若调用高清底图(针对移动端开发)时,zoom可赋值范围为3-18级。如果center类型为字符串时,比如“北京”,zoom可以忽略,地图将自动根据center适配最佳zoom级别
panTo(center: Point )none将地图的中心点更改为给定的点,跳转到指定中心点进行渲染。如果该点在当前的地图视图中已经可见,则会以平滑动画的方式移动到中心点位置。可以通过配置强制移动过程不使用动画效果
panBy(x: Number, y: Number)none将地图在水平位置上移动x像素,垂直位置上移动y像素。如果指定的像素大于可视区域范围或者在配置中指定没有动画效果,则不执行滑动效果
flyTo(center: Point , zoom: Number)none飞到指定的中心点和级别,提供给定位缩放地图使用
reset()none重新设置地图,恢复地图初始化时的中心点和级别
setCenter(center: Point | String|, options: Object|)none设置地图中心点。center除了可以为坐标点以外,还支持城市名。可选配置参数包括'noAnimation: boolean'是否禁用动画效果;'callback: function'动画结束后调用此方法,如果没有动画则立即调用
getCenter()Point返回地图当前中心点
setMapType(mapTypeId: MapTypeId )none设置地图类型
setZoom(zoom: Number|,options|)none将视图切换到指定的缩放等级,中心点坐标不变。注意:当有信息窗口在地图上打开时,地图缩放将保证信息窗口所在的坐标位置不动。可选配置参数包括'noAnimation:boolean'是否禁用动画效果;'callback:function'动画结束后会调用此方法,如果没有动画则立即调用;'zoomCenter:Point'缩放中心点,默认以地图中心点为基准缩放
getZoom()Number返回地图当前缩放级别
zoomIn()none放大一级视图
zoomOut()none缩小一级视图
addControl(control: Control )none将控件添加到地图,一个控件实例只能向地图中添加一次
removeControl(control: Control )none从地图中移除控件。如果控件从未被添加到地图中,则该移除不起任何作用
addContextMenu(menu: ContextMenu )none添加右键菜单
removeContextMenu(menu: ContextMenu )none移除右键菜单
addOverlay(overlay: Overlay )none将覆盖物添加到地图中,一个覆盖物实例只能向地图中添加一次
removeOverlay(overlay: Overlay )none从地图中移除覆盖物。如果覆盖物从未被添加到地图中,则该移除不起任何作用
clearOverlays()none清除地图上所有覆盖物
pointToOverlayPixel(point: Point )Pixel根据地理坐标获取对应的覆盖物容器的坐标,此方法用于自定义覆盖物
overlayPixelToPoint(pixel: Pixel )Point根据覆盖物容器的坐标获取对应的地理坐标
getOverlays()Array< Overlay >获取当前地图上的所有覆盖物,返回覆盖物对象的集合
getPanes()MapPanes返回地图覆盖物容器列表
getCurrentMaxTilt()number获取当前地图允许的最大倾斜角度
hightlightSpotByUid(uid: string, tilePosStr: string)none根据 uid 将底图上的 poi 高亮显示,其中参数tilePosStr为label的位置字符串
resetSpotStatus()none重置热区状态,即将高亮的热区点取消
addAreaSpot()none重置热区状态,即将高亮的热区点取消
getAreaSpot(id: string)Array返回地点区域数组
removeAreaSpot(id: string)none移除区域数组
clearAreaSpots()none清除地点区域,此操作将清空所有虚拟可点数据
setTrafficOn()none开启路况图层
setTrafficOff()none关闭路况图层
showOverlayContainer()none显示覆盖物
hideOverlayContainer()none不显示覆盖物
setMapStyleV2(config: Object)none设置个性化地图,参数为个性化配置对象
startViewAnimation(viewAnimation: ViewAnimation)Number启动视角动画
cancelViewAnimation(viewAnimation: ViewAnimation)none停止视角动画
getMapScreenshot()url获取地图截图,地球模式不支持。需要初始化地图配置preserveDrawingBuffer:true,否则是黑屏
loadMapStyleFiles(callback: Function)none加载地图当前样式所需要的样式文件,callback为加载成功后的回调函数
setCopyrightOffset(logo: Object, cpy: Object)none设置版权信息位置,其中logo为logo位置,copyright为文字位置
destroy()none销毁地图,当使用 WebGL 渲染地图时,如果确认不再使用该地图实例,则需要调用本方法销毁 WebGL 上下文,否则频繁创建新地图实例会导致浏览器报:too many WebGL context 的警告
isSupportEarth()boolean判断浏览器是否支持地球,支持返回true,否则返回false

Map添加方法

方法名称参数返回值说明
addNormalLayerlayer:NormalLayer添加图层到地图实例对象
removeNormalLayerlayer:NormalLayer从地图实例对象移除图层
事件参数描述
click{type, target, latlng, pixel, overlay}左键单击地图时触发此事件。 当双击时,产生的事件序列为: click click dblclick
dblclick{type, target, pixel, point}鼠标双击地图时会触发此事件
rightclick{type, target, latlng, pixel, overlay}右键单击地图时触发此事件。 当双击时,产生的事件序列为: rightclick rightclick rightdblclick
rightdblclick{type, target, latlng, pixel, overlay}右键双击地图时触发此事件
maptypechange{type, target}地图类型发生变化时触发此事件
mousemove{type, target, latlng, 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}拖拽地图过程中触发
onstyle_loaded_error{type, target}个性化样式加载失败触发(只适用于个性化地图使用监听)
onstyle_loaded_timeout{type, target}个性化样式加载超时失败触发(只适用于个性化地图使用监听)
dragend{type, target, pixel, point}停止拖拽地图时触发
resize{type, target, size}地图可视区域大小发生变化时会触发此事件

MapOptions

此类表示Map构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。

属性类型描述
minZoomNumber地图允许展示的最小级别
maxZoomNumber地图允许展示的最大级别
mapTypeMapTypeId地图类型,默认为BMAP_NORMAL_MAP
enableAutoResizeBoolean开启自动适应地图容器变化,默认启用
enableTiltBoolean是否允许地图倾斜
enableRotateBoolean是否允许地图旋转
enableRotateGesturesBoolean是否允许通过手势旋转地图。
enableTiltGesturesBoolean是否允许通过手势倾斜地图。
overlayTopBoolean覆盖物是否显示在文字上面,默认false
fixCenterWhenPinchBoolean手势缩放是否固定中心点,默认不固定,由手指中心点决定
displayOptionsObject配置地图显示元素。该参数详细信息请参见 setDisplayOptions方法

Viewport

此类代表视野,不可实例化,通过对象字面量形式表示。

属性类型描述
centerPoint视野中心点
zoomNumber视野级别

ViewportOptions

此类作为map.getViewport与map.setViewport方法的可选参数,不可实例化。

属性类型描述
noAnimationBoolean是否启用动画效果移动地图,默认为true。当调整后的级别与当前地图级别一致时,将使用动画效果移动地图
marginsArray<Number>视野调整的预留边距,例如: margins: [30, 20, 0, 20] 表示坐标点会限制在上述区域内
zoomFactorNumber地图级别的偏移量,您可以在方法得出的结果上增加一个偏移值。例如map.setViewport计算出地图的级别为10,如果zoomFactor为-1,则最终的地图级别为9
delayNumber改变地图视野的延迟执行时间,单位毫秒,默认为200ms。此延时仅针对动画效果有效

LabelsToMapTiles

map的addLabelsToMapTile方法支持向底图上添加可参与碰撞的label

属性类型描述
positionPoint墨卡托坐标
displayRangeArray显示的级别范围,[fromZoom, toZoom]
textMarginnumber文字距离坐标位置的像素边距
namestring显示的文字内容
namestring显示的文字内容
styleObject样式。支持如下配置信息

style样式。支持如下配置信息:

属性类型描述
fontSizenumber文字大小
colorstring文字颜色,合法的css颜色值
haloSizenumber文字描边尺寸
strokeColorstring描边颜色,合法的css颜色值
iconstring如果添加icon则需要给icon的url
iconSizeiconSize:Arrayicon的宽度和高度,按照1x的显示尺寸给出,[width, height]
guidstring文字对应的唯一标识
directionnumber文字位于坐标的方向,取值为:0, 1, 2, 3, 4 分别表示bottom, right, top, left, center
ranknumber权重,值越高优先级越高
typestring类型,默认为fixed(固定标注),此外还有line(道路标注)、biaopai(标牌)

displayOptions

此类代表设置地图显示元素,不可实例化。

属性类型描述
poiboolean是否显示POI信息。注意:`poi`、`poiText`与`poiIcon`均用来配置POI显示,当`poi`为`true`时,可配置另外两个选项;如果为`false`,则另外两个选项不再生效。
poiTextboolean是否显示POI文字信息
poiIconboolean是否显示POI的Icon
overlayboolean是否显示覆盖物
buildingboolean是否显示3D建筑物(仅支持 WebGL 方式渲染的地图)
indoorboolean是否显示室内图(仅支持 WebGL 方式渲染的地图)
streetboolean是否显示路网(只对卫星图和地球模式有效)
skyColorArray配置天空的颜色,数组中首个元素表示地面颜色,第二个元素表示天空颜色。从而形成渐变,支持只传入一个元素

基础类

Point

此类表示一个地理坐标点。

构造函数描述
Point(lng: Number, lat: Number)以指定的经度和纬度创建一个地理点坐标
属性类型描述
lngNumber地理经度
latNumber地理纬度
方法返回值描述
equals(other: Point )Boolean判断坐标点是否相等,当且仅当两点的经度和纬度均相等时返回true

Pixel

此类表示地图上的一点,单位为像素。

构造函数描述
Pixel(x: Number, y: Number)创建像素点对象实例。像素坐标的坐标原点为地图区域的左上角
属性类型描述
xNumberx坐标
yNumbery坐标
方法返回值描述
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)以指定的宽度和高度创建一个矩形区域大小对象
属性类型描述
widthNumber水平方向的数值
heightNumber竖直方向的数值
方法返回值描述
equals(other: Size )Boolean当且仅当此矩形中的宽度和高度都等于其他矩形的宽度和高度时,返回true

控件类

Control

此类是所有控件的基类,您可以通过此类来实现自定义控件。所有控件均包含Control类的属性、方法和事件。通过Map.addControl()方法可将控件添加到地图上。

构造函数描述
Control()创建一个控件原型实例,通过该原型实例可创建自定义控件
属性类型描述
defaultAnchorControlAnchor控件默认的停靠位置。自定义控件时需要提供此属性,作为控件的默认停靠位置
defaultOffsetSize控件默认的位置偏移值。自定义控件时需要提供此属性,作为控件的默认偏移位置
方法返回值描述
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控件将定位到地图的右下角

NavigationControl3D

此类表示地图的3D控件,可以对地图进行旋转以及切换地图2D、3D展示效果。

构造函数描述
NavigationControl3D(opts: NavigationControl3DOptions )创建一个特定样式的地图平移缩放控件

NavigationControl3DOptions

此类表示NavigationControl3D构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。

属性类型描述
anchorControlAnchor控件的停靠位置
offsetSize控件的偏移值

ScaleControl

此类表示比例尺控件。

构造函数描述
ScaleControl(opts: ScaleControlOptions )创建一个比例尺控件
方法返回值描述
getUnit()LengthUnit返回比例尺单位制
setUnit(unit: LengthUnit )none设置比例尺单位制

ScaleControlOptions

此类表示ScaleControl构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。

属性类型描述
anchorControlAnchor控件的停靠位置
offsetSize控件的偏移值

LengthUnit

常量表示长度单位制。

常量描述
BMAP_UNIT_METRIC公制单位
BMAP_UNIT_IMPERIAL英制单位

ZoomControl

此类表示缩放控件。

构造函数描述
ZoomControl(opts: ZoomControlOptions )创建一个缩放控件

ZoomControlOptions

此类表示ZoomControl构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。

属性类型描述
anchorControlAnchor控件的停靠位置
offsetSize控件的偏移值

覆盖物类

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方法可获得该对象实例。

属性类型描述
floatPaneHTMLElement信息窗口所在的容器
markerMouseTargetHTMLElement标注点击区域所在的容器
floatShadowHTMLElement信息窗口阴影所在的容器
labelPaneHTMLElement文本标注所在的容器
markerPaneHTMLElement标注图标所在的容器

Marker

此类表示地图上的一个图像标注。

构造函数描述
Marker(point: Point , opts: MarkerOptions )创建一个图像标注实例。point参数指定了图像标注所在的地理位置
方法返回值描述
setIcon(icon: Icon )none设置标注所用的图标对象
getIcon()Icon返回标注所用的图标对象
setPosition(position: Point )none设置标注的地理坐标
getPosition()Point返回标注的地理坐标
setOffset(offset: Size )none设置标注的偏移值
getOffset()Size返回标注的偏移值
setTitle(title: String)none设置标注的标题,当鼠标移至标注上时显示此标题
getTitle()String返回标注的标题
setLabel(label: Label )none为标注添加文本标注
getLabel()Label返回标注的文本内容
enableDragging()none开启标注拖拽功能
disableDragging()none关闭标注拖拽功能
enableMassClear()none允许覆盖物在map.clearOverlays方法中被清除
disableMassClear()none禁止覆盖物在map.clearOverlays方法中被清除
setZIndex(zIndex: Number)none设置覆盖物的zIndex
getMap()Map返回覆盖物所在的map对象
setRotation(rotation: Number)none设置点的旋转角度
getRotation()Number获取点的旋转角度
addEventListener(event: String, handler: Function)none添加事件监听函数
removeEventListener(event: String, handler: Function)none移除事件监听函数

MarkerOptions

此类表示Marker构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。

属性类型描述
offsetSize标注的位置偏移值
iconIcon标注所用的图标对象
enableMassClearBoolean是否在调用map.clearOverlays清除此覆盖物,默认为true
enableDraggingBoolean是否启用拖拽,默认为false
enableClickingBoolean是否响应点击事件。默认为true
raiseOnDragBoolean拖拽标注时,标注是否开启离开地图表面效果。默认为false
draggingCursorString拖拽标注时的鼠标指针样式。此属性值需遵循CSS的cursor属性规范
rotationNumber旋转角度
titleString鼠标移到marker上的显示内容

Symbol

此类表示canvas画布创建的图标

构造函数描述
Symbol(size: Size, anchor: Size)创建一个canvas图标实例。size为图像的大小,anchor为锚点位置,默认为size的中心点。
属性类型描述
isReDrawboolean是否启动循环渲染,需要保证size纹理大小不发生变化。需要在初始化时就需要设置true,后续可以设置false、true。如果初始化的时候不想动画,可以在add方法中设置false。
dataImageData图标数据,通过更新这个值,来改变展示的图标
overlayOverlay可读。在添加到地图后可以调用。
方法返回值描述
add()none添加覆盖物时,触发此方法
render(map: BMapGL)boolean渲染覆盖物时,触发此方法
remove()none删除覆盖物时,触发此方法
update()none触发一次渲染,isReDraw是true时不需要使用此方法。

SVGSymbol

此类表示通过svg的path string创建的矢量图标类,继承Symbol类。

构造函数描述
SVGSymbol(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
etFillColor(color: string)none设置矢量图标的填充颜色。支持颜色常量字符串、十六进制、RGB、RGBA等格式

SymbolOptions

此类表示Symbol构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。

属性类型描述
anchorSize符号的位置偏移值
fillColorstring设置矢量图标的填充颜色。支持颜色常量字符串、十六进制、RGB、RGBA等格式
fillOpacityNumber设置矢量图标填充透明度,范围0~1
scaleNumber设置矢量图标的缩放比例
rotationNumber设置矢量图标的旋转角度,参数为角度
strokeColorstring设置矢量图标的线填充颜色,支持颜色常量字符串、十六进制、RGB、RGBA等格式
strokeOpacityNumber设置矢量图标线的透明度,opacity范围0~1
strokeWeightNumber设置线宽。如果此属性没有指定,则线宽跟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预设的钟表形状

GroundOverlay

当GroundOverlayOptions的type为canvas时,GroundOverlayOptions增加以下属性:

属性类型描述
isReDrawboolean是否开启,默认false
drawHookFunction回调方法,作用为生成canvas数据,默认null,如果要启用回调,在初始化时就需要设置此值。

Icon

此类表示标注覆盖物所使用的图标。

构造函数描述
Icon(url: String, size: Size , opts: IconOptions )以给定的图像地址和大小创建图标对象实例
属性类型描述
anchorSize图标的定位点相对于图标左上角的偏移值
sizeSize图标可视区域的大小
imageOffsetSize图标所用的图片相对于可视区域的偏移值,此功能的作用等同于CSS中的background-position属性
imageSizeSize图标所用的图片的大小,此功能的作用等同于CSS中的background-size属性。可用于实现高清屏的高清效果
imageUrlString图标所用图像资源的位置
printImageUrlString设置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设置图片相对于可视区域的偏移值

IconOptions

此类表示Icon构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。

属性类型描述
anchorSize图标的定位锚点。此点用来决定图标与地理位置的关系,是相对于图标左上角的偏移值,默认等于图标宽度和高度的中间值
imageOffsetSize图片相对于可视区域的偏移值

InfoWindow

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

构造函数描述
InfoWindow(content: String | HTMLElement, opts: InfoWindowOptions )创建一个信息窗实例,其中content支持HTML内容。
方法返回值描述
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移除事件监听函数
事件参数描述
closeevent{type, target, point}信息窗口被关闭时触发此事件
openevent{type, target, point}信息窗口被打开时触发此事件
maximizeevent{type, target}信息窗口最大化后触发此事件
restoreevent{type, target}信息窗口还原时触发此事件
clickcloseevent{type, target}点击信息窗口的关闭按钮时触发此事件

InfoWindowOptions

此类表示InfoWindow构造函数的可选参数,它没有构造函数,但可通过对象字面量形式表示。

属性类型描述
widthNumber信息窗宽度,单位像素。取值范围:0, 220 - 730。如果您指定宽度为0,则信息窗口的宽度将按照其内容自动调整
heightNumber信息窗高度,单位像素。取值范围:0, 60 - 650。如果您指定高度为0,则信息窗口的高度将按照其内容自动调整
maxWidthNumber信息窗最大化时的宽度,单位像素。取值范围:220 - 730
offsetSize信息窗位置偏移值。默认情况下在地图上打开的信息窗底端的尖角将指向其地理坐标,在标注上打开的信息窗底端尖角的位置取决于标注所用图标的infoWindowOffset属性值,您可以为信息窗添加偏移量来改变默认位置
titleString信息窗标题文字,支持HTML内容
enableAutoPanBoolean是否开启信息窗口打开时地图自动移动(默认开启)
enableCloseOnClickBoolean是否开启点击地图关闭信息窗口(默认开启)

CustomOverlay

自定义覆盖物,继承 BMapGL.Overlay

构造函数描述
new BMapGL.CustomOverlay(domCreate:Function,options?
: BMapGL.CustomOverlayOptions);
自定义覆盖物

方法

方法返回值描述
setPoint(point: Point,noReCreate?: boolean):void设置点
setRotation(rotation: number)void获取旋转角
setRotationOrigin(origin: string)void设置DOM初始旋转角
getRotation()number获取旋转角
getPoint()BMapGL.Point获取点
setProperties(properties: any)void设置属性
getProperties()any获取属性

CustomOverlayOptions

自定义覆盖物构造函数配置参数

数据项类型描述
pointBMapGL.Point坐标点
anchors[number.number]锚点,左上角为[0,0],取值范围[0,1],默认[0.5,1]
offsetXnumberx轴偏移量,单位像素
offsetYnumbery轴偏移量,单位像素
rotationnumber旋转角
rotationInitnumber初始化旋转角
minZoomnumber显示最小等级
maxZoomnumber显示最大等级
propertiesany自定义属性
fixBottomboolean是否固定在div底部, 默认false,
有25px历史硬编码,因为已经存在使用用户,
故使用参数进行修复
useTranslateboolean是否使用translate3d进行优化
autoFollowHeadingChangedboolean是否跟随地图旋转
visibleboolean是否显示
zIndexnumber层级

GroundPoint

构造函数描述
new BMapGL.GroundPoint(point: BMapGL.Point,
opts?: BMapGL.GroundPointOptions );
贴地点覆盖物,继承BMapGL.GroundOverlay
数据项类型描述
setPoint(point: Point,update?: boolean):void设置位置点
setScale(scale: number, update?: boolean)void设置缩放比例
setSize(size: BMapGL.Size, update?: boolean)void设置尺寸,单位像素坐标
setRotation(angle: number, update?: boolean)void设置旋转角
setAnchor(anchor: BMapGL.Size, update?: boolean)void设置锚点位置
setOffset(offset: BMapGL.Size, update?: boolean)void设置偏移量

GroundPointOptions

贴地点覆盖物构造函数配置参数,继承GroundOverlayOptions

数据项类型描述
urlstring图标地址
sizeBMapGL.Size坐标点尺寸,单位像素
anchorBMapGL.Size锚点,默认中心点[0,0]
scalenumber缩放比例,默认1
rotationnumber旋转角,默认0
offsetBMapGL.Size偏移量,默认[0,0]
levelnumber尺寸相对层级,默认18

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移除事件监听函数
事件参数描述
clickevent{type, target}点击文本标注后会触发此事件
dblclickevent{type, target}双击文本标注后会触发此事件
mousedownevent{type, target}鼠标在文本标注上按下触发此事件
mouseupevent{type, target}鼠标在文本标注释放触发此事件
mouseoutevent{type, target}鼠标离开文本标注时触发此事件
mouseoverevent{type, target}当鼠标进入文本标注区域时会触发此事件
removeevent{type, target}移除文本标注时触发
rightclickevent{type, target}右键点击标注时触发此事件

LabelOptions

此类表示Lable构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。

属性类型描述
offsetSize文本标注的位置偏移值
positionPoint文本标注的地理位置
enableMassClearBoolean是否在调用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关闭编辑功能
setZIndex(zIndex: Number)none设置覆盖物的zIndex
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移除事件监听函数

PolylineOptions

此类表示Polyline构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。

属性类型描述
strokeColorString折线颜色
strokeWeightNumber折线的宽度,以像素为单位
strokeOpacityNumber折线的透明度,取值范围0 - 1
strokeStyleString折线的样式,solid或dashed
strokeLineCapstring|StyleExpress描边线端头类型,可选'round', 'butt', 'square',默认round
enableMassClearBoolean是否在调用map.clearOverlays清除此覆盖物,默认为true
enableEditingBoolean是否启用线编辑,默认为false
enableClickingBoolean是否响应点击事件,默认为true
geodesicBoolean是否开启大地线模式,true时,两点连线将以大地线的形式。默认为false
linkRightBoolean跨180度走右侧,默认是false
clipBoolean是否进行跨经度180度裁剪,绘制跨精度180时为了优化效果,可以设置成false,默认为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移除事件监听函数

PolygonOptions

此类表示Polygon构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。

属性类型描述
strokeColorString边线颜色
fillColorString填充颜色。当参数为空时,折线覆盖物将没有填充效果
strokeWeightNumber边线的宽度,以像素为单位
strokeOpacityNumber边线透明度,取值范围0 - 1
fillOpacityNumber填充的透明度,取值范围0 - 1
strokeStyleString边线的样式,solid或dashed
enableMassClearBoolean是否在调用map.clearOverlays清除此覆盖物,默认为true
enableEditingBoolean是否启用线编辑,默认为false
enableClickingBoolean是否响应点击事件,默认为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移除事件监听函数

CircleOptions

Circle类构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。

属性类型描述
strokeColorString圆形边线颜色
fillColorString圆形填充颜色。当参数为空时,圆形将没有填充效果
strokeWeightNumber圆形边线的宽度,以像素为单位
strokeOpacityNumber圆形边线透明度,取值范围0 - 1
fillOpacityNumber圆形填充的透明度,取值范围0 - 1
strokeStyleString圆形边线的样式,solid或dashed
enableMassClearBoolean是否在调用map.clearOverlays清除此覆盖物,默认为true
enableEditingBoolean是否启用线编辑,默认为false
enableClickingBoolean是否响应点击事件,默认为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返回图层显示的最大级别
事件参数描述
clickevent{type, target}鼠标点击图层后会触发此事件
dblclickevent{type, target}鼠标双击图层后会触发此事件

GroundOverlayOptions

GroundOverlay类构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。

属性类型描述
opacityNumber图层透明度
imageURLString图层地址
displayOnMinLevelNumber图层显示的最小级别
displayOnMaxLevelNumber图层显示的最大级别

BezierCurve

此类表示一个二阶贝塞尔曲线覆盖物

构造函数描述
BezierCurve(points: Array< Point >, controlPoints: Array< Point >, opts: BezierCurveOptions )创建二阶贝塞尔曲线覆盖物,构造函数中必须定义坐标点和曲线的控制点
方法返回值描述
setPath(path: Array< Point >)none设置曲线的路径点
getPath()Array< Point >返回曲线的路径点
setControlPoints(path: Array< Point >)none设置曲线的控制点,每两个路径点之间可以有1或2个控制点,比如路径点有三个点,那个控制点的格式可以是:[ [cp1, cp2], [ cp3 ] ],其中cp1和cp2为路经点1到2的控制点,cp3为路径点2到3的控制点
getControlPoints()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返回覆盖物的地理区域范围
enableMassClear()none允许覆盖物在map.clearOverlays方法中被清除
disableMassClear()none禁止覆盖物在map.clearOverlays方法中被清除
getMap()Map返回覆盖物所在的map对象
addEventListener(event: String, handler: Function)none添加事件监听函数
removeEventListener(event: String, handler: Function)none移除事件监听函数

BezierCurveOptions

此类表示BezierCurve构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。

属性类型描述
strokeColorString折线颜色
strokeWeightNumber折线的宽度,以像素为单位
strokeOpacityNumber折线的透明度,取值范围0 - 1
strokeStyleString折线的样式,solid或dashed
enableMassClearBoolean是否在调用map.clearOverlays清除此覆盖物,默认为true

Prism

此类表示一个棱柱覆盖物

构造函数描述
Prism(points: Array< Point >, altitude: Number, opts: PrismOptions )创建棱柱覆盖物,构造函数中需要定义底面和高度
方法返回值描述
setPath(path: Array< Point >)none设置底面多边形的点数组
getPath()Array< Point >返回底面多边形的点数组
setAltitude(altitude: Number)none设置棱柱的高,单位:米
getAltitude()Number返回棱柱的高,单位:米
setTopFillColor(color: String)none设置棱柱顶面的填充颜色
getTopFillColor()String返回棱柱顶面的填充颜色
setTopFillOpacity(opacity: Number)none设置棱柱顶面透明度,取值范围0 - 1
getTopFillOpacity()Number返回棱柱顶面透明度
setSideFillColor(color: String)none设置棱柱侧面的填充颜色
getSideFillColor()String返回棱柱侧面的填充颜色
setSideFillOpacity(opacity: Number)none设置棱柱侧面透明度,取值范围0 - 1
getSideFillOpacity()Number返回棱柱侧面透明度
enableMassClear()none允许覆盖物在map.clearOverlays方法中被清除
disableMassClear()none禁止覆盖物在map.clearOverlays方法中被清除
getMap()Map返回覆盖物所在的map对象
addEventListener(event: String, handler: Function)none添加事件监听函数
removeEventListener(event: String, handler: Function)none移除事件监听函数

PrismOptions

此类表示PrismOptions构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。

属性类型描述
topFillColorString顶面填充颜色
topFillOpacityNumber顶面填充颜色透明度,取值范围0 - 1
sideFillColorString侧面填充颜色
sideFillOpacityNumber侧面填充颜色透明度,取值范围0 - 1
enableMassClearBoolean是否在调用map.clearOverlays清除此覆盖物,默认为true

右键菜单类

ContextMenu

此类表示右键菜单。您可以在地图上添加自定义内容的右键菜单。

构造函数描述
ContextMenu()创建一个右键菜单实例
方法返回值描述
addItem(item: MenuItem)none添加菜单项
getItem(index: Number)MenuItem返回指定索引位置的菜单项,第一个菜单项的索引为0
removeItem(item: MenuItem)none移除菜单项
addSeparator()none添加分隔符
removeSeparator(index: Number)none移除指定索引位置的分隔符,第一个分隔符的索引为0
事件参数描述
openevent{type, target, point, pixel}右键菜单打开时触发,事件参数point和pixel分别表示菜单开启时的地理和像素坐标点
closeevent{type, target, point, pixel}右键菜单关闭时触发,事件参数point和pixel分别表示菜单开启时的地理和像素坐标点

MenuItem

此类表示一个菜单项。

构造函数描述
MenuItem(text: String, callback: Function, opts: MenuItemOptions)创建一个菜单项。当菜单项被点击时,系统将会以当前菜单弹出的地理坐标点作为参数调用回调函数callback
方法返回值描述
setText(text: String)none设置菜单项显示的文本
enable()none启用菜单项
disable()none禁用菜单项

MenuItemOptions

此类表示MenuItem构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。

属性类型描述
widthNumber指定此菜单项的宽度,菜单以最长的菜单项宽度为准
idString指定此菜单项dom的id

地图类型类

MapTypeId

地图类型常量

常量描述
BMAP_NORMAL_MAP此地图类型展示普通街道视图
BMAP_SATELLITE_MAP此地图类型展示普通卫星地图
BMAP_EARTH_MAP此地图类型展示地球卫星视图

地图图层类

TileLayer

此类表示一个地图图层,您可以向地图中添加自定义图层。

构造函数描述
TileLayer(opts: TileLayerOptions)创建一个地图图层实例
方法返回值描述
getTilesUrl(tileCoord: Pixel, zoom: Number)String抽象。向地图返回地图图块的网址,图块索引由tileCoord的x和y属性在指定的缩放级别zoom提供。如果您在TileLayerOptions中提供了tileUrlTemplate参数,则可不实现此接口
isTransparentPng()Number如果图层所用的图片为PNG格式并且包含透明信息,则返回true

TileLayerOptions

此类表示TileLayer构造函数的可选参数

属性类型描述
transparentPngBoolean是否使用了带有透明信息的PNG。由于IE6不支持PNG透明,因此需要特殊处理
tileUrlTemplateString指定图块网址模板,该模板可以针对每个图块请求而展开,以根据现有的图块坐标系引用唯一的图块。模板的格式应该为:http://yourhost/tile?x={X}&y={Y}&z={Z}.png 其中X和Y分别指纬度和经度图块坐标,Z指缩放级别,比如: http://yourhost/tile?x=3&y=27&z=5.png 如果您没有提供图块网址模板,您需要实现TileLayer.getTileUrl()抽象方法
zIndexNumber图层的zIndex

ParkingSpot

此类用于在地图上叠加智能停车位图层,可以实时显示室内/室外停车位的状态、车位区剩余数据等信息。

类名说明
ParkingSpot(options)智能停车位类

options配置属性

参数类型说明
callbackfunction点击回调函数
方法参数返回值说明
map.addParkingSpot(layer)layer: ParkingSpotnull在地图上添加智能停车图层

GeoJSONParse

此类满足用户将geojson数据解析为符合百度地图坐标的Overlay数据,用户可得到Overlay属性、坐标数据,进行覆盖物实例化或者其他处理。

构造函数描述
BMapGL.GeoJSONParse(options)构建GeoJSON解析类。输入坐标支持options的reference设置类型,输出统一为百度09经纬度。
参数名称类型描述
referenceobject来源数据的坐标系,可选择:BD09LL|BD09MC|EPSG3857|GCJ02|WGS84,默认是:BD09LL
方法名称参数返回值说明
readFeatureFrom
Object(geojson_feature,
options)
1.geojson_feature为GeoJSON
{"type":"Feature"}数据 2.options: { reference:string,//同构造函数reference isPoints:boolean,//是否为点集合,
默认为false markerStyle:Function
(properties):MarkerOptions
||MarkerOptions,//点类型数据样式
polylineStyle:Function(properties)
:PolylineOptions ||
PolylineOptions,//线类型数据样式
polygonStyle:Function(properties)
:PolygonOptions || PolygonOptions,
//面类型数据样式 样式1:Value,
//覆盖物统一样式 样式2:Value,
//覆盖物统一样式 ......}
1,如果isPoints为false,返回实例化的覆盖物,如果是muti几何要素,会返回多个覆盖物Object,否则返回单个覆盖物Object。2,如果isPoints为true,返回Object的points为坐标序列点 3,属性存储在Object.properties中如果设置了options.reference,则优先使用方法的options.reference。 如果isPoints为false,且不设置样式,则使用覆盖物默认样式。 如果设置了类型样式,则优先使用类型样式,无则使用统一样式
readFeaturesFrom
Object(geojson,options,
callback)
1.geojson为GeoJSON
{"type":"FeatureCollection"}数据
1. options: { reference:string,//
同构造函数reference isPoints:boolean,
// 是否为点集合,默认为false
markerStyle: Function(properties)
:MarkerOptions||MarkerOptions,
// 点类型数据样式 polylineStyle:
Function(properties):PolylineOptions
||PolylineOptions, //线类型数据样式
polygonStyle:Function
(properties):PolygonOptions
||PolygonOptions, // 面类型数据样式
样式1:Value, // 覆盖物统一样式
样式2:Value, // 覆盖物统一样式
......} 3.callback:Function(Overlay or Object)
如果isPoints为false,返回实例化的覆盖物Overlay集合。如果isPoints为true,返回Object的集合,Object.points为坐标序列点;Object.properties为属性。如果设置了options.reference,则优先使用方法的options.reference。 如果isPoints为false,且不设置样式,则使用覆盖物默认样式。 如果设置了类型样式,则优先使用类型样式,无则使用统一样式。

GeoJSONLayer

BMapGL.Map添加以下方法: addGeoJSONLayer(layer:GeoJSONLayer) removeGeoJSONLayer(layer:GeoJSONLayer)

构造函数描述
BMapGL.GeoJSONLayer(layerName:string,options:Object)构建GeoJSONLayer覆盖物组合图层类。layerName为图层名设置,每个覆盖物都将写入layerName属性;options详见下表。
参数名称类型描述
dataSourceObjectGeoJSON解构数据
referenceObject来源数据的坐标系,可选择:BD09LL|BD09MC|EPSG3857|GCJ02|WGS84,默认是:BD09LL
markerStyleFunction(properties):MarkerOptions||MarkerOptions点类型数据样式,配置项详见BMapGL.Marker的MarkerOptions配置内容
polylineStyleFunction(properties):PolylineOptions||PolylineOptions线类型数据样式,配置项详见BMapGL.Polyline的PolylineOptions配置内容
polygonStyleFunction(properties):PolygonOptions||PolygonOptions面类型数据样式,配置项详见BMapGL.Polygon的PolygonOptions配置内容
minZoomnumber最小显示层级,默认3
maxZoomnumber最大显示层级,默认21
levelnumber显示层级,由于系统内部问题,GeoJSONLayer图层等级使用负数表达,负数越大层级越高,默认-99
visibleboolean图层数据是否显示,默认true
方法名称参数返回值说明
setData(geojson:Object)geojson 结构数据设置图层显示的数据源
getData()覆盖物对象集合获取覆盖物对象集合
clearData()清空地图上的覆盖物数据,以及覆盖物对象集合
resetStyle()样式重置到图层初始化状态
pickOverlays(e:Event)e 地图事件对象事件关联的覆盖物对象集合通过事件获取当前包含当前点的覆盖物集合
setLevel(z:number)z 显示层级设置显示层级
getLevel()number获取显示层级
setVisible(v:boolean)v 是否显示设置是否显示
getVisible()boolean获取显示状态
destroy()清空地图上的覆盖物数据,且清空覆盖物对象集合,以及关联的map对象。
addEventListener
(type:string,function:Function)
type 事件类型,支持'click','mousemove','mouseout' function(e:Event) 为触发事件后的回调函数添加事件,回调函数function入参为Event对象,其中features属性为触发的要素实例集合,默认为null。
removeEventListener
(type:string,function:Function)
type 事件类型,支持'click','mousemove','mouseout' function 定义的回调函数移除事件

NormalLayer

提供基础图层类的框架方法,支持注册、注销事件。用户可以继承此类进行自定义图层的开发。

构造函数描述
BMapGL.NormalLayer(options)基础图层类,继承BMapGL.BaseClass类,可实现事件的注册与移除。可设置图层的显示/隐藏,最大最小缩放等级,层级,透明度,是否允许鼠标悬浮选中,是否允许鼠标点击选中,事件是否支持冒泡。
参数名称类型描述
visibleboolean是否显示,默认true
opacitynumber透明度,默认是1,取值范围为0-1
minZoomnumber最小显示缩放等级,默认3
maxZoomnumber最大显示缩放等级,默认21
zIndexnumber显示层级,默认1,初始化时会自动根据图层组进行调整
enablePickedboolean是否允许鼠标点击事件,默认false
autoSelectboolean是否允许鼠标悬浮事件,默认false
popEventboolean事件是否冒泡,默认true
pickWidthnumber点击拾取矩形宽,默认30,单位像素
pickHeightnumber点击拾取矩形高,默认30,单位像素
方法名称参数返回值说明
onAdd1.map:BMapGL.Map
2.gl:GL
添加到地图时回调此方法
preRender1.map:BMapGL.Map
2.matrix:Matrix
图层渲染前调用
render1.gl:GL
2.matrix:Matrix
3.opt:Object
图层渲染调用,opt.isPickRender 为true,则代表是离屏渲染,计算点击数据
getPickedItem1.index:number
2.model:string
null或者
{dataIndex: number,
dataItem:Object}
根据数据索引,获取数据项,通过事件返回。model取值:onmousemove,onclick
afterRender1.gl:GL
2.matrix:Matrix
图层渲染后调用
onDestroy1.map:BMapGL.Map
2.gl:GL
图层渲染后调用
onHide1.map:BMapGL.Map
2.gl:GL
小于minZoom 或者 大于 maxZoom 会自动调用这个方法
onShow1.map:BMapGL.Map
2.gl:GL
onHide状态进入onShow时,会调用这个方法
doOnceDraw触发图层渲染
setZIndexzIndex:number设置图层叠加顺序,如果当前zIndex已使用,替换当前位置,当前位置图层顺次后移。
setZIndexTop将当前图层设置为最上层,原位置数据置空
setUpLevel向上移动一层,如果已经是顶层则不移动
setDownLevel向下移动一层,如果已经是低层则不移动
getZIndexnumber获取图层层级
setVisibleboolean设置图层显示隐藏状态
getVisibleboolean获取图层显示隐藏状态
setOpacitynumber设置图层透明度,默认是1,取值范围为0-1
getOpacitynumber获取图层透明度
setMinZoomnumber设置图层最小显示等级
getMinZoomnumber获取图层最小显示等级
setMaxZoomnumber设置图层最大显示等级
getMaxZoomnumber获取图层最大显示等级

FeatureLayer

要素图层基础类,继承自NormalLayer类,属于内部类。

构造函数描述
FeatureLayer(options)要素图层类,继承BMapGL.NormalLayer类,可设置图层的的数据来源坐标系、唯一标识属性名、选中数据项索引、选中数据改变颜色。

options定义结构如下:

参数名称类型描述
idKeystring数据项属性key
crsstring来源坐标系,默认BD09LL,其他BD09MC、GCJ02
selectedIndexnumber选中数据索引,默认-1
selectedColorstring选中数据颜色,默认'rgba(20, 20, 200, 1.0)'
方法名称参数返回值说明
setDataGeoJSON设置数据源为GeoJSON数据对象
getDatageojson获取数据源
updateState1.keys:Array 2.params:Object
3.ifAppend:boolean 是否追加状态添加
根据的id,设置对象状态
removeStatekeys:Array根据的id,移出对象状态
clearState清空对象状态
addDelIndexnumber添加不显示数据索引
removeDelIndexnumber移除不显示数据索引
clearDelIndex清空不显示数据索引

PointIconLayer

构造函数

构造函数说明
BMapGL.PointIconLayer(options)继承FeatureLayer类,支持点图标的渲染。

options属性除FeatureLayer参数外,增加以下参数:

参数名称二级参数名称类型描述
isFlatboolean是否是贴地图标,默认true
isFixedboolean是否保持图标跟随地图层级改变而尺寸不变,默认true
styleobject线图层显示样式配置对象
iconstring|StyleExpress图标地址,url
iconObj(style,properties)=> {id:number,canvas:HTMLCanvasElement}通过函数形式返回图标,id代表图标标识,canvas代码图标来源
sizes[number,number]点的大小
widthnumber|StyleExpress点的宽度大小
heightnumber|StyleExpress点的高度大小
userSizesboolean是否使用sizes的宽高,还是使用width和height。默认true
anchors[number,number]坐标点对应的锚点,中间点为[0,0],取值范围[-1,1]
offset[number,number]偏移量
scalenumber|StyleExpress缩放比例
rotationnumber|StyleExpress旋转角度
opacitynumber|StyleExpress透明度

LineLayer

在支持实线、虚线的基础上支持描边线、纹理贴图线、间隔图标填充。

构造函数描述
BMapGL.LineLayer(options)继承FeatureLayer类,在基础实线、虚线的基础上支持描边线、纹理贴图线、间隔图标填充。

options属性除FeatureLayer参数外,增加以下参数:

参数名称二级参数名称类型描述
styleobject线图层显示样式配置对象
sequenceboolean是否,采用间隔填充纹理,默认false
marginLengthnumber间隔距离,默认16,单位像素
borderMaskboolean是否受内部填充区域掩膜,默认true,如果存在borderWeight小于0,则自动切换false
borderColorstring|StyleExpress描边颜色
borderWeightnumber|StyleExpress描边宽度,可以设置负值
strokeTextureUrlstring|StyleExpress填充纹理图片地址,默认是空。图片需要是竖向表达,在填充时会自动横向处理。
strokeTextureWidthnumber|StyleExpress填充纹理图片宽度,需要是2的n次方
strokeTextureHeightnumber|StyleExpress填充纹理图片长度,需要是2的n次方
strokeLineJoinstring|StyleExpress描边线连接处类型,可选'miter', 'round', 'bevel',默认miter
strokeLineCapstring|StyleExpress描边线端头类型,可选'round', 'butt', 'square',默认round
strokeColorstring|StyleExpress描边线颜色,默认#dec41b
strokeWeightnumber|StyleExpress描边线宽度,默认0
strokeOpacitynumber|StyleExpress描边线透明度,默认1
strokeStylestring|StyleExpress描边线类型,可选'solid'、'dashed' 和 'dotted',默认solid
dashArrayarray|StyleExpress描边线虚线设置,默认[8,4]表示实线部分长8像素,间隙部分长4像素

FillLayer

构造函数:

构造函数描述
BMapGL.FillLayer(options)继承FeatureLayer类,在基础面、描边的基础上支持纹理(或者掩膜)填充。

options属性除FeatureLayer参数以及LineLayer的style参数外,增加以下参数:

参数名称二级参数名称类型描述
borderboolean是否显示描边,默认false
styleobject线图层显示样式配置对象
fillColorstring|StyleExpress填充颜色
fillOpacitynumber|StyleExpress填充透明度
patternboolean是否采用纹理填充形式,默认false
patternMaskboolean是否采用纹理掩膜形式,默认true,即只采用纹理图片的透明度,不使用颜色。如果是false,则会使用纹理图片的颜色
patternUrlstring雪碧图片纹理地址,默认空
patternMappingstring|StyleExpress雪碧图左上角位置以及宽度、高度。以图像左上角为(0,0)起点,默认是'0, 0, 32, 32',即开始位置0,0宽度高度分别为32,32的图像区域
patternScalenumber|StyleExpress图片纹理的缩放比例,默认1
patternOffsetstring|StyleExpress图片纹理的偏移距离占局部纹理宽高比,取值范围为[0,1],默认0,0

XYZLayer

此类用于添加第三方标准图层。

构造函数描述
XYZLayer(options)XYZLayer实例化TileLayer,用于添加第三方标准图层,通过options设置图层瓦片请求地址、显示等级、显示范围等。
属性类型描述
tileUrlTemplateString图像数据请求地址。可通过{0,1,2}标记实现多请求地址的配置;可通过[z],[x],[y],[b]引用默认的*Template。WMTS/TMS/自定义栅格图层服务默认使用[z],[x],[y],瓦片大小为256*256。WMS服务默认使用[b]。
xTemplateFunction通过输入的网格x、y、z参数计算[x]具体返回值。x、y、z参数对应是Google web墨卡托网格的列号、行号、缩放等级。
yTemplateFunction通过输入的网格x、y、z参数计算[y]具体返回值。x、y、z参数对应是Google web墨卡托网格的列号、行号、缩放等级。
zTemplateFunction通过输入的网格x、y、z参数计算[z]具体返回值。x、y、z参数对应是Google web墨卡托网格的列号、行号、缩放等级。
bTemplateFunction通过输入的网格x、y、z参数计算[b]具体返回值,返回值默认为四至坐标拼接成的字符串:’minX,minY,maxX,maxY’。x、y、z参数对应是Google web墨卡托网格的列号、行号、缩放等级。
minZoomNumber设置图层显示的最小缩放等级。
maxZoomNumber设置图层显示的最大缩放等级。
extentArray设置图层加载数据的四至范围,输入的范围数值默认为EPSG:3857坐标[minX,minY,maxX,maxY]。
extentCRSIsWGS84Boolean标记参数extend数组数据是否为EPSG:4326坐标。默认false,如果设置为true,参数extent数值需要是EPSG:4326 坐标。
boundaryArray设置图层掩膜。可通过BMapGL.Boundary()获取行政区域的坐标数据。
useThumbDataBoolean缩放图层时,是否使用跨图层的瓦片进行平滑切换。默认false。如果影响透明图层的展示效果,可以设置false;如果非透明图层,可以设置true。
tmsBooleantileUrlTemplate中[y]是否为tms请求服务形式。默认false。如果是则设置为true。
方法返回值描述
addBoundary(boundaries: Array)none设置图层掩膜。boundaries可通过BMapGL.Boundary()获取行政区域的坐标数据。
clearBoundary()none清空图层掩膜。
setZIndex(index:Number)none设置图层显示层级,数字越大,显示越靠上。
setZIndexTop()none设置图层显示等级为最上层。

MVTLayer

MVTLayer类定义如下:

构造函数描述
BMapGL.MVTLayer(options)MVTLayer继承XYZLayer参数,实例化TileLayer,用于添加MVT标准图层,通过options设置图层瓦片请求地址、显示等级、显示范围、显示图层、图层样式等。

options属性除XYZLayer参数外,增加以下参数:

参数名称二级参数名称三级参数名称类型描述
transformobject坐标系转换参数
sourcestring来源网格数据的坐标系,可选择:BD09MC|EPSG3857|GCJ02,默认是:BD09MC
targetstring目标数据的坐标系(用户可以不进行设置),默认是:BD09MC
gridModelstring网格类型,可选择:BMapGL.MVTLayer.GridModel.GOOGLEWEB或者BMapGL.MVTLayer.GridModel.BAIDUEWEB,默认是BAIDUEWEB
spanLevelnumber跨网格等级加载数据,默认0。建议使用-1。
noCollisionboolean点数据是否不参与碰撞,默认true,即不参与碰撞
useThumbboolean缩放过程中是否使用跨图层数据,默认true
encryptboolean是否是加载慧图平台加密数据,默认false
idPropertystring通过要素属性字段赋值要素id,默认首先读取feature的id属性,其次读取feature的properties中的id,都没有则是undefined。如果缺失id,会造成一个瓦片的一个图层中只能解析一个几何数据。
layersarray可解析的图层,线面名称顺序对应渲染顺序,对应style中的key,默认则从数据源中所有layer中划分点、线、面三个图层数据。说明:显示顺序永远是【点>线>面】
styleobject图层显示样式配置对象
layerNamestringayers参数为默认,则layerName取'point'|'line'|'fill';layers参数为图层名数组,则layerName是layers中任一个
typestring支持polygon、polyline、point三种图层类型
visibleboolean是否显示,默认true
minZoomnumber最小显示等级,默认3
maxZoomnumber最大显示等级,默认23
painterobject样式设置,详见PointPainterObject、PolylinePainterObject、PolygonPainterObject

PointPainterObject

参数名称类型描述
namestring|StyleExpress文字,默认空
fontSizenumber|StyleExpress文字大小,默认22
colorstring|StyleExpress文字颜色,默认#0d20c9
haloSizenumber|StyleExpress文字描边大小,默认2
strokeColorstring|StyleExpress文字描边颜色,默认#fff
iconstring|StyleExpress图标地址,默认空,如果symbolPath与icon同时存在,会优先使用icon
iconSizearray|StyleExpress图标大小,默认[32, 32]
symbolPathstring|StyleExpresssvg图标Path或者内置的14种图形(具体查看SymbolShapeType),默认空
symbolFillColorstring|StyleExpresssvg图标填充色,默认#000
symbolFillOpacitynumber|StyleExpresssvg图标填充色透明度,默认1
symbolScalenumber|StyleExpresssvg图标缩放比例,默认1
symbolRotationnumber|StyleExpresssvg图标旋转角度,默认0
symbolStrokeColorstring|StyleExpresssvg图标描边色,默认#000
symbolStrokeOpacitynumber|StyleExpresssvg图标描边透明度,默认0
symbolStrokeWeightnumber|StyleExpresssvg图标描边宽度,默认0
textOnIconboolean|StyleExpress是否有文字背景图标,默认false
textOnIconSizearray|StyleExpress文字背景图标大小,默认[32, 32]
textOnIconUrlstring|StyleExpress文字背景图标地址,默认空
textMarginnumber|StyleExpress对象距离坐标的位置,默认0
directionnumber|StyleExpress文字位于图标的方向,取值为:0, 1, 2, 3, 4 分别表示bottom, right, top, left, center
visibilityboolean|StyleExpress是否显示

PolylinePainterObject

参数名称类型描述
strokeLineJoinstring|StyleExpress线连接处类型,可选'miter', 'round', 'bevel',默认miter
strokeLineCapstring|StyleExpress线端头类型,可选'round', 'butt', 'square',默认round
strokeColorstring|StyleExpress线颜色,默认#142655
strokeWeightnumber|StyleExpress线宽度,默认2
strokeOpacitynumber|StyleExpress线透明度,默认1
strokeStylestring|StyleExpress线类型,可选'solid'、'dashed' 和 'dotted',默认solid
dashArrayarray|StyleExpress线虚线设置,默认[8,4]表示实线部分长8像素,间隙部分长4像素
visibilityboolean|StyleExpress是否显示

PolygonPainterObject

参数名称类型描述
fillColorstring|StyleExpress面填充颜色,默认#142655
fillOpacitynumber|StyleExpress面填充透明度,默认1
strokeLineJoinstring|StyleExpress描边线连接处类型,可选'miter', 'round', 'bevel',默认miter
strokeLineCapstring|StyleExpress描边线端头类型,可选'round', 'butt', 'square',默认round
strokeColorstring|StyleExpress描边线颜色,默认#dec41b
strokeWeightnumber|StyleExpress描边线宽度,默认0
strokeOpacitynumber|StyleExpress描边线透明度,默认1
strokeStylestring|StyleExpress描边线类型,可选'solid'、'dashed' 和 'dotted',默认solid
dashArrayarray|StyleExpress描边线虚线设置,默认[8,4]表示实线部分长8像素,间隙部分长4像素
visibilityboolean|StyleExpress是否显示

StyleExpress是由get、case、match、step、boolean等嵌套组成的数组对象

表达式名表达式结构含义示例
get["get", string]返回当前要素的属性["get", "name"] 返回当前要素属性name的值
feature-state["feature-state", string]返回当前要素的状态值,通过方法,人为设置['feature-state', 'picked'] 返回当前要素状态picked的值
boolean["boolean", value]:boolean ["boolean", value, fallback: value, fallback: value, ...]格式化 value 的值为boolean类型,fallback为默认值['boolean', ['feature-state', 'picked'], false] 格式化要素状态picked的值为boolean,失败则返回false
case["case", condition: boolean, output: OutputType, condition: boolean, output: OutputType,..., fallback: OutputType]类似if else,根据条件判断哪个满足,如果满足返回数据,不满足返回默认数据['case', ['boolean', ['feature-state', 'picked'], false], 'yellow', 'red'] 如果picked为true,则返回'yellow',否则返回'red'
match["match",input:InputType(number or string),label: InputType | [InputType, InputType,...], output: OutputType,label: InputType |[InputType, InputType,...], output: OutputType,...,fallback: OutputType]类似switch case,input为输入值,label为是否相等值,output为如果相等则输出的值,最后的fallback为默认值。['match', ['get', 'name'], '海淀区', '#ce4848', '房山区', '#6704ff', '朝阳区', 'yellow', '#ff8b1a'] 当前要素的属性name值,如果等于'海淀区',则输出颜色'#ce4848';如果等于'房山区',则输出颜色'#6704ff';如果等于'朝阳区'',则输出颜色'yellow';其余输出颜色'#ff8b1a'
step["step", input: number, stop_output_0: OutputType, stop_input_1: number, stop_output_1: OutputType, stop_input_n: number, stop_output_n: OutputType, ...]类似if else,根据条件判断input数值,如果input小于等于stop_input_1,则输出stop_output_0;如果stop_input_1=stop_input_n,则输出stop_output_n['step',['get','age'],'#666',18,'#999',60,'#fff'] 如果属性age<=18,则输出'#666';如果18=60,则输出'#fff'
方法名参数返回值说明
updateState1. keys:Array2. params:Object 3. ifAppend:boolean 是否追加状态添加根据Entity的id+layerName,设置对象状态
clearState清空对象状态
setZIndexnumber设置图层等级
getZIndexnumber获取图层等级
setZIndexTop设置图层最顶层
setUpLevel设置图层上移一层
setDownLevel设置图层下移一层
setStyleoptions.style重新设置整体的样式

事件

事件名回调方法说明
onclickfunction (e) {}e.value是选中的要素数据Array,默认为null
ondbclickfunction (e) {}e.value是选中的要素数据Array,默认为null
onmousemovefunction (e) {}e.value是选中的要素数据Array,默认为null
onmouseoutfunction (e) {}e.value是选中的要素数据Array,默认为null

Entity

构造方法 BMapGL.Entity(id:string,layerName:string)

属性名类型描述
idstring要素标识
layerNamestring图层名称
propertiesObjectObject

视角动画类

ViewAnimation

地图视角动画类。

构造函数描述
ViewAnimation(keyFrames: Array<ViewAnimationKeyFrames>, opts: ViewAnimationOptions)创建地图视角动画对象,通过关键帧的形式对动画进行定义
事件参数描述
animationstart{}动画开始时触发,如果配置了delay,则在delay后触发
animationiterations{}当动画循环大于1次时,上一次结束既下一次开始时触发。最后一次循环结束时不触发
animationend{}动画结束时触发,如果动画中途被终止,则不会触发
animationcancel{}动画中途被终止时触发

ViewAnimationKeyFrames

此类表示地图视角动画的关键帧,通过定义关键帧,API会补全关键帧之间过渡的动画过程。

属性类型描述
centerPoint地图中心点,默认值为地图当前状态中心点
zoomNumber地图缩放级别,默认值为地图当前状态缩放级别
tiltNumber地图倾斜角度,默认值为地图当前状态倾斜角度
headingNumber地图旋转角度,默认值为地图当前旋转角度
percentageNumber表示当前关键帧处于动画过程的百分比,取值范围0~1

ViewAnimationOptions

此类表示地图视角动画的配置。

属性类型描述
delayNumber动画开始延迟时间,单位ms,默认0
durationNumber动画持续时间,单位ms,默认1000
interationNumber | string循环次数,参数类型为数字时循环固定次数,参数为'INFINITE'无限循环,默认为1

服务类

LocalSearch

用于位置检索、周边检索和范围检索。

构造函数描述
LocalSearch(location: Map | Point | String, opts: LocalSearchOptions )创建一个搜索类实例,其中location表示检索区域,其类型可为地图实例、坐标点或城市名称的字符串。当参数为地图实例时,检索位置由当前地图中心点确定,且搜索结果的标注将自动加载到地图上,并支持调整地图视野层级;当参数为坐标时,检索位置由该点所在位置确定;当参数为城市名称时,检索会在该城市内进行
方法返回值描述
search(keyword: String | Array<String>, option: Object)none根据检索词发起检索。当keyword为数组时将同时执行多关键字的查询,最多支持10个关键字,多关键字自 1.2 版本支持。option:{forceLocal:Boolean, customData:CustomData} forceLocal表示是否将搜索范围约束在当前城市,customData表示检索lbs云服务的数据
searchInBounds(keyword: String | Array<String>, bounds: Bounds , option: Object)none根据范围和检索词发起范围检索。当keyword为数组时将同时执行多关键字检索,最多支持10个关键字,多关键字自 1.2 版本支持。option:{customData:CustomData} customData表示检索lbs云服务的数据
searchNearby(keyword: String | Array<String>, center: LocalResultPoi | String | Point , radius: Number, option: Object)none根据中心点、半径与检索词发起周边检索。当keyword为数组时将同时执行多关键字的检索,最多支持10个关键字,多关键字自 1.2 版本支持。当center为字符串时,半径参数将忽略。注意:Point类型的中心点自 1.1 版本支持。option:{customData:CustomData} customData表示检索lbs云服务的数据
getResults()LocalResult | Array<LocalResult>返回最近一次检索的结果。如果是多关键字范围检索,则返回一个LocalResult的数组,数组中的结果顺序和范围检索中多关键字数组中顺序一致
clearResults()none清除最近一次检索的结果
gotoPage(page: Number)none检索特定页面的结果
enableAutoViewport()none启用根据结果自动调整地图层级,当指定了搜索结果所展现的地图时有效
disableAutoViewport()none禁用根据结果自动调整地图层级
enableFirstResultSelection()none启用自动选择第一个检索结果
disableFirstResultSelection()none禁用自动选择第一个检索结果
setLocation(location: Map | Point | String)none设置检索范围,参数类型可以为地图实例、坐标点或字符串。例:setLocation("北京市")
setPageCapacity()none设置每页容量,取值范围:1 - 100,对于多关键字检索,每页容量表示每个关键字返回结果的数量(例如当用2个关键字检索时,实际结果数量范围为:2 - 200)。此值只对下一次检索有效
getPageCapacity()Number返回每页容量,对于多关键字检索,返回每个关键字对应的页面容量
setSearchCompleteCallback()none设置检索结束后的回调函数。参数:results: LocalResult 或 Array 如果是多关键字检索,回调函数参数为LocalResult的数组,数组中的结果顺序和检索中多关键字数组中顺序一致
setMarkersSetCallback(callback: Function)none设置添加标注后的回调函数。参数: pois: Array ,通过marker属性可得到其对应的标注
setInfoHtmlSetCallback(callback: Function)none设置标注气泡创建时的回调函数。参数: poi: LocalResultPoi,通过其marker属性可得到当前的标注。 html: HTMLElement,气泡内的Dom元素
setResultsHtmlSetCallback(callback: Function)none设置结果列表创建后的回调函数。参数: container: HTMLElement,结果列表所用的HTML元素
getStatus()StatusCodes返回状态码

LocalSearchOptions

此类表示LocalSearch构造函数的可选参数。

属性类型描述
renderOptionsLocalRenderOptions结果呈现设置
onMarkersSetFunction标注添加完成后的回调函数。 参数: pois: Array ,通过marker属性可得到其对应的标注
onInfoHtmlSetFunction标注气泡内容创建后的回调函数。 参数: poi: LocalResultPoi,通过其marker属性可得到当前的标注。 html: HTMLElement,气泡内的Dom元素
onResultsHtmlSetFunction结果列表添加完成后的回调函数。 参数: container: HTMLElement,结果列表所用的HTML元素
pageCapacityNumber设置每页容量,取值范围:1 - 100,对于多关键字检索,容量表示每个关键字的数量,如果有2个关键字,则实际检索结果数量范围为:2 - 200
onSearchCompleteFunction检索完成后的回调函数。 参数:results: LocalResult或Array 如果是多关键字检索,回调函数参数返回一个LocalResult的数组,数组中的结果顺序和检索中多关键字数组中顺序一致

CustomData

此类表示检索lbs云服务的数据。它没有构造函数,但可通过对象字面量形式表示。 要检索lbs云服务的数据,需要在引用api的时候在参数后加上lbs云平台的key。

属性类型描述
geotableIdNumberlbs云v2接口,可在lbs云平台上查看自己的geotableId
tagsString空格分隔的多字符串
filterString过滤条件,参考:lbsyun.baidu.com/index.php?title=lbscloud/api/geosearch

RenderOptions

此类表示搜索结果呈现的配置。它没有构造函数,但可通过对象字面量形式表示。

属性类型描述
mapMap展现结果的地图实例。当指定此参数后,搜索结果的标注、线路等均会自动添加到此地图上
panelString | HTMLElement结果列表的HTML容器id或容器元素,提供此参数后,结果列表将在此容器中进行展示。此属性对LocalCity无效。驾车路线规划无效
selectFirstResultBoolean是否选择第一个检索结果。此属性仅对LocalSearch有效
autoViewportBoolean检索结束后是否自动调整地图视野。此属性对LocalCity无效

LocalResult

类表示LocalSearch的检索结果,没有构造函数,通过LocalSearch.getResults()方法或LocalSearch的onSearchComplete回调函数的参数得到。

属性类型描述
keywordString本次检索的关键词
centerLocalResultPoi周边检索的中心点(仅当周边检索时提供)
radiusNumber周边检索的半径(仅当周边检索时提供)
boundsBounds范围检索的地理区域(仅当范围检索时提供)
cityString本次检索所在的城市
moreResultsUrlString更多结果的链接,到百度地图进行搜索
provinceString本次检索所在的省份
suggestionsArray<String>搜索建议列表。(当关键词是拼音或拼写错误时给出的搜索建议)
方法返回值描述
getPoi(i: Number)LocalResultPoi返回索引指定的结果。索引0表示第1条结果
getCurrentNumPois()Number返回当前页的结果数
getNumPois()Number返回总结果数
getNumPages()Number返回总页数
getPageIndex()Number返回页数序号
getCityList()Array<Object>返回城市列表。数组元素对象包含如下属性: city: String,城市名 numResults: Number,结果数

LocalResultPoi

此类表示位置检索或路线规划的一个结果点,没有构造函数,可通过对象字面量形式表示。

属性类型描述
titleString结果的名称标题
pointPoint该结果所在的地理位置
urlString在百度地图中展示该结果点的详情信息链接
addressString地址(根据数据部分提供)。注:当结果点类型为公交站或地铁站时,地址信息为经过该站点的所有车次
cityString所在城市
phoneNumberString电话,根据数据部分提供
postcodeString邮政编码,根据数据部分提供
typePoiType类型,根据数据部分提供
isAccurateBoolean是否精确匹配。只适用LocalSearch的search方法检索的结果
provinceString所在省份
tagsArray<String>POI的标签,如商务大厦、餐馆等。目前只有LocalSearch的回调函数onSearchComplete(result)中的result和Geocoder.getLocation的回调函数的参数GeocoderResult.surroundingPois涉及的LocalResultPoi有tags字段。其他API涉及的LocalResultPoi没有该字段
detailUrlString在百度地图详情页面展示该结果点的链接。localsearch的结果中才有

PoiType

此枚举常量表示地点的类型。

常量描述
BMAP_POI_TYPE_NORMAL一般位置点
BMAP_POI_TYPE_BUSSTOP公交车站位置点
BMAP_POI_TYPE_SUBSTOP地铁车站位置点

TransitRoute

用于获取公交线路规划方案。

构造函数描述
TransitRoute(location: Map | Point | String, opts: TransitRouteOptions )创建一个公交导航实例。location表示检索区域,类型可为地图实例、坐标点或城市名称的字符串。当参数为地图实例时,检索位置由当前地图中心点确定;当参数为坐标时,检索位置由该点所在位置确定;当参数为城市名称时,检索会优先在该城市内进行
方法返回值描述
search(start: Point | LocalResultPoi, end: Point | LocalResultPoi)none发起检索。 start: 起点,参数可以坐标点或者LocalSearchPoi实例。 end: 终点,参数可以是坐标点或者LocalSearchPoi实例,3.0版本暂不支持起终点参数为关键字,开发者可以先用检索接口确认关键字的坐标点
getResults()TransitRouteResult返回最近一次检索的结果
clearResults()none清除最近一次检索的结果
enableAutoViewport()none启用自动调整地图层级,当指定了搜索结果所展现的地图时有效
disableAutoViewport()none禁用自动调整地图层级
setPageCapacity(capacity: Number)设置每页返回方案个数(1-5),默认为5
setPolicy(policy: TransitPolicy )none设置城市内换乘策略
setIntercityPolicy(intercityPolicy: IntercityPolicy )none设置跨城换乘策略
setTransitTypePolicy(transitTypePolicy: TransitTypePolicy )none设置跨城交通方式策略
setSearchCompleteCallback(callback: Function)none设置检索结束后的回调函数。 参数: results: TransitRouteResult,公交导航结果
setMarkersSetCallback(callback: Function)none设置添加标注后的回调函数。 参数: pois: Array ,起点和目的地数组。 transfers: Array ,公交车站数组
setInfoHtmlSetCallback(callback: Function)none设置气泡打开后的回调函数。 参数: poi: LocalResultPoi,表示当前气泡对应的点(可以是起点、终点或换乘车站) html: HTMLElement,气泡内的DOM元素
setPolylinesSetCallback(callback: Function)none设置添加路线后的回调函数。 参数: lines: Array ,公交线路数组。 routes: Array ,步行线路数组,通过Route.getPolyline()方法可得到对应的折线覆盖物
setResultsHtmlSetCallback(callback: Function)none设置结果列表创建后的回调函数。 参数: container: 结果列表所用的HTML元素
getStatus()StatusCodes返回状态码
toString()String返回线路规划对象类型

TransitRouteOptions

此类表示TransitRoute构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。

属性类型描述
renderOptionsRenderOptions搜索结果的呈现设置
policyTransitPolicy市内公交的策略参数
intercityPolicyIntercityPolicy跨城公交的换乘策略参数
transitTypePolicyTransitTypePolicy跨城公交的交通方式策略参数
pageCapacityNumber返回方案的个数
onSearchCompleteFunction检索完成后的回调函数。参数:results: TransitRouteResult,公交导航结果
onMarkersSetFunction标注添加完成后的回调函数。参数:pois: Array ,起点和目的地数组。transfers: Array ,公交车站数组
onInfoHtmlSetFunction气泡内容创建后的回调函数。参数:poi: LocalResultPoi,表示当前气泡对应的点(可以是起点、终点或换乘车站)html: HTMLElement,气泡内的DOM元素
onPolylinesSetFunction折线添加完成后的回调函数。参数:lines: Array ,公交线路数组。routes: Array ,步行线路数组,通过Route.getPolyline()方法可得到对应的折线覆盖物
onResultsHtmlSetFunction结果列表添加完成后的回调函数。参数:container: 结果列表所用的HTML元素

TransitPolicy

此常量表示市内公交方案换乘策略。

常量描述
BMAP_TRANSIT_POLICY_RECOMMEND推荐方案
BMAP_TRANSIT_POLICY_LEAST_TIME最少时间
BMAP_TRANSIT_POLICY_LEAST_TRANSFER最少换乘
BMAP_TRANSIT_POLICY_LEAST_WALKING最少步行
BMAP_TRANSIT_POLICY_AVOID_SUBWAYS不乘地铁
BMAP_TRANSIT_POLICY_FIRST_SUBWAYS优先地铁

IntercityPolicy

此常量表示跨城公交换乘策略。

常量描述
BMAP_INTERCITY_POLICY_LEAST_TIME时间短
BMAP_INTERCITY_POLICY_EARLY_START出发早
BMAP_INTERCITY_POLICY_CHEAP_PRICE价格低

TransitTypePolicy

此常量表示跨城交通方式策略。

常量描述
BMAP_TRANSIT_TYPE_POLICY_TRAIN火车优先
BMAP_TRANSIT_TYPE_POLICY_AIRPLANE飞机优先
BMAP_TRANSIT_TYPE_POLICY_COACH大巴优先

TransitRouteResult

此类表示路线导航的结果,没有构造函数,通过访问TransitRoute.getResults()方法或TransitRoute的onSearchComplete回调函数参数获得。

属性类型描述
policyTransitPolicy公交导航策略
intercityPolicyIntercityPolicy跨城策略(仅跨城时有)
transitTypePolicyTransitTypePolicy跨城交通方式策略(仅跨城时有)
方法返回值描述
getStart()()LocalResultPoi返回起点
getEnd()()LocalResultPoi返回终点
getNumPlans()()Number返回方案个数
getPlan(i: Number)(i: Number)TransitRoutePlan返回索引指定的方案。索引0表示第一条方案
getTransitType()()TransitType返回公交出行方案的类型

TransitRoutePlan

此类表示一条公交出行方案。没有构造函数,通过TransitRouteResult.getPlan()方法获得。

方法返回值描述
getNumLines()Number返回方案包含的公交线路段数(如果是跨城检索,还包括飞机、火车、大巴线路)
getLine(i: Number)Line返回方案包含的某条公交线路(如果是跨城检索,还包括飞机、火车、大巴线路)
getNumRoutes()Number返回方案包含的步行线路段数
getRoute(i: Number)
getDistance(format: Boolean)String | Number返回方案总距离。当format参数为true时,返回方案距离字符串(包含单位),当format为false时,仅返回数值(单位为米)信息。默认参数为true
getDuration(format: Boolean)String | Number返回方案总时间。当format参数为true时,返回描述时间的字符串(包含单位),当format为false时,仅返回数值(单位为秒)信息。默认参数为true
getDescription(includeHtml: Boolean)String返回方案描述文本,默认包含HTML标签。当includeHtml为false时,方案描述不包含HTML标签
getTotalType(i: Number)TransitPlanType返回指定路段的交通方式类型,分别对应Line和Route
getTotal(i: Number)Route | Line返回整个方案包含的某段线路,根据方案的数据情况,返回值可能是步行对象Route也有可能是线路对象Line
getNumTotal()Number总路段数量

TransitType

此常量表示出行方案的类型

常量描述
BMAP_TRANSIT_TYPE_IN_CITY国内市内换乘
BMAP_TRANSIT_TYPE_CROSS_CITY国内跨城换乘

LineType

此枚举类型标识不同类型的交通线路类型,其中包括了市内公交和跨城公交。

常量描述
BMAP_LINE_TYPE_BUS公交车
BMAP_LINE_TYPE_SUBWAY地铁
BMAP_LINE_TYPE_FERRY轮渡
BMAP_LINE_TYPE_TRAIN火车
BMAP_LINE_TYPE_AIRPLANE飞机
BMAP_LINE_TYPE_COACH大巴

WalkingRoute

用于获取步行路线规划方案。

构造函数描述
WalkingRoute(location: Map | Point | String, opts: WalkingRouteOptions )创建一个步行导航实例。location表示检索区域,类型可为地图实例、坐标点或城市名称的字符串。当参数为地图实例时,检索位置由当前地图中心点确定;当参数为坐标时,检索位置由该点所在位置确定;当参数为城市名称时,检索会在该城市内进行
方法返回值描述
search(start: String | Point | LocalResultPoi , end: String | Point | LocalResultPoi )none发起检索。 start: 起点,参数可以是关键字、坐标点(自1.1版本支持)或者LocalSearchPoi实例。 end: 终点,参数可以是关键字、坐标点(自1.1版本支持)或者LocalSearchPoi实例
getResults()WalkingRouteResult返回最近一次检索的结果
clearResults()none清除最近一次检索的结果
enableAutoViewport()none启用自动调整地图层级,当指定了搜索结果所展现的地图时有效
disableAutoViewport()none禁用自动调整地图层级
setLocation(location: Map | Point | String)none设置检索范围,参数类型可以为地图实例、坐标点或字符串。例:setLocation("北京市")
setSearchCompleteCallback(callback: Function)none设置检索结束后的回调函数。 参数: results: WalkingRouteResult
setMarkersSetCallback(callback: Function)none设置添加标注后的回调函数。 参数: pois: Array ,起点和目的地点数组。通过marker属性可得到其对应的标注
setInfoHtmlSetCallback(callback: Function)none设置气泡打开后的回调函数。 参数: poi: LocalResultPoi,通过其marker属性可得到当前的标注。 html: HTMLElement,气泡内的DOM元素
setPolylinesSetCallback(callback: Function)none设置添加路线后的回调函数。 参数: routes: Array ,步行线路数组,通过Route.getPolyline()方法可得到对应的折线覆盖物
setResultsHtmlSetCallback(callback: Function)none设置结果列表创建后的回调函数。 参数: container: 结果列表所用的HTML元素
getStatus()StatusCodes返回状态码
toString()String返回类型说明

WalkingRouteOptions

此类表示WalkingRoute构造函数的可选参数。

属性类型描述
renderOptionsRenderOptions搜索结果呈现设置
onSearchCompleteFunction检索完成后的回调函数。 参数: results: WalkingRouteResult
onMarkersSetFunction标注添加完成后的回调函数。 参数: pois: Array ,起点和目的地点数组,。通过marker属性可得到其对应的标注
onPolylinesSetFunction折线添加完成后的回调函数。 参数: routes: Array ,步行线路数组,通过Route.getPolyline()方法可得到对应的折线覆盖物
onInfoHtmlSetFunction标注气泡内容创建后的回调函数。 参数: poi: LocalResultPoi,通过其marker属性可得到当前的标注。 html: HTMLElement,气泡内的DOM元素
onResultsHtmlSetFunction结果列表添加完成后的回调函数。 参数: container: 结果列表所用的HTML元素

WalkingRouteResult

此类表示路线导航的结果,没有构造函数,通过访问WalkingRoute.getResults()方法或WalkingRoute的onSearchComplete回调函数参数获得。

方法返回值描述
getStart()LocalResultPoi返回起点
getEnd()LocalResultPoi返回终点
getNumPlans()Number返回方案个数
getPlan(i: Number)RoutePlan返回索引指定的方案。索引0表示第一条方案

RidingRoute

用于获取骑行路线规划方案。

构造函数描述
RidingRoute(location: Map | Point | String, opts: RidingRouteOptions )创建一个骑行导航实例。location表示检索区域,类型可为地图实例、坐标点或城市名称的字符串。当参数为地图实例时,检索位置由当前地图中心点确定;当参数为坐标时,检索位置由该点所在位置确定;当参数为城市名称时,检索会在该城市内进行
方法返回值描述
search(start: String | Point | LocalResultPoi , end: String | Point | LocalResultPoi )none发起检索。 start: 起点,参数可以是关键字、坐标点(自1.1版本支持)或者LocalSearchPoi实例。 end: 终点,参数可以是关键字、坐标点(自1.1版本支持)或者LocalSearchPoi实例
getResults()RidingRouteResult返回最近一次检索的结果
clearResults()none清除最近一次检索的结果
enableAutoViewport()none启用自动调整地图层级,当指定了搜索结果所展现的地图时有效
disableAutoViewport()none禁用自动调整地图层级
setLocation(location: Map | Point | String)none设置检索范围,参数类型可以为地图实例、坐标点或字符串。例:setLocation("北京市")
setSearchCompleteCallback(callback: Function)none设置检索结束后的回调函数。 参数: results: RidingRouteResult
setMarkersSetCallback(callback: Function)none设置添加标注后的回调函数。 参数: pois: Array ,起点和目的地点数组。通过marker属性可得到其对应的标注
setInfoHtmlSetCallback(callback: Function)none设置气泡打开后的回调函数。 参数: poi: LocalResultPoi,通过其marker属性可得到当前的标注。 html: HTMLElement,气泡内的DOM元素
setPolylinesSetCallback(callback: Function)none设置添加路线后的回调函数。 参数: routes: Array ,骑行线路数组,通过Route.getPolyline()方法可得到对应的折线覆盖物
setResultsHtmlSetCallback(callback: Function)none设置结果列表创建后的回调函数。 参数: container: 结果列表所用的HTML元素
getStatus()StatusCodes返回状态码
toString()String返回类型说明

RidingRouteOptions

此类表示RidingRoute构造函数的可选参数。

属性类型描述
renderOptionsRenderOptions搜索结果呈现设置
onSearchCompleteFunction检索完成后的回调函数。 参数: results: RidingRouteResult
onMarkersSetFunction标注添加完成后的回调函数。 参数: pois: Array ,起点和目的地点数组,。通过marker属性可得到其对应的标注
onPolylinesSetFunction折线添加完成后的回调函数。 参数: routes: Array ,骑行线路数组,通过Route.getPolyline()方法可得到对应的折线覆盖物
onInfoHtmlSetFunction标注气泡内容创建后的回调函数。 参数: poi: LocalResultPoi,通过其marker属性可得到当前的标注。 html: HTMLElement,气泡内的DOM元素
onResultsHtmlSetFunction结果列表添加完成后的回调函数。 参数: container: 结果列表所用的HTML元素

RidingRouteResult

此类表示骑行路线导航的结果,没有构造函数,通过访问RidingRoute.getResults()方法或RidingRoute的onSearchComplete回调函数参数获得。

方法返回值描述
getStart()()LocalResultPoi返回起点
getEnd()()LocalResultPoi返回终点
getNumPlans()()Number返回方案个数
getPlan(i: Number)(i: Number)RoutePlan返回索引指定的方案。索引0表示第一条方案

DrivingRoute

此类用于获取驾车路线规划方案。

构造函数描述
DrivingRoute(location: :Map | Point | String,, opts: DrivingRouteOptions )创建一个驾车导航实例,其中location表示检索区域,类型可为地图实例、坐标点或城市名称的字符串。当参数为地图实例时,检索位置由地图当前的中心点确定;当参数为坐标时,检索位置由该点所在位置确定;当参数为城市名称时,检索会在该城市内进行
方法返回值描述
search(start: Point | LocalResultPoi, end: Point | LocalResultPoi)none发起检索。 start: 起点,参数可以是坐标点和LocalSearchPoi实例。 end: 终点,参数可以是坐标点或LocalSearchPoi实例
getResults()DrivingRouteResult返回最近一次检索的结果
clearResults()none清除最近一次检索的结果
enableAutoViewport()none启用自动调整地图层级,当指定了搜索结果所展现的地图时有效
disableAutoViewport()none禁用自动调整地图层级
setPolicy(policy: DrivingPolicy )none设置路线规划策略,参数为策略常量
setSearchCompleteCallback(callback: Function)none设置检索结束后的回调函数。 参数: results: DrivingRouteResult
setMarkersSetCallback(callback: Function)none设置添加标注后的回调函数。 参数: pois: Array,起点和目的地点数组,通过marker属性可得到其对应的标注
setInfoHtmlSetCallback(callback: Function)none设置气泡打开后的回调函数。 参数: poi: LocalResultPoi,通过marker属性可得到当前的标注。html: HTMLElement,气泡内的DOM元素
setPolylinesSetCallback(callback: Function)none设置添加路线后的回调函数。 参数: routes: Array ,驾车线路数组,通过Route.getPolyline()方法可得到对应的折线覆盖物
getStatus()StatusCodes返回状态码
toString()String返回类型说明

DrivingRouteOptions

此类表示DrivingRoute构造函数的可选参数。

属性类型描述
renderOptionsRenderOptions结果呈现设置
policyDrivingPolicy驾车策略
onSearchCompleteFunction检索完成后的回调函数。参数: results: DrivingRouteResult
onMarkersSetFunction标注添加完成后的回调函数。 参数: pois: Array ,起点和目的地点数组,通过marker属性可得到其对应的标注
onInfoHtmlSetFunction标注气泡内容创建后的回调函数。 参数: poi: LocalResultPoi,通过marker属性可得到当前的标注。html: HTMLElement,气泡内的DOM元素
onPolylinesSetFunction折线添加完成后的回调函数。 参数: routes: Array ,驾车线路数组,通过Route.getPolyline()方法可得到对应的折线覆盖物

DrivingRouteResult

此类表示路线导航的结果,没有构造函数,通过DrivingRoute.getResults()方法或DrivingRoute的onSearchComplete回调函数参数获得。

属性类型描述
policyDrivingPolicy驾车导航策略
方法返回值描述
getStart()LocalResultPoi返回起点
getEnd()LocalResultPoi返回终点
getNumPlans()Number返回方案个数
getPlan(i: Number)RoutePlan返回索引指定的方案。索引0表示第一条方案

DrivingPolicy

此枚举类型表示驾车方案的策略配置。

常量描述
BMAP_DRIVING_POLICY_DEFAULT默认
BMAP_DRIVING_POLICY_FIRST_HIGHWAYS优先高速
BMAP_DRIVING_POLICY_AVOID_HIGHWAYS避开高速
BMAP_DRIVING_POLICY_AVOID_CONGESTION避开拥堵

TaxiFare

此类表示出租车费用信息,没有构造函数,通过对象字面量形式表示。

属性类型描述
dayTaxiFareDetail白天费用
nightTaxiFareDetail夜间费用。注意,部分城市没有夜间费用,此时此属性为null,且同时白天费用表示全天费用
distanceNumber出租车里程,单位为米
remarkString出租车备注信息

TaxiFareDetail

此类表示出租车具体费用信息,没有构造函数,通过对象字面量形式表示。

属性类型描述
initialFareNumber出租车起步价
unitFareNumber出租车单价
totalFareNumber出租车费用总价

RoutePlan

此类表示一条驾车、步行或骑行出行方案。它没有构造函数,可通过DrivingRouteResult.getPlan()方法或WalkingRouteResult类的getPlan()方法获得。

方法返回值描述
getNumRoutes()Number返回方案包含的线路的个数
getRoute(i: Number)Route返回方案中索引指定的线路。索引0表示第一条线路
getDistance(format: Boolean)String | Number返回方案总距离。当format参数为true时,返回方案距离字符串(包含单位),当format为false时,仅返回数值(单位为米)信息。默认参数为true
getDuration(format: Boolean)String | Number返回方案总时间。当format参数为true时,返回描述时间的字符串(包含单位),当format为false时,仅返回数值(单位为秒)信息。默认参数为true

Route

此类表示一条驾车、步行或骑行路线。

方法返回值描述
getNumSteps()Number返回路线包含的关键点个数
getStep(i: Number)Step返回索引指定的关键点,驾车和步行适用。索引0表示第一个关键点
getDistance(format: Boolean)String | Number返回路线距离,当format为false时仅返回数值
getIndex()Number返回本路线在方案中的索引位置
getPolyline()Polyline返回路线对应的覆盖物,仅当结果自动添加到地图上时有效
getPath()Array< Point >返回路线的地理坐标点数组
getRouteType()RouteTypes返回路线类型,可区分是驾车还是步行线路

RouteType

常量表示不同的线路类型。

常量描述
BMAP_ROUTE_TYPE_DRIVING驾车线路
BMAP_ROUTE_TYPE_WALKING步行线路
BMAP_ROUTE_TYPE_RIDING骑行线路

Step

此类表示驾车、步行或骑行路线中的一个关键点。它没有构造函数,通过Route.getStep()方法获得。

方法返回值描述
getPosition()Point返回关键点地理坐标
getIndex()Number返回本关键点在路线中的位置索引
getDescription(includeHtml: Boolean)String返回关键点描述文本,默认包含HTML标签。当includeHtml为false时,描述文本不包含HTML标签。不支持驾车路线规划
getDistance(format: Boolean)String | Number返回到下一个关键点的距离,当format为false时仅返回数值(单位为米)

HighlightModes

此常量用于描述对象当前状态。

常量描述
BMAP_HIGHLIGHT_STEP驾车结果展现中点击列表后的展现点步骤
BMAP_HIGHLIGHT_ROUTE驾车结果展现中点击列表后的展现路段

Geocoder

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

构造函数描述
Geocoder()创建一个地址解析器的实例
方法返回值描述
getPoint(address: String, callback: Function, city: String)none对指定的地址进行解析。如果地址定位成功,则以地址所在的坐标点Point为参数调用回调函数。否则,回调函数的参数为null。city为地址所在的城市名,例如“北京市”
getLocation(point: Point , callback: Function, options: LocationOptions )none对指定的坐标点进行反地址解析。如果解析成功,则回调函数的参数为GeocoderResult对象,否则回调函数的参数为null

GeocoderResult

此类表示Geocoder的地址解析结果。它在地址解析的回调函数的参数中返回,不可实例化。

属性类型描述
pointPoint坐标点
addressString地址描述
addressComponentsAddressComponent结构化的地址描述
surroundingPoisArray< LocalResultPoi >附近的POI点
businessString商圈字段,代表此点所属的商圈

AddressComponent

此类表示地址解析结果的层次化地址信息,没有构造函数,通过对象字面量形式表示。

属性类型描述
streetNumberString门牌号码
streetString街道名称
districtString区县名称
cityString城市名称
provinceString省份名称

LocationOptions

此类表示Geocoder的地址解析请求的可选参数。它不可实例化。

属性类型描述
poiRadiusNumber附近POI所处于的最大半径,默认为100米
numPoisNumber返回的POI点个数,默认为10个。取值范围

LocalCity

此类用于获取用户所在的城市位置信息。(根据用户IP自动定位到城市)

构造函数描述
LocalCity(opts: LocalCityOptions )创建一个获取本地城市位置的实例
方法返回值描述
get(callback: Function)none当获取城市信息后,回调函数会被调用,其参数为类型为LocalCityResult对象

LocalCityOptions

此类表示LocalCity的可选参数。它没有构造函数,但可通过对象字面量表示。

属性类型描述
renderOptionsRenderOptions结果呈现设置,当给定map参数时,改地图将自动将视野定位到当前城市

LocalCityResult

此类表示LocalCity的定位结果。

属性类型描述
centerPoint城市所在中心点
levelNumber展示当前城市的最佳地图级别,如果您在使用此对象时提供了map实例,则地图级别将根据您提供的地图大小进行调整
nameString城市名称

Geolocation

返回用户当前的位置,会首先调用浏览器自带的定位接口,如果失败或不支持则调用高精IP定位(需要开通权限,否则调用普通定位)接口,如果用户拒绝授权定位,则无法返回任何定位结果。

构造函数描述
Geolocation()创建Geolocation对象实例
方法返回值描述
getCurrentPosition(callback: Function, opts: PositionOptions )none返回用户当前位置。定位完成时(包括成功、失败、超时等情况),回调参数为GeolocationResult对象,否则为null
getStatus()StatusCode定位完成后的状态码。分为BMAP_STATUS_SUCCESS,BMAP_STATUS_UNKNOWN_LOCATION,BMAP_STATUS_PERMISSION_DENIED,BMAP_STATUS_TIMEOUT
enableSDKLocation()none开启SDK辅助定位,仅当使用环境为移动web混合开发,且开启了定位sdk辅助定位功能后生效
disableSDKLocation()none关闭SDK辅助定位

GeolocationResult

此类作为Geolocation的getCurrentPosition方法的回调函数参数,不可实例化。

属性类型描述
pointPoint定位坐标点
accuracyNumber定位精度,单位为米
addressAddressComponent根据定位坐标点解析出的地址信息,可能为空(3.0新增)

PositionOptions

此类为getCurrentPosition的可选参数,不能实例化。

属性类型描述
enableHighAccuracyBoolean是否要求浏览器获取最佳效果,同浏览器定位接口参数。默认为false
timeoutNumber超时事件,单位为毫秒。默认为10秒
maximumAgeNumber允许返回指定事件内的缓存结果,单位为毫秒。如果为0,则每次请求都获取最新的定位结果。默认为10分钟
SDKLocationBoolean是否开启SDK辅助定位

BusLineSearch

公交路线搜索类。

构造函数描述
BusLineSearch(location: Map | Point | String, options: BusLineSearchOptions )创建公交线搜索类。其中location表示检索区域,其类型可为地图实例、坐标点或城市名称的字符串。当参数为地图实例时,检索位置由当前地图中心点确定;当参数为坐标时,检索位置由该点所在位置确定;当参数为城市名称时,检索会在该城市内进行
方法返回值描述
getBusList(keyword: String)none在用户配置的回调函数中返回公交列表结果,其类型为BusListResult
getBusLine(busLstItem: BusListItem )none在用户配置的回调函数中返回该条线路的公交信息,其类型为BusLine类型
clearResults()none清除本次公交线检索结果
enableAutoViewport()none启用自动调整地图视野功能
disableAutoViewport()none禁用自动调整地图视野功能
setLocation(location: Map | Point | String)none设置检索范围,参数类型可以为地图实例、坐标点或字符串。例:setLocation("北京市")
getStatus()StatusCodes返回状态码
toString()String返回类型说明
setGetBusListCompleteCallback(callback: Function)none设置公交列表查询后的回调函数。参数:rs: BusListResult类型
setGetBusLineCompleteCallback(callback: Function)none设置公交线路查询后的回调函数。参数:rs: BusLine类型
setBusListHtmlSetCallback(callback: Function)none公交列表结果页渲染后回调函数。参数:container: HTMLElement,结果列表所用的HTML元素
(callback: Function)none公交线路结果页渲染后回调函数。参数:container: HTMLElement,结果列表所用的HTML元素
(callback: Function)none添加公交线时候回调函数。参数:ply:Polyline 公交线路几何对象
(callback: Function)none添加公交站点时候回调函数。参数:sts:Array 公交站坐标组成的Marker对象数组

BusLineSearchOptions

此类表示BusLineSearch类的可选参数,没有构造参数,可以通过对象字面量表示

属性类型描述
renderOptionsRenderOptionsRenderOptions结果呈现设置
onGetBusListCompleteFunction设置公交列表查询后的回调函数.参数:rs: BusListResult类型
onGetBusLineCompleteFunction设置公交线路查询后的回调函数.参数:rs: BusLine类型
onBusListHtmlSetFunction公交列表结果页渲染后回调函数.参数:container: HTMLElement,结果列表所用的HTML元素
onBusLineHtmlSetFunction公交线路结果页渲染后回调函数.参数:container: HTMLElement,结果列表所用的HTML元素
onPolylinesSetFunction添加公交线时候回调函数.参数:ply:Polyline 公交线路几何对象
onMarkersSetFunction添加公交站点时候回调函数.参数:sts:Array 公交站坐标组成的Marker对象数组

BusListResult

公交列表查询成功回调函数的参数对象

属性类型描述
keywordString本次检索关键字
cityString本次检索所在城市
moreResultsUrlString到百度地图查看url
方法返回值描述
getNumBusList()Number公交列表个数
getBusListItem(i: Number)BusListItem获取某一个具体的公交列表中的对象。0表示上行,1表示下行

BusLine

表示公交线路结果的公交线,没有构造函数,通过检索回调函数获得。

属性类型描述
nameString线路名称
startTimeString首班车时间
endTimeString末班车时间
companyString公交线路所属公司
方法返回值描述
getNumBusStations()Number获取公交站点个数
getBusStation(i: Number)BusStation获取某一个具体的公交站对象
getPath()Array< Point >返回公交线地理坐标点数组
getPolyline()Polyline获取公交线几何对象, 仅当结果自动添加到地图上时有效

Line

此类表示一条公交线路,如果是跨城检索,还有可能表示一条飞机、火车或大巴线路。没有构造函数,通过TransitRoutePlan.getLine()方法得到。

属性类型描述
titleString线路全称
typeLineType线路类型
方法返回值描述
getNumViaStops()Number返回公交线路途径的车站个数,仅在公交和地铁类型有效
getGetOnStop()LocalResultPoi返回上车站
getGetOffStop()LocalResultPoi返回下车站
getPath()Array< Point >返回线路对应的地理坐标点数组,在公交方案中,地理坐标只给出方案涉及的部分
getPolyline()Polyline返回公交线路对应的折线覆盖物
getDistance(format: Boolean)String | Number当format为true时,返回本段公交线路的距离字符串(包含单位),当format为false时仅返回数值(单位为米)。默认参数为true

BusListItem

一个具体公交对象

属性类型描述
nameString公交线名称

BusStation

公交站点对象

属性类型描述
nameString站点名称
positionPoint站点坐标

Autocomplete

Autocomplete是结果提示、自动完成类。

构造函数描述
Autocomplete(options: AutocompleteOptions )创建自动完成的实例
方法返回值描述
show()none显示提示列表
hide()none隐藏提示列表
setTypes(types: type<Array>)none修改请求数据类型。types定义方法详见AutocompleteOptions
setLocation(location: String | Map | Point )none设置检索区域
search(keywords: string)none发起某个关键字的提示请求,会引起onSearchComplete的回调
getResults()AutocompleteResult获取结果列表
setInputValue(keyword: string)none设置绑定的input控件的值,且不会出现下拉列表
dispose()none销毁自动完成对象
事件参数描述
onconfirm{type,target,item}回车选中某条记录后触发 item : { index : 1 /*高亮的记录,所属返回结果的index*/ ,value : {}/*结果数据,见AutocompleteResultPoi*/ }
onhighlight{type,target,fromitem,toitem}键盘或者鼠标移动,某条记录高亮之后,触发 fromitem: { /*上一条记录的信息*/ index : 2 /*高亮的记录,所属返回结果的index*/ ,value : {}/*结果数据,见AutocompleteResultPoi*/ }, toitem : {/*当前记录的信息,与fromitem结构一致*/}

AutocompleteOptions

本类是Autocomplete类的可选参数对象

属性类型描述
locationString | Map | Point设定返回结果的所属范围。例如“北京市”
typesArray<String>返回数据类型。两种设置方式,第一种为默认值(即设置值为空),将返回所有数据。如地图初始化为北京,在输入框中输入“小”,输入框下会出现包含“小”关键字的多种类型(如餐饮、地名等)的提示词条。第二种设置值为"city",将返回省市区县乡镇街道地址类型数据。如地图初始化为北京,在输入框中输入“小”,输入框下会出现“小金县”的地点名称类的提示词条
onSearchCompleteFunction在input框中输入字符后,发起列表检索,完成后的回调函数。 参数:AutocompleteResult
inputString | HTMLElement文本输入框元素或其id

AutocompleteResultPoi

自动完成类获取的单个POI点的信息

属性类型描述
provinceString省名
CityString城市名
districtString区县名称
streetString街道名称
streetNumberString门牌号码
businessString商户名

AutocompleteResult

自动完成检索完成回调函数的参数对象

属性类型描述
keywordString检索关键字
方法返回值描述
getPoi(i: Number)AutocompleteResultPoi结果数组
getNumPois()Number结果总数

Boundary

此类表示一个行政区域的边界。

构造函数描述
Boundary()创建行政区域搜索的对象实例
方法返回值描述
get(name: String, callback: function)null返回行政区域的边界。 name: 查询省、直辖市、地级市、或县的名称。 callback:执行查询后,数据返回到客户端的回调函数,数据以回调函数的参数形式返回。返回结果是一个数组,数据格式如下: arr[0] = "x1, y1; x2, y2; x3, y3; ..." arr[1] = "x1, y1; x2, y2; x3, y3; ..." arr[2] = "x1, y1; x2, y2; ..." … 否则回调函数的参数为null

场景控件类

Cluster

构造函数描述
new Cluster.View(map:BMapGL.Map,options:Cluster.IClusterOptions)构建函数。用于展示海量点标记,将点标记按照距离、属性、地理围栏进行聚合,以提高地图绘制性能。

Cluster.IClusterOptions

聚合类参数

参数项类型限制描述
isRenderboolean是否采用renderClusterStyle
和renderSingleStyle渲染数据
minZoomnumber3-23显示最小层级,默认3
maxZoomnumber3-23显示最大层级,默认21
clusterRadiusnumber默认60聚合算法的可聚合距离,即距离小于该值的点会聚合至一起,默认为60,以像素为单位
clusterMinPointsnumber默认2最小聚合点数
clusterMaxZoomnumber默认16采用聚合策略的最大缩放级别,若地图缩放级别大于该值,则不进行聚合,标点将全部被展开
clusterListChildrennumber默认0聚合簇筛选返回聚合的点标记对象ClusterElement的数量
clusterPointTypestring|Function默认undefined指定点标记按距离聚合时可采用属性约束的表达项。可以实现距离+属性的联合约束聚合。
clusterPointWeightstring|Function默认undefined指定点标记的权重信息表达项,以权重高的点为中心进行聚合
clusterMap(props)=>({key:value})props代表点输入属性增加或者修改点属性
clusterReduce(accumulated,props)=>{}accumulated代表累计属性对象 props代表点属性根据聚合的数据生成聚合点属性
clusterTypeCluster.TCondition|
undefined
默认采用clusterRadius和clusterMaxZoom进行距离计算方式进行聚合分段设置聚合计算方式
clusterDictionary(type:Cluster.EClusterType,
key:string|Array<string>)=>{Geometry}
如果type是 Cluster.ClusterType.ATTR_REF ,返回值 Point 如果type是Cluster.ClusterType.GEO_FENCE,返回值Array<Polygon>地理数据字典
isAnimationboolean默认false是否启用动画形式。如果启用,聚合点和非聚合点都是使用renderClusterStyle引擎进行渲染,且必须是ClusterRender.DOM类型。
renderClusterStyleCluster.IRenderStyle默认ClusterRender.DOM聚合点图层聚合点样式个性化设置
renderSingleStyleCluster.IRenderStyle默认ClusterRender.WEBGL图标点图层非聚合点样式个性化设置
fitViewOnClickboolean默认false点击聚合簇放大展开
updateRealTimeboolean默认false是否操作地图过程中实时进行聚合数据更新,还是操作完地图后进行更新
waitTimeboolean默认300毫米间隔时间进行渲染数据,防止频繁操作

属性

名称返回描述
get isRenderboolean获取是否渲染数据
set isRendervoid设置是否渲染数据

方法

方法返回描述
setData(points:Array
<GeoJSONPointFeature>)
boolean 数据是否满足要求数据源。格式参考
GeoJSON Featuregeometry
参考GeoJSON Point
getSingleLayer()BMapGL.CustomHtmlLayer | BMapGL.PointIconLayer单点渲染图层
getClusterLayer()BMapGL.CustomHtmlLayer | BMapGL.PointIconLayer聚合点渲染图层
getLeaves(clusterId:number
,limitNum?:number)
Array<ClusterElement>获取limitNum数量的叶子节点,
即点标记。如果limitNum不设置
或者小于等于0则获取全部叶子节点。
getSonNodes(clusterId:number)Array<ClusterElement>获取下一级节点,包括聚合点和单点
getOptions()IClusterOptions
redraw()void重新绘制。会触发样式个性化回调
show()void显示
hide()void隐藏
destroy()void销毁
on(type:Cluster.ELayerEvent,
callback:Callback
<Cluster.ClusterElement|
[GeoJSONPointFeature,
GeoJSONPointFeature]>)
void监听事件
点击、悬浮、非悬浮事件,callback对象Cluster.ClusterElement
当前聚合数据变化事件,callback对象[GeoJSONPointFeature,GeoJSONPointFeature]
第一项为单点数据,第二项为聚合点数据
off(type:Cluster.ELayerEvent,
callback:Callback
<Cluster.ClusterElement|
[GeoJSONPointFeature,
GeoJSONPointFeature]>)
void移除事件

Cluster.ClusterEvent

数据项描述
CLICK点击事件
MOUSE_OVER悬浮事件
MOUSE_OUT悬浮移到外部事件
CHANGE当前聚合数据变化事件
DESTROY销毁事件

Cluster.ClusterElement

数据项类型描述
idnumber标识
typeClusterType聚合类型
isClusterboolean是否是聚合点
pointCountnumber|undefined聚合点数量
bbox[number]|undefined外接矩形
belongKeystring|number|undefined非距离聚合类型的归属分类
belongValuestring|number|undefined非距离聚合类型的归属分类值
latLng[number,number]点经纬度,百度坐标
pixel[number,number]点像素坐标
reducesobject|undefined自定义聚合属性
propertiesobject|undefined非聚合点属性
targetHTMLDivElement| PointIconLayer点击目标对象

Cluster.TCondition

聚合条件设置

s数据项类型限制描述
start_zoomnumber3-22开始层级
end_zoomnumber3-22结束层级
cluster_typeCluster.ClusterType三种之一聚合类型
ref_valuestring|number|Array>string|number>cluster_type =
Cluster.ClusterType.DIS_PIXEL ref_value代表
是可聚合距离 cluster_type =
Cluster.ClusterType.ATTR_REF ref_value代表
是GeoJSONPointFeature.properties属性项 cluster_type =
Cluster.ClusterType.GEO_FENCE ref_value代表是
地理围栏索引
聚合条件

Cluster.ClusterType

聚合类型定义

数据项限制描述
DIS_PIXEL数字按照屏幕像素坐标距离聚合
ATTR_REF外挂属性值对应的坐标点,
缺失则计算聚合点
按照数据属性项索引相同进行聚合
GEO_FENCE外挂地理范围字典,缺失则按照DIS_PIXEL处理按照同属地理围栏进行聚合

Cluster.IRenderStyle

渲染样式定义

数据项限制描述
typeCluster.ClusterRender样式渲染类型
styleobject非必需。渲染图层配置项
injectCallback<Cluster.IClusterDataset>如果type === ClusterRender.DOM必须设置渲染对象函数,返回HTMLDivElement 如果是设置聚合图层数据,且type === ClusterRender.WEBGL必须设置渲染对象函数,返回HTMLCanvasElement

Cluster.IClusterDataset

如果是非聚合点,则包含点原始属性

数据项限制描述
allCountnumber点总数量
clusterIdnumber点标识
clusterIndexnumber聚合数据集中点索引
pointCountnumber聚合点数量
point[number,number]聚合点坐标
belongKeystring|number|Array[string|number]聚合分类标识
belongValuestring|number|Array[string|number]聚合分类名称

Cluster.ClusterRender

渲染样式类型

数据项限制描述
DOM用户通过JS进行DOM生成dom渲染形式
WEBGL用户通过canvas进行纹理生成webgl引擎渲染形式

Track

构造函数描述
new Track.View(map:BMapGL.Map,options?:Track.trackOptions);实现增加、移除轨迹线等功能。

属性

名称类型描述
optionsTrack.trackOptions获取设置的轨迹类参数
roadLineMapMap<string, Track.RoadLine>获取轨迹类包含的轨迹线

方法

方法返回描述
addTrackLine(
roadLine: Track.RoadLine)
void添加轨迹线
removeTrackLine(
roadLine: Track.RoadLine)
void移除轨迹线
focusTrack(
roadLine?: Track.RoadLine)
void设置轨迹线进入巡航模式
getFocusTrack()Track.RoadLine|undefined获取当前进入巡航模式的轨迹线
setCruiseOptions(
opts: cruiseOptions)
void设置巡航参数
getCruiseOptions()Track.cruiseOptions获取巡航参数
on(type:string,
callback:Function)
void监听事件
fire(type:string,args:any)void触发事件
off(type:string,
callback:Function)
void移除事件

Track.RoadLine

构造函数描述
new Track.RoadLine(type:string,options:Track.trackLineOptions);轨迹线基类,负责轨迹线基础操作。
具体由Track.LocalTrack, Track.LiveTrack进行实例化。

属性

名称类型描述
propertiesany自定义轨迹线属性,默认{}
visible【get/set】boolean是否显示轨迹线,默认true

方法

方法返回描述
setMovePoint(
point:Track.MovePoint)
void设置移动点对象
addTrackPoint(
point: Track.TrackPoint,
isReplace?:boolean)
void添加轨迹点对象
getTrackPoints()Array<Track.TrackPoint>获取轨迹对象点序列
clearTrackPoint()void清空轨迹点
setGradientColors(
colors: number[])
void统一设置轨迹点颜色
setGradientColor(
color: number)
void增加轨迹点颜色
getGradientColors()number[]轨迹点颜色序列
getFeature()GeoJSON.Feature获取GeoJSON数据
getPoints()Array<BMapGL.Point>获取所有轨迹线地图点
getBBox()[number,number,number,number]
| null
获取四至范围
getDistance()number获取长度
setProperty(value:any)void设置属性
getProperty()any获取属性
getRotation(
index: number,
trackPoint?: Track.TrackPoint)
number获取旋转角
getUUID()string获取标识
on(type:string,
callback:Function)
void监听事件
fire(type:string,args:any)void触发事件
off(type:string,
callback:Function)
void移除事件

事件

事件标识返回数据描述
Track.MapCodes.CLICKany点击事件。需要预先注册事件。
Track.MapCodes.MOUSE_OVERany移入事件。需要预先注册事件。
Track.MapCodes.MOUSE_OUTany移出事件。需要预先注册事件。

Track.LocalTrack

构造函数描述
new Track.LocalRoad(type:string,
options:Track.trackLineOptions);
本地回放轨迹类,继承Track.RoadLine类。

属性

名称类型描述
status【get/set】Track.StatusCodes回放状态
process【get/set】number进度,数值范围【0-1】

方法

方法返回描述
startAnimation()void开始回放
pauseAnimation()void暂停回放
resumeAnimation()void继续回放
stopAnimation()void停止回放
resetTrackPath(trackPoints?:
Array<Track.TrackPoint>)
void重新设置轨迹点
setElapsed(elapsed:
number)
void设置回放时间位置,单位秒
setProcess(process:
number)
void设置回放进度位置,
取值范围【0,1】
getInfoByProcess(
process: number)
Track.trackNodeInfo|null获取某个进度点的信息
getStepInfoByIndex(
index: number)
any获取某个进度点的信息
getStepInfoByIndex(
index: number)
any获取某段节点的信息

事件

事件标识返回数据描述
Track.LineCodes.STATUSTrack.StatusCodes回放状态
Track.LineCodes.PROCESSnumber回放进度

Track.LiveTrack

构造函数描述
new Track.LiveRoad(options:
Track.liveTrackOptions);
在线实时轨迹类,继承Track.RoadLine类。

属性

名称类型描述
guidTrackTrack.LocalTrack|undefined诱导线对象
guidStyleTrack.guideStyleOptions诱导线样式
guidPropertyany诱导线属性
guidTrackStatus【get/set】Track.GuidCodes诱导线状态

方法

方法返回描述
setGuidTrackPath(
trackPath: Array<
Track.TrackPoint>)
void设置诱导线轨迹点
getGuidTrack()Track.LocalTrack获取诱导轨迹

事件

事件标识返回数据描述
Track.LineCodes.GUIDE_STATUS{
status: Track.GuidCodes
}
诱导线状态

Track.MovePoint

构造函数描述
new Track.MovePoint(options:
Track.movePointOptions);
移动目标基类,负责移动目标基础操作。
具体由Track.MarkerPoint,
Track.CustomPoint,
Track.ModelPoint,
Track.GroundPoint进行实例化。

方法

方法返回描述
addToMap(map: BMapGL.Map)void添加到地图上,轨迹线会主动调用
moveTo(point: Track.TrackPoint,
emit?: boolean)
void改变状态
setPoint(latlng: BMapGL.Point)void设置坐标
getPoint()BMapGL.Point获取坐标
setRotation(rotation: number)void设置旋转角
getRotation()number|undefinded获取旋转角
setProperty(property: any)void设置属性
getProperty()any获取属性
on(type:string,
callback:Function)
void监听事件
fire(type:string,args:any)void触发事件
off(type:string,callback:Function)void移除事件

事件

事件标识返回数据描述
Track.PointCodes.SET_TRACK_POINT{
trackPoint: Track.TrackPoint,
emit: boolean
}
位置或角度发生改变
Track.PointCodes.CHANGE_POINT{
point:BMapGL.Point
}
位置改变
Track.PointCodes.CHANGE_ROTATION{
rotation:number
}
旋转角改变
Track.MapCodes.ADD_TO_MAP{
map:BMapGL.map
}
添加到地图
Track.MapCodes.REMOVE_FROM_MAP{
map:BMapGL.map
}
从地图移除
Track.MapCodes.CLICKany点击事件。
需要预先注册事件。
Track.MapCodes.MOUSE_OVERany移入事件。
需要预先注册事件。
Track.MapCodes.MOUSE_OUTany移出事件。
需要预先注册事件。

Track.MarkerPoint

构造函数描述
new Track.MarkerPoint(option?:
Track.markerPointOptions);
Marker移动目标,继承Track.MovePoint

Track.CustomPoint

构造函数描述
new Track.CustomPoint(option?:
Track.customPointOptions);
Custom移动目标,继承Track.MovePoint

Track.ModelPoint

构造函数描述
new Track.ModelPoint(option?:
Track.modelPointOptions);
Model移动目标,继承Track.MovePoint

方法

方法返回描述
setPosition(x: number,
y: number, z?: number)
void设置坐标值
setPositionZ(z: number)void设置z坐标值
setRotationXYZ(x: number,
y: number, z: number)
void设置旋转角度
setScale(scale: number)void设置模型缩放大小

Track.GroundPoint

构造函数描述
new Track.GroundPoint(option?:
Track.groundPointOptions);
Ground移动目标,继承Track.MovePoint

方法

方法返回描述
setScale(scale: number)void设置尺寸缩放大小

Track.TrackPoint

构造函数描述
new Track.TrackPoint(point: BMapGL.Point,
options?: Track.trackPointOptions);
轨迹点类

属性

名称类型描述
rotationnumber|undefined旋转角
timeStampnumber|undefined时间戳

方法

方法返回描述
setPoint(point: BMapGL.Point)void设置点
getPoint()BMapGL.Point获取点
getPointMC()BMapGL.Point获取mc坐标点
getPointMCArray()[number, number]获取mc数组
setRotation(val: number)void设置旋转角
getRotation()number | undefined获取旋转角
getTimeStamp()number | undefined获取时间戳
getOptions(key?: string)any获取设置参数
serialize()any序列化
static deserialize(data: any)TrackPoint | undefined反序列化
clone()TrackPoint对象克隆
on(type:string,callback:Function)void监听事件
fire(type:string,args:any)void触发事件
off(type:string,callback:Function)void移除事件

Track.trackPointOptions

轨迹点类构造函数参数

参数项类型描述
rotationnumber【可选】旋转角
timeStampnumber【可选】时间戳

Track.trackLineOptions

轨迹线基类参数

参数项类型描述
visibleboolean【可选】是否可视
gradientColornumber[]【可选】渐变颜色设置
styleTrack.trackLineStyle【可选】轨迹线样式配置
linearTextureArray<[number,string]>【可选】颜色带,如果需要显示渐变色,此项必须设置。
ranknumber【可选】层级设置
propertiesany【可选】设置自定义属性

Track.liveTrackOptions

实时轨迹配置参数,继承轨迹线基类参数Track.trackLineOptions

参数项类型描述
durationnumber【可选】间隔点时间,单位毫秒,默认0
guideStyleTrack.guideStyleOptions【可选】诱导线样式设置
guidPropertyany【可选】诱导线属性

Track.localTrackOptions

本地轨迹配置参数,继承轨迹线基类参数Track.trackLineOptions

参数项类型描述
durationnumber【可选】回放展示时间,单位秒,默认60秒
trackPathArray<Track.TrackPoint>【可选】轨迹点序列
speedModeany【可选】回放速度,默认1

Track.guideStyleOptions

参数项类型描述
styleTrack.trackLineStyle【可选】回放展示时间,单位秒,默认60秒
linearTextureArray<[number,string]>【可选】颜色带,如果需要显示渐变色,此项必须设置
gradientColornumber[]【可选】渐变颜色设置

Track.movePointOptions

参数项类型描述
pointBMapGL.Point【必须】坐标位置
rotationnumber【可选】设置角度

Track.markerPointOptions

Marker图标配置参数,继承移动目标基类参数Track.movePointOptions

参数项类型描述
styleBMapGL.MarkerOptions【可选】样式配置

Track.customPointOptions

Custom图标配置参数,继承移动目标基类参数Track.movePointOptions

参数项类型描述
styleBMapGL.CustomOverlayOptions【可选】样式配置

Track.groundPointOptions

Ground图标配置参数,继承移动目标基类参数Track.movePointOptions

参数项类型描述
styleBMapGL.GroundPointOptions【可选】样式配置
adjustSizeboolean【可选】是否自适应地图缩放

Track.modelPointOptions

Model图标配置参数,继承移动目标基类参数Track.movePointOptions

参数项二级参数类型描述
style【可选】样式配置
urlstring【必填】模型地址
scalenumber【可选】缩放
levelnumber【可选】自适应大小相对层级,默认18
rotationXnumber【可选】旋转角度
rotationYnumber【可选】旋转角度
rotationZnumber【可选】旋转角度
adjustSizeboolean【可选】是否自适应地图缩放

Track.trackLineStyle

轨迹线基类线样式参数

参数项类型描述
sequenceboolean是否,采用间隔填充纹理,默认false
marginLengthnumber间隔距离,默认16,单位像素
borderColorstring描边颜色
borderWeightnumber描边宽度,可以设置负值
strokeTextureUrlstring填充纹理图片地址,默认是空。图片需要是竖向表达,
在填充时会自动横向处理。
strokeTextureWidthnumber填充纹理图片宽度,需要是2的n次方
strokeTextureHeightnumber填充纹理图片长度,需要是2的n次方
strokeLineJoinstring描边线连接处类型,可选'miter', 'round',
'bevel',默认miter
strokeLineCapstring描边线端头类型,可选'round', 'butt',
'square',默认round
strokeColorstring描边线颜色,默认#dec41b
strokeWeightnumber描边线宽度,默认0
strokeOpacitynumber描边线透明度,默认1
strokeStylestring描边线类型,可选'solid'、'dashed'
和 'dotted',默认solid
dashArrayarray描边线虚线设置,默认[8,4]表示实线部分长8像素,
间隙部分长4像素
traceDisappearboolean痕迹是否使用消失模式,默认false。
false代表使用traceControl设置颜色
traceStartboolean是否从起点开始处理,否则从终点开始处理痕迹。
默认true
traceColor[number.number,number]rgb颜色值,取值范围0-255

Track.trackNodeInfo

轨迹路径点信息

数据项类型描述
pointBMapGL.Point坐标
anglenumber|undefined角度
tracenumber离原点距离
elapsednumber离原点时间

Track.StatusCodes

本地轨迹回放状态标识

枚举项描述
INIT初始化
PLAY播放
PAUSE暂停
STOP停止
FINISH完成

Track.LineCodes

轨迹线事件标识

枚举项描述
STATUS状态
PROCESS进度
GUIDE_STATUS诱导线状态

Track.GuidCodes

诱导线状态

枚举项描述
ADD_TO_MAP添加到地图
REMOVE_FROM_MAP从地图移除
IDLE未上图

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:/a/927067.html

如若内容造成侵权/违法违规/事实不符,请联系我们进行投诉反馈qq邮箱809451989@qq.com,一经查实,立即删除!

相关文章

【k8s】监控metrics-server

metrics-server介绍 Metrics Server是一个集群范围的资源使用情况的数据聚合器。作为一个应用部署在集群中。Metric server从每个节点上KubeletAPI收集指标&#xff0c;通过Kubernetes聚合器注册在Master APIServer中。为集群提供Node、Pods资源利用率指标。 就像Linux 系统一样…

AI 声音:数字音频、语音识别、TTS 简介与使用示例

在现代 AI 技术的推动下&#xff0c;声音处理领域取得了巨大进展。从语音识别&#xff08;ASR&#xff09;到文本转语音&#xff08;TTS&#xff09;&#xff0c;再到个性化声音克隆&#xff0c;这些技术已经深入到我们的日常生活中&#xff1a;语音助手、自动字幕生成、语音导…

ARM CCA机密计算安全模型之硬件强制安全

安全之安全(security)博客目录导读 [要求 R0004] Arm 强烈建议所有 CCA 实现都使用硬件强制的安全(CCA HES)。本文件其余部分假设系统启用了 CCA HES。 CCA HES 是一个可信子系统的租户——一个 CCA HES 主机(Host),见下图所示。它将以下监控安全域服务从应用处理元件(P…

matlab显示sin二维图

1&#xff0c;新建脚本 2、保存脚本 3、脚本命令&#xff1a;clc 清除 脚本命令的信息 clrear all 清除全部 4工作区内容&#xff1a;变量啥的 x0:0.001:2*pi%% 开始 精度 中值 ysin(x) y1cos(x) figure%%产生一个屏幕 plot(x,y)%%打印坐标 title(ysin(x))%%标题 xlabel(…

一万台服务器用saltstack还是ansible?

一万台服务器用saltstack还是ansible? 选择使用 SaltStack 还是 Ansible 来管理一万台服务器&#xff0c;取决于几个关键因素&#xff0c;如性能、扩展性、易用性、配置管理需求和团队的熟悉度。以下是两者的对比分析&#xff0c;帮助你做出决策&#xff1a; SaltStack&…

Flutter 1.2:flutter配置gradle环境

1、在android的模块中进行gradle环境配置 ①在 gradle-wrapper.properties文件中将url配置为阿里云镜像&#xff0c;因为gradle的服务器在国外&#xff0c;国内下载非常慢&#xff0c;也可在官网进行下载 gradle版本下载 gradle版本匹配 阿里云镜像gradle下载 可以通过复制链…

vue 2 父组件根据注册事件,控制相关按钮显隐

目标效果 我不注册事件&#xff0c;那么就不显示相关的按钮 注册了事件&#xff0c;才会显示相关内容 实现思路 组件在 mounted 的时候可以拿到父组件注册监听的方法 拿到这个就可以做事情了 mounted() {console.log(this.$listeners, this.$listeners);this.show.search !…

Vue+Elementui el-tree树只能选择子节点并且支持检索

效果&#xff1a; 只能选择子节点 添加配置添加检索代码 源码&#xff1a; <template><div><el-button size"small" type"primary" clearable :disabled"disabled" click"showSign">危险点评估</el-button>…

PhPMyadmin-漏洞复现

前情条件是&#xff1a;首先将我们的PHP版本设置在5.5以上 注&#xff1a;禁止用于未授权的测试! 首先搭建环境&#xff0c;登录后台 点击》》SQL 查看当前的日志状态 SHOW VARIABLES LIKE general%;因为之前我原来做过所以general_log 是开启的&#xff0c;如果vlau 是OF…

【2024】使用Docker搭建redis sentinel哨兵模式集群全流程(包含部署、测试、错误点指正以及直接部署)

目录&#x1f4bb; 前言**Docker Compose介绍**最终实现效果 一、搭建集群1、创建文件结构2、创建redis节点3、验证节点4、创建sentinel哨兵5、验证Sentinel功能 二、spring连接1、添加依赖2、添加配置3、启动测试 三、直接部署流程1、拉取配置2、修改端口创建 前言 本篇文章主…

泷羽sec-shell编程(完结) 学习笔记

声明&#xff01; 学习视频来自B站up主 **泷羽sec** 有兴趣的师傅可以关注一下&#xff0c;如涉及侵权马上删除文章&#xff0c;笔记只是方便各位师傅的学习和探讨&#xff0c;文章所提到的网站以及内容&#xff0c;只做学习交流&#xff0c;其他均与本人以及泷羽sec团队无关&a…

眼部按摩仪WT2605音频蓝牙语音芯片方案 单芯片实现语音提示及控制/手机无线音频传输功能

随着科技的快速发展&#xff0c;人们的生活方式也在不断改变&#xff0c;智能化、便捷化的产品逐渐成为市场的主流。眼部按摩仪作为一种结合了现代科技与健康生活理念的产品&#xff0c;受到了广大消费者的青睐。而在众多眼部按摩仪中&#xff0c;采用WT2605音频蓝牙芯片的方案…

相交链表和环形链表

&#xff08;一&#xff09;相交链表 相交链表 思路&#xff1a;先分别计算出A列表和B列表的长度&#xff0c;判断它们的尾节点是否相等&#xff0c;如果不相等就不相交&#xff0c;直接返回空。然后让两个列表中的长的列表先走它们的差距步&#xff0c;然后再一起走&#xff…

知识竞赛活动中现场用到的对讲机有哪些

在知识竞赛活动中&#xff0c;现场工作人员间一般通过对讲机进行联系和调动&#xff0c;那么&#xff0c;知识竞赛活动现场常用的对讲机品牌和型号有哪些呢&#xff0c;主要包括宝锋BF-888S、威贝特WBT-V1Plus、摩托罗拉V168、泉盛UV-K6和海能达S1等。这些对讲机各具特色&#…

reverse_re3

一、使用Exeinfo PE查壳 64无壳 二、使用IDA静态分析 1.找main&#xff0c;没有找到。按ShifeF12字符串查找&#xff0c;发现flag{md5(your input)}:md5加密&#xff0c;所以要找输入值。 2.点击后&#xff0c;发现所在函数sub_940 3.进入函数&#xff0c;使用R键将数字转换…

图论入门教程:GTM173 Graph Theory

这是本图论的入门教材&#xff0c;Graph Theory Fifth Edition&#xff0c;隶属于著名的GTM系列&#xff0c;作者是Reinhard Diestel。这是本对新人友好的教材&#xff0c;之前本科上离散数学的课时&#xff0c;因为涉及到图论&#xff0c;而学校的课堂又太水让我心生不满&…

c++ A*搜索算法

算法原理 A*算法通过以下公式计算节点的优先级&#xff1a; f(n)g(n)h(n)f(n)&#xff1a;节点 n的总优先级&#xff0c;表示从起点通过节点 n 到目标点的估计代价。g(n)&#xff1a;从起点到节点 n 的实际代价。h(n)&#xff1a;从节点 n到目标点的启发式估计代价。 A*的核…

修理一个433Mhz遥控器无法遥控和接触不良的故障

修了一个遥控器&#xff0c;故障表现为其中一个硅胶按键接触不良&#xff0c;使劲按压&#xff0c;却是时而可以时而无法遥控。另外一个为完全无法遥控。 按键部分图示如下 用频谱看&#xff0c;能发射的遥控器发出430Mhz的信号&#xff0c;虽然有接触不良&#xff0c;但是可以…

RabbitMQ 客户端工程环境配置

RabbitMQ 客户端工程环境配置 下面分别以 C# 控制台应用程序 、 Unity 工程为例 一 C# 控制台应用程序 &#xff08;1&#xff09;新建项目 (2) RabbitMQ 需要通过 NuGet 安装 打开项目解决方案 -> 依赖项(右键) -> 管理 NuGet 程序包 -> 搜索 RabbitMQ.Client -&…

Flutter | 基于函数式编程的通用单选列表设计

背景 项目中多次用到如下图的通用单选列表页&#xff1a; 常规封装 此列表需要三样东西&#xff1a; 标题数组当前选中项的 index点击 cell 的回调 封装大体如下&#xff1a; import package:flutter/material.dart;class ListPage1 extends StatefulWidget {const ListPa…