核心类

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_NORMAL_MAP时,需要在调用centerAndZoom之前调用此方法设置地图所在城市。例如: var map = new BMap.Map(“container”, {mapType: BMAP_NORMAL_MAP}); map.setCurrentCity(“北京市”); map.centerAndZoom(new BMap.Point(116.404, 39.915), 18); 注意:初始化的坐标应与您设置的城市对应,否则地图将无法正常显示。
setMapType(mapType: MapTypes) none 设置地图类型
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
icons Array<IconSequence> 配置贴合折线的图标
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 移除菜单项
addSeparator() 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(大小为17px*17px)
ContextMenuIcon
此类型表示内置的右键菜单图标。
常量
常量 描述
BMAP_CONTEXT_MENU_ICON_ZOOMIN 放大图标
BMAP_CONTEXT_MENU_ICON_ZOOMOUT 缩小图标

地图类型类

MapType
此类表示一种地图类型,您可以通过实例化此类自定义地图类型。
构造函数
构造函数 描述
MapType(name: String, layers: TileLayer | Array<TileLayer>, options: MapTypeOptions) 创建MapType对象实例
方法
方法 返回值 描述
getName() String 返回地图类型名称
getTileLayer() TileLayer 返回地图类型对应的图层
getMinZoom() Number 返回地图类型允许的最小级别
getMaxZoom() Number 返回地图类型允许的最大级别
getProjection() Projection 返回地图类型所使用的投影实例
getTextColor() String 返回地图类型对应的前景色
getTips() String 返回地图类型的提示说明,用于在地图类型控件中提示
常量
常量 描述
BMAP_NORMAL_MAP 此地图类型展示普通街道视图
BMAP_SATELLITE_MAP 此地图类型展示卫星视图
BMAP_HYBRID_MAP 此地图类型展示卫星和路网的混合视图
MapTypeOptions
此类是MapType构造函数的可选参数,不能实例化,通过对象字面量形式表示。
属性
属性 类型 描述
minZoom Number 该类型地图的最小级别
maxZoom Number 该类型地图的最大级别
errorImageUrl String 当没有图块时所显示的错误图片地址。默认为透明图
textColor Number 地图类型对应的前景色
tips String 提示说明信息,用于在地图类型控件中进行提示
Projection
此类表示地图投影抽象基类,不可实例化,但可通过MapType的getProjection方法获得。
方法
方法 返回值 描述
lngLatToPoint(lngLat: Point) Pixel 抽象,根据球面坐标获得平面坐标
pointToLngLat(point: Pixel) Point 抽象,根据平面坐标获得球面坐标
MercatorProjection
此类表示街道地图投影类,一般通过MapType的getProjection方法获得实例。
方法
方法 返回值 描述
lngLatToPoint(lngLat: Point) Pixel 根据球面坐标获得平面坐标
pointToLngLat(point: Pixel) Point 根据平面坐标获得球面坐标
PerspectiveProjection
此类表示透视地图投影类,一般通过MapType的getProjection方法获得实例。
方法
方法 返回值 描述
lngLatToPoint(lngLat: Point) Pixel 根据球面坐标获得平面坐标
pointToLngLat(point: Pixel) Point 根据平面坐标获得球面坐标

地图图层类

TileLayer
此类表示一个地图图层,您可以向地图中添加自定义图层。
构造函数
构造函数 描述
TileLayer(opts: TileLayerOptions) 创建一个地图图层实例
方法
方法 返回值 描述
getTilesUrl(tileCoord: Pixel, zoom: Number) String 抽象。向地图返回地图图块的网址,图块索引由tileCoord的x和y属性在指定的缩放级别zoom提供。如果您在TileLayerOptions中提供了tileUrlTemplate参数,则可不实现此接口
getCopyright() Copyright | Null 返回地图图层数据的版权对象
isTransparentPng() Number 如果图层所用的图片为PNG格式并且包含透明信息,则返回true
TileLayerOptions
此类表示TileLayer构造函数的可选参数
属性
属性 类型 描述
transparentPng Boolean 是否使用了带有透明信息的PNG。由于IE6不支持PNG透明,因此需要特殊处理
tileUrlTemplate String 指定图块网址模板,该模板可以针对每个图块请求而展开,以根据现有的图块坐标系引用唯一的图块。模板的格式应该为: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()抽象方法
copyright Copyright 地图图层的版权信息
zIndex Number 图层的zIndex
TrafficLayer
此类表示交通流量图层
构造函数
构造函数 描述
TrafficLayer(opts: TrafficLayerOptions) 创建交通流量图层。参数:opts: TrafficLayerOptions,可选 options 参数指定应作为对象常量传递。如果可选参数提供predictDate,则将显示预测流量。否则显示实时流量
TrafficLayerOptions
此类是TrafficLayer构造函数的可选参数,没有构造函数,不能实例化。
属性
属性 类型 描述
predictDate PredictDate 预测日期
PredictDate
此类表示交通流量的预测日期,没有构造函数,通过对象字面量形式表示。
属性
属性 类型 描述
weekday Number 预测日期,取值1到7,表示周一到周日
hour Number 预测小时数,取值0到23,表示当日的0点到23点
CustomLayer
CustomLayer是用户自定义底图层,现阶段主要为LBS云麻点功能展现服务。
构造函数
构造函数 描述
CustomLayer(CustomLayerOptions: opts) 创建自定义底图层
事件
事件 参数 描述
hotspotclick event{type, target, content} 点击热区触发,content即为lbs云详情检索的所有字段,参考lbsyun.baidu.com/index.php?title=lbscloud/api/geosearch
CustomLayerOptions
此类表示CustomLayer构造函数的可选参数。
属性
属性 类型 描述
databoxId String 使用云检索v1版本的databoxId
geotableId String 使用云检索v2版本的geotableId
q String 检索关键字
tags String 空格分隔的多字符串
filter String 过滤条件,参考lbsyun.baidu.com/index.php?title=lbscloud/api/geosearch
pointDensityType Enum PointDensityType 麻点密度常量
Custompoi
此类表示点击麻点图返回的,没有构造函数,通过对象字面量形式表示。
属性
属性 类型 描述
poiId String 返回数据的id
databoxId String 数据集的id
title String 结果的名称标题
address String 地址
phoneNumber String 电话
postcode String 邮政编码
provinceCode Number 结果所在省的编码
province String 结果所在省的名称
cityCode Number 结果所在城市的编码
city String 结果所在城市的名称
districtCode Number 结果所在区县的编码
district String 结果所在区县的名称
point Point 结果所在的地理位置
tags Array <String> 结果的筛选标签
typeId Number 结果的类别id
extendedData Json 用户扩展数据,结构根据用户的自定义
PanoramaCoverageLayer
此图层用来展示全景覆盖的区域。
构造函数
构造函数 描述
PanoramaCoverageLayer() 创建全景覆盖区域图层的实例
PointDensityType
麻点密度常量
常量
常量 描述
BMAP_POINT_DENSITY_HIGH 麻点密度高
BMAP_POINT_DENSITY_MEDIUM 麻点密度中等,默认
BMAP_POINT_DENSITY_LOW 麻点密度低

服务类

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构造函数的可选参数。
属性
属性 类型 描述
renderOptions LocalRenderOptions 结果呈现设置
onMarkersSet Function 标注添加完成后的回调函数。 参数: pois: Array ,通过marker属性可得到其对应的标注
onInfoHtmlSet Function 标注气泡内容创建后的回调函数。 参数: poi: LocalResultPoi,通过其marker属性可得到当前的标注。 html: HTMLElement,气泡内的Dom元素
onResultsHtmlSet Function 结果列表添加完成后的回调函数。 参数: container: HTMLElement,结果列表所用的HTML元素
pageCapacity Number 设置每页容量,取值范围:1 - 100,对于多关键字检索,容量表示每个关键字的数量,如果有2个关键字,则实际检索结果数量范围为:2 - 200
onSearchComplete Function 检索完成后的回调函数。 参数:results: LocalResult或Array 如果是多关键字检索,回调函数参数返回一个LocalResult的数组,数组中的结果顺序和检索中多关键字数组中顺序一致
CustomData
此类表示检索lbs云服务的数据。它没有构造函数,但可通过对象字面量形式表示。 要检索lbs云服务的数据,需要在引用api的时候在参数后加上lbs云平台的key。
属性
属性 类型 描述
geotableId Number lbs云v2接口,可在lbs云平台上查看自己的geotableId
tags String 空格分隔的多字符串
filter String 过滤条件,参考:lbsyun.baidu.com/index.php?title=lbscloud/api/geosearch
RenderOptions
此类表示搜索结果呈现的配置。它没有构造函数,但可通过对象字面量形式表示。
属性
属性 类型 描述
map Map 展现结果的地图实例。当指定此参数后,搜索结果的标注、线路等均会自动添加到此地图上
panel String | HTMLElement 结果列表的HTML容器id或容器元素,提供此参数后,结果列表将在此容器中进行展示。此属性对LocalCity无效
selectFirstResult Boolean 是否选择第一个检索结果。此属性仅对LocalSearch有效
autoViewport Boolean 检索结束后是否自动调整地图视野。此属性对LocalCity无效
highlightMode HighlightModes 驾车结果展现中点击列表后的展现策略
LocalResult
类表示LocalSearch的检索结果,没有构造函数,通过LocalSearch.getResults()方法或LocalSearch的onSearchComplete回调函数的参数得到。
属性
属性 类型 描述
keyword String 本次检索的关键词
center LocalResultPoi 周边检索的中心点(仅当周边检索时提供)
radius Number 周边检索的半径(仅当周边检索时提供)
bounds Bounds 范围检索的地理区域(仅当范围检索时提供)
city String 本次检索所在的城市
moreResultsUrl String 更多结果的链接,到百度地图进行搜索
province String 本次检索所在的省份
suggestions Array<String> 搜索建议列表。(当关键词是拼音或拼写错误时给出的搜索建议)
方法
方法 返回值 描述
getPoi(i: Number) LocalResultPoi 返回索引指定的结果。索引0表示第1条结果
getCurrentNumPois() Number 返回当前页的结果数
getNumPois() Number 返回总结果数
getNumPages() Number 返回总页数
getPageIndex() Number 返回页数序号
getCityList() Array<Object> 返回城市列表。数组元素对象包含如下属性: city: String,城市名 numResults: Number,结果数
LocalResultPoi
此类表示位置检索或路线规划的一个结果点,没有构造函数,可通过对象字面量形式表示。
属性
属性 类型 描述
title String 结果的名称标题
point Point 该结果所在的地理位置
url String 在百度地图中展示该结果点的详情信息链接
address String 地址(根据数据部分提供)。注:当结果点类型为公交站或地铁站时,地址信息为经过该站点的所有车次
city String 所在城市
phoneNumber String 电话,根据数据部分提供
postcode String 邮政编码,根据数据部分提供
type PoiType 类型,根据数据部分提供
isAccurate Boolean 是否精确匹配。只适用LocalSearch的search方法检索的结果
province String 所在省份
tags Array<String> POI的标签,如商务大厦、餐馆等。目前只有LocalSearch的回调函数onSearchComplete(result)中的result和Geocoder.getLocation的回调函数的参数GeocoderResult.surroundingPois涉及的LocalResultPoi有tags字段。其他API涉及的LocalResultPoi没有该字段
detailUrl String 在百度地图详情页面展示该结果点的链接。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: String | Point | LocalResultPoi, end: String | Point | LocalResultPoi) none 发起检索。 start: 起点,参数可以是关键字、坐标点(自1.1版本支持)或者LocalSearchPoi实例。 end: 终点,参数可以是关键字、坐标点(自1.1版本支持)或者LocalSearchPoi实例
getResults() TransitRouteResult 返回最近一次检索的结果
clearResults() none 清除最近一次检索的结果
enableAutoViewport() none 启用自动调整地图层级,当指定了搜索结果所展现的地图时有效
disableAutoViewport() none 禁用自动调整地图层级
setPageCapacity(capacity: Number) none 设置每页返回方案个数(1-5),默认为5
setLocation(location: Map | Point | String) none 设置检索范围,参数类型可以为地图实例、坐标点或字符串。例:setLocation("北京市")
setPolicy(policy: TransitPolicy) 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构造函数的可选参数。它没有构造函数,但可通过对象字面量形式表示。
属性
属性 类型 描述
renderOptions RenderOptions 搜索结果的呈现设置
policy TransitPolicy 公交导航的策略参数
pageCapacity Number 返回方案的个数
onSearchComplete Function 检索完成后的回调函数。参数:results: TransitRouteResult,公交导航结果
onMarkersSet Function 标注添加完成后的回调函数。参数:pois: Array ,起点和目的地数组。transfers: Array ,公交车站数组
onInfoHtmlSet Function 气泡内容创建后的回调函数。参数:poi: LocalResultPoi,表示当前气泡对应的点(可以是起点、终点或换乘车站)html: HTMLElement,气泡内的DOM元素
onPolylinesSet Function 折线添加完成后的回调函数。参数:lines: Array ,公交线路数组。routes: Array ,步行线路数组,通过Route.getPolyline()方法可得到对应的折线覆盖物
onResultsHtmlSet Function 结果列表添加完成后的回调函数。参数:container: 结果列表所用的HTML元素
TransitPolicy
此常量表示公交方案的策略。
常量
常量 描述
BMAP_TRANSIT_POLICY_LEAST_TIME 最少时间
BMAP_TRANSIT_POLICY_LEAST_TRANSFER 最少换乘
BMAP_TRANSIT_POLICY_LEAST_WALKING 最少步行
BMAP_TRANSIT_POLICY_AVOID_SUBWAYS 不乘地铁
TransitRouteResult
此类表示路线导航的结果,没有构造函数,通过访问TransitRoute.getResults()方法或TransitRoute的onSearchComplete回调函数参数获得。
属性
属性 类型 描述
policy TransitPolices 公交导航策略
city String 本次检索所在的城市
moreResultsUrl String 更多结果的链接,到百度地图进行搜索
方法
方法 返回值 描述
getStart() LocalResultPoi 返回起点
getEnd() LocalResultPoi 返回终点
getNumPlans() Number 返回方案个数
getPlan(i: Number) TransitRoutePlan 返回索引指定的方案。索引0表示第一条方案
TransitRoutePlan
此类表示一条公交出行方案。没有构造函数,通过TransitRouteResult.getPlan()方法获得。
方法
方法 返回值 描述
getNumLines() Number 返回方案包含的公交线路段数
getLine(i: Number) Line 返回方案包含的某条公交线路
getNumRoutes() Number 返回方案包含的步行线路段数
getRoute(i: Number) Route 返回方案包含的某条步行线路
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标签
LineType
此枚举类型表示不同类型的公共交通线路。
常量
常量 描述
BMAP_LINE_TYPE_BUS 公交车
BMAP_LINE_TYPE_SUBWAY 地铁
BMAP_LINE_TYPE_FERRY 渡轮
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构造函数的可选参数。
属性
属性 类型 描述
renderOptions RenderOptions 搜索结果呈现设置
onSearchComplete Function 检索完成后的回调函数。 参数: results: WalkingRouteResult
onMarkersSet Function 标注添加完成后的回调函数。 参数: pois: Array ,起点和目的地点数组,。通过marker属性可得到其对应的标注
onPolylinesSet Function 折线添加完成后的回调函数。 参数: routes: Array ,步行线路数组,通过Route.getPolyline()方法可得到对应的折线覆盖物
onInfoHtmlSet Function 标注气泡内容创建后的回调函数。 参数: poi: LocalResultPoi,通过其marker属性可得到当前的标注。 html: HTMLElement,气泡内的DOM元素
onResultsHtmlSet Function 结果列表添加完成后的回调函数。 参数: container: 结果列表所用的HTML元素
WalkingRouteResult
此类表示路线导航的结果,没有构造函数,通过访问WalkingRoute.getResults()方法或WalkingRoute的onSearchComplete回调函数参数获得。
属性
属性 类型 描述
city String 本次检索所在的城市
方法
方法 返回值 描述
getStart() LocalResultPoi 返回起点
getEnd() LocalResultPoi 返回终点
getNumPlans() Number 返回方案个数
getPlan(i: Number) RoutePlan 返回索引指定的方案。索引0表示第一条方案
DrivingRoute
此类用于获取驾车路线规划方案。
构造函数
构造函数 描述
DrivingRoute(location: Map | Point | String, opts: DrivingRouteOptions) 创建一个驾车导航实例,其中location表示检索区域,类型可为地图实例、坐标点或城市名称的字符串。当参数为地图实例时,检索位置由地图当前的中心点确定;当参数为坐标时,检索位置由该点所在位置确定;当参数为城市名称时,检索会在该城市内进行
方法
方法 返回值 描述
search(start: String | Point | LocalResultPoi, end: String | Point | LocalResultPoi, options: object) none 发起检索。 start: 起点,参数可以是关键字、坐标点(自1.1版本支持)和LocalSearchPoi实例。 end: 终点,参数可以是关键字、坐标点(自1.1版本支持)或LocalSearchPoi实例。 option:{startCity:String,endCity:string,waypoints:array } startCity表示是驾车查询的起点城市,可以是城市名或者城市编码,endCity表示驾车查询的终点城市,可以是城市名或者城市编码,waypoints途经点集合,最多支持10个途经点,可以是名称也可以是坐标
getResults() DrivingRouteResult 返回最近一次检索的结果
clearResults() none 清除最近一次检索的结果
enableAutoViewport() none 启用自动调整地图层级,当指定了搜索结果所展现的地图时有效
disableAutoViewport() none 禁用自动调整地图层级
setLocation(location: Map | Point | String) none 设置检索范围,参数类型可以为地图实例、坐标点或字符串。例:setLocation("北京市")
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()方法可得到对应的折线覆盖物
setResultsHtmlSetCallback(callback: Function) none 设置结果列表创建后的回调函数。 参数: container: 结果列表所用的HTML元素
getStatus() StatusCodes 返回状态码
toString() String 返回类型说明
DrivingRouteOptions
此类表示DrivingRoute构造函数的可选参数。
属性
属性 类型 描述
renderOptions RenderOptions 结果呈现设置
policy DrivingPolicy 驾车策略
onSearchComplete Function 检索完成后的回调函数。参数: results: DrivingRouteResult
onMarkersSet Function 标注添加完成后的回调函数。 参数: pois: Array ,起点和目的地点数组,通过marker属性可得到其对应的标注
onInfoHtmlSet Function 标注气泡内容创建后的回调函数。 参数: poi: LocalResultPoi,通过marker属性可得到当前的标注。html: HTMLElement,气泡内的DOM元素
onPolylinesSet Function 折线添加完成后的回调函数。 参数: routes: Array ,驾车线路数组,通过Route.getPolyline()方法可得到对应的折线覆盖物
onResultsHtmlSet Function 结果列表添加完成后的回调函数。 参数: container: 结果列表所用的HTML元素
DrivingRouteResult
此类表示路线导航的结果,没有构造函数,通过DrivingRoute.getResults()方法或DrivingRoute的onSearchComplete回调函数参数获得。
属性
属性 类型 描述
policy DrivingPolicy 驾车导航策略
city String 本次检索所在的城市
moreResultsUrl String 更多结果的链接,到百度地图进行搜索
taxiFare TaxiFare 出租车费用信息。注意,此属性在部分城市有效,无效时为null
方法
方法 返回值 描述
getStart() LocalResultPoi 返回起点
getEnd() LocalResultPoi 返回终点
getNumPlans() Number 返回方案个数
getPlan(i: Number) RoutePlan 返回索引指定的方案。索引0表示第一条方案
DrivingPolicy
此枚举类型表示驾车方案的策略配置。
常量
常量 描述
BMAP_DRIVING_POLICY_LEAST_TIME 最少时间
BMAP_DRIVING_POLICY_LEAST_DISTANCE 最短距离
BMAP_DRIVING_POLICY_AVOID_HIGHWAYS 避开高速
TaxiFare
此类表示出租车费用信息,没有构造函数,通过对象字面量形式表示。
属性
属性 类型 描述
day TaxiFareDetail 白天费用
night TaxiFareDetail 夜间费用。注意,部分城市没有夜间费用,此时此属性为null,且同时白天费用表示全天费用
distance Number 出租车里程,单位为米
remark String 出租车备注信息
TaxiFareDetail
此类表示出租车具体费用信息,没有构造函数,通过对象字面量形式表示。
属性
属性 类型 描述
initialFare Number 出租车起步价
unitFare Number 出租车单价
totalFare Number 出租车费用总价
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
getDragPois() Array<LocalResultPoi> 获取通过拖拽方式产生的途径点。注意,这里的LocalResultPoi只有title和point属性
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 步行线路
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的地址解析结果。它在地址解析的回调函数的参数中返回,不可实例化。
属性
属性 类型 描述
point Point 坐标点
address String 地址描述
addressComponents AddressComponent 结构化的地址描述
surroundingPois Array<LocalResultPoi> 附近的POI点
business String 商圈字段,代表此点所属的商圈
AddressComponent
此类表示地址解析结果的层次化地址信息,没有构造函数,通过对象字面量形式表示。
属性
属性 类型 描述
streetNumber String 门牌号码
street String 街道名称
district String 区县名称
city String 城市名称
province String 省份名称
LocationOptions
此类表示Geocoder的地址解析请求的可选参数。它不可实例化。
属性
属性 类型 描述
poiRadius Number 附近POI所处于的最大半径,默认为100米
numPois Number 返回的POI点个数,默认为10个。取值范围
LocalCity
此类用于获取用户所在的城市位置信息。(根据用户IP自动定位到城市)
构造函数
构造函数 描述
LocalCity(opts: LocalCityOptions) 创建一个获取本地城市位置的实例
方法
方法 返回值 描述
get(callback: Function) none 当获取城市信息后,回调函数会被调用,其参数为类型为LocalCityResult对象
LocalCityOptions
此类表示LocalCity的可选参数。它没有构造函数,但可通过对象字面量表示。
属性
属性 类型 描述
renderOptions RenderOptions 结果呈现设置,当给定map参数时,改地图将自动将视野定位到当前城市
LocalCityResult
此类表示LocalCity的定位结果。
属性
属性 类型 描述
center Point 城市所在中心点
level Number 展示当前城市的最佳地图级别,如果您在使用此对象时提供了map实例,则地图级别将根据您提供的地图大小进行调整
name String 城市名称
Geolocation
返回用户当前的位置。此方法利用浏览器的geolocation接口获取用户当前位置,不支持的浏览器将无法获取。
构造函数
构造函数 描述
Geolocation() 创建Geolocation对象实例
方法
方法 返回值 描述
getCurrentPosition(callback: function, options: PositionOptions) none 返回用户当前位置。当定位成功时,回调函数的参数为GeolocationResult对象,否则为null
getStatus() StatusCode 返回状态码,当定位成功后,状态码为:BMAP_STATUS_SUCCESS,如果为其他状态码表示不能获取您当前的位置
enableSDKLocation() none 开启SDK辅助定位,仅当使用环境为移动web混合开发,且开启了定位sdk辅助定位功能后生效
disableSDKLocation() none 关闭SDK辅助定位
GeolocationResult
此类作为Geolocation的getCurrentPosition方法的回调函数参数,不可实例化。
属性
属性 类型 描述
point Point 坐标点
accuracy Number 定位精确程度,单位为米
PositionOptions
此类作为getCurrentPosition的可选参数,不能实例化。
属性
属性 类型 描述
enableHighAccuracy Boolean 要求浏览器获取最佳结果
timeout Number 超时时间
maximumAge Number 允许返回指定时间内的缓存结果。如果此值为0,则浏览器将立即获取新定位结果
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类的可选参数,没有构造参数,可以通过对象字面量表示
属性
属性 类型 描述
renderOptions RenderOptions RenderOptions结果呈现设置
onGetBusListComplete Function 设置公交列表查询后的回调函数.参数:rs: BusListResult类型
onGetBusLineComplete Function 设置公交线路查询后的回调函数.参数:rs: BusLine类型
onBusListHtmlSet Function 公交列表结果页渲染后回调函数.参数:container: HTMLElement,结果列表所用的HTML元素
onBusLineHtmlSet Function 公交线路结果页渲染后回调函数.参数:container: HTMLElement,结果列表所用的HTML元素
onPolylinesSet Function 添加公交线时候回调函数.参数:ply:Polyline 公交线路几何对象
onMarkersSet Function 添加公交站点时候回调函数.参数:sts:Array 公交站坐标组成的Marker对象数组
BusListResult
公交列表查询成功回调函数的参数对象
属性
属性 类型 描述
keyword String 本次检索关键字
city String 本次检索所在城市
moreResultsUrl String 到百度地图查看url
方法
方法 返回值 描述
getNumBusList() Number 公交列表个数
getBusListItem(i: Number) BusListItem 获取某一个具体的公交列表中的对象。0表示上行,1表示下行
BusLine
表示公交线路结果的公交线,没有构造函数,通过检索回调函数获得。
属性
属性 类型 描述
name String 线路名称
startTime String 首班车时间
endTime String 末班车时间
company String 公交线路所属公司
方法
方法 返回值 描述
getNumBusStations() Number 获取公交站点个数
getBusStation(i: Number) BusStation 获取某一个具体的公交站对象
getPath() Array<Point> 返回公交线地理坐标点数组
getPolyline() Polyline 获取公交线几何对象, 仅当结果自动添加到地图上时有效
Line
此类表示一条公交线路。没有构造函数,通过TransitRoutePlan.getLine()方法得到。
属性
属性 类型 描述
title String 公交线路全称
type LineType 公交线路类型
方法
方法 返回值 描述
getNumViaStops() Number 返回公交线路途径的车站个数
getGetOnStop() LocalResultPoi 返回上车站
getGetOffStop() LocalResultPoi 返回下车站
getPath() Array<Point> 返回线路对应的地理坐标点数组,在公交方案中,地理坐标只给出方案涉及的部分
getPolyline() Polyline 返回公交线路对应的折线覆盖物
getDistance(format: Boolean) String | Number 当format为true时,返回本段公交线路的距离字符串(包含单位),当format为false时仅返回数值(单位为米)。默认参数为true
BusListItem
一个具体公交对象
属性
属性 类型 描述
name String 公交线名称
BusStation
公交站点对象
属性
属性 类型 描述
name String 站点名称
position Point 站点坐标
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类的可选参数对象
属性
属性 类型 描述
location String | Map | Point 设定返回结果的所属范围。例如“北京市”
types Array<String> 返回数据类型。两种设置方式,第一种为默认值(即设置值为空),将返回所有数据。如地图初始化为北京,在输入框中输入“小”,输入框下会出现包含“小”关键字的多种类型(如餐饮、地名等)的提示词条。第二种设置值为"city",将返回省市区县乡镇街道地址类型数据。如地图初始化为北京,在输入框中输入“小”,输入框下会出现“小金县”的地点名称类的提示词条
onSearchComplete Function 在input框中输入字符后,发起列表检索,完成后的回调函数。 参数:AutocompleteResult
input String | HTMLElement 文本输入框元素或其id
AutocompleteResultPoi
自动完成类获取的单个POI点的信息
属性
属性 类型 描述
province String 省名
City String 城市名
district String 区县名称
street String 街道名称
streetNumber String 门牌号码
business String 商户名
AutocompleteResult
自动完成检索完成回调函数的参数对象
属性
属性 类型 描述
keyword String 检索关键字
方法
方法 返回值 描述
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
Convertor
用于将其他坐标系的坐标转换为百度坐标。
构造函数
构造函数 描述
Convertor() 创建一个坐标转换的实例
方法
方法 返回值 描述
translate(points: Array<BMap.Point>, from: number, to: number, callback: function) none 对指定的点数组进行坐标转换,转换规则为从from到to,转换完成后调用callback,callback的参数为Object 。一次最多10个点,from和to的含义请参照Web服务API
TranslateResults
此类是Convertor.translate()中回调函数的参数。
属性
属性 类型 描述
status number 转换结果状态吗,参考Web服务API
points Array<BMap.Point> 转换完成的点数组,点顺序和转换前一致
StatusCode
此常量用于描述对象当前状态。
常量
常量 描述
BMAP_STATUS_SUCCESS 检索成功。对应数值“0”
BMAP_STATUS_CITY_LIST 城市列表。对应数值“1”
BMAP_STATUS_UNKNOWN_LOCATION 位置结果未知。对应数值“2”
BMAP_STATUS_UNKNOWN_ROUTE 导航结果未知。对应数值“3”
BMAP_STATUS_INVALID_KEY 非法密钥。对应数值“4”
BMAP_STATUS_INVALID_REQUEST 非法请求。对应数值“5”
BMAP_STATUS_PERMISSION_DENIED 没有权限。对应数值“6”
BMAP_STATUS_SERVICE_UNAVAILABLE 服务不可用。对应数值“7”
BMAP_STATUS_TIMEOUT 超时。对应数值“8”

全景类

Panorama
此类用来展示某位置的全景视图,可以单独放置在一个div容器中,也可以放在Map类的容器中。
构造函数
构造函数 描述
Panorama(container: String | HTMLElement, opts: PanoramaOptions) 在给定的结点中创建全景
方法
方法 返回值 描述
getLinks() Array<PanoramaLink> 获取全景中道路指示信息
getId() String 获取当前全景的id
getPosition() Point 获取当前全景的位置,通过经纬度描述
getPov() PanoramaPov 获取当前全景的视角
getZoom() Number 获取当前全景的级别
setId(id: String) none 设置全景的id
setPosition(position: Point) none 设置全景的位置
setPov(pov: PanoramaPov) none 设置全景的视角
setZoom(zoom: Number) none 设置全景的级别
enableScrollWheelZoom() none 开启鼠标滚轮缩放功能。仅对PC上有效
disableScrollWheelZoom() none 关闭鼠标滚轮缩放功能
show() none 显示全景
hide() none 隐藏全景
addOverlay(overlay: PanoramaLabel) none 全景场景内添加覆盖物
removeOverlay(overlay: PanoramaLabel) none 删除全景内的覆盖物
getSceneType() Enum PanoramaSceneType 获取全景的类型(室外景返回BMAP_PANORAMA_STREET_SCENE、室内景返回BMAP_PANORAMA_INDOOR_SCENE)
setOptions(opts: PanoramaOptions) none 设置全景可配置参数
setPanoramaPOIType() Enum PanoramaPOIType 设置全景外景场景点内可见的POI类型,默认为隐藏所有类型poi
事件
事件 参数 描述
position_changed none 全景位置发生变化时触发
links_changed none 全景相邻道路发生变化时触发,通常是在位置变化时,异步获取新数据之后触发
pov_changed none 全景视角发生变化时触发
zoom_changed none 全景级别发生变化时触发
scene_type_changed none 全景场景点类型改变(室内景、室外景)时触发
PanoramaOptions
此类为Panorama类构造函数的可选参数,使用对象字面量形式表示,不可实例化。
属性
属性 类型 描述
navigationControl boolean 是否显示全景的导航控件,默认为true
linksControl boolean 是否显示道路指示控件。默认为true
indoorSceneSwitchControl boolean 是否显示全景室内场景的切换控件,默认为false,仅对室内景生效
albumsControl boolean 是否显示相册控件,默认为false
albumsControlOptions AlbumsControlOptions 全景相册控件配置参数
PanoramaLink
此类用来描述全景中道路指示中相邻全景的信息。使用对象字面量形式表示,不可实例化。
属性
属性 类型 描述
description String 相连全景的描述信息
heading Number 相连道路的方向,正北方向为0,正东为90,正南为180,正西为270
id String 相邻全景的id
PanoramaPov
此类描述全景的视角。使用对象字面量形式表示,不可实例化。
属性
属性 类型 描述
heading Number 水平方向的角度,正北方向为0,正东为90,正南为180,正西为270
pitch Number 竖直方向的角度,向上最大到90度,向下最大到-90度。(在某些场景下,俯角可能无法到达最大值)
PanoramaService
此类用来检索全景数据信息。
构造函数
构造函数 描述
PanoramaService() 在创建检索全景数据信息类的实例
方法
方法 返回值 描述
getPanoramaById(id: String, callback: function, data: PanoramaData) none 根据全景id返回全景数据,当获取不到数据时,回调函数参数为null
getPanoramaByLocation(point: Point, radius: number, callback: function, data: PanoramaData) none 根据坐标及半径返回该范围内的全景数据;不设置半径参数时,默认半径为50米;当获取不到数据时,回调函数参数为null
PanoramaData
通过PanoramaService类检索获得。使用对象字面量形式表示,不可实例化。
属性
属性 类型 描述
id String 全景id
description String 全景的描述信息
links Array<PanoramaLink> 全景相邻道路信息
position Point 全景的地理坐标
tiles PanoramaTileData 全景图块信息
PanoramaTileData
此类是图块数据信息,不可实例化。
属性
属性 类型 描述
centerHeading Number 整个全景图中心位置的方位(单位角度)
tileSize Size 图块展示的尺寸(单位像素),注意这个尺寸与实际的图片尺寸可能不同
worldSize Size 整个全景图的尺寸(单位像素)
PanoramaLabel
该类提供在全景中添加标签功能。
构造函数
构造函数 描述
PanoramaLabel(content: String, opts: PanoramaLabelOptions) 构造函数,在全景中创建一个标签,content参数表示标签的文本内容,opts参数包含标签的经纬度坐标和高度
方法
方法 返回值 描述
setPosition(position: Point) none 设置标签的经纬度坐标
getPosition() Point 获取标签的经纬度坐标
getPov() PanoramaPov 获取标签与全景中心点的视角
setContent(content: String) none 设置标签显示内容
getContent() String 获取标签的显示内容
show() none 设置标签可见
hide() none 设置标签不可见
setAltitude(altitude: Number) none 设置标签距离地面的高度
getAltitude() Number 获取标签距离地面的高度
addEventListener() none 注册事件
removeEventListener() none 移除事件
事件
事件 参数 描述
click type,target 单击标签时触发该事件
mouseover type,target 鼠标移入标签时触发该事件
mouseout type,target 鼠标移出标签时触发该事件
remove type,target 删除标签时触发该事件
PanoramaLabelOptions
此类为PanoramaLabel类构造函数的可选参数,使用对象字面量形式表示,不可实例化。
属性
属性 类型 描述
position Point 文本标注的地理位置
altitude Number 文本标注在全景场景点中距地面的高度。(javascript全景实现方式暂不支持),默认为2米
AlbumsControlOptions
此类为全景相册控件的可选参数,使用对象字面量形式表示,不可实例化。
属性
属性 类型 描述
anchor ControlAnchor 相册控件的停靠位置
offset Size 相册的偏移量
maxWidth Number | String 相册控件的最大宽度,可以设置总宽度百分比(例如50%) 或者像素数字(500),默认值为100%
imageHeight Number 相册内图片的高度。默认为80px。(为保证图片比例,只设置高度,宽度自如会拉宽)
PanoramaSceneType
常量区分室内场景和室外场景,其中室内景包括酒店内部、景区内部及高校内部等。
常量
常量 描述
BMAP_PANORAMA_INDOOR_SCENE 全景场景点的类型为室内场景
BMAP_PANORAMA_STREET_SCENE 全景场景点的类型为室外场景
PanoramaPOIType
常量表示要在全景内显示的poi类型。
常量
常量 描述
BMAP_PANORAMA_POI_HOTEL 酒店类
BMAP_PANORAMA_POI_CATERING 餐饮类
BMAP_PANORAMA_POI_MOVIE 电影院
BMAP_PANORAMA_POI_TRANSIT 公交站点
BMAP_PANORAMA_POI_INDOOR_SCENE 室内景
BMAP_PANORAMA_POI_NONE 无,即隐藏所有的poi类型