百度地图API类参考.docx

1、XX地图API类参考XX地图 API 类参考XX地图 API 类参考一、a)核心类Map此类是地图 API 的核心类，用来实例化一个地图。构造函数构造函数Map(container:String|HTMLElement, opts:MapOptions)描述在指定的容器内创建地图实例，之后需要调用Map.centerAndZoom()方法对地图进行初始化。未进行初始化的地图将不能进行任何操作。配置方法返方法回值enableDragging()disableDragging()enableScrollWheelZoom()disableScrollWheelZoom()enableDoubleC

2、lickZoom()disableDoubleClickZoom()nonenone启用地图拖拽，默认启用。禁用地图拖拽。描述none启用滚轮放大缩小，默认禁用。none禁用滚轮放大缩小。none启用双击放大，默认启用。none禁用双击放大。启用键盘操作，默认禁用。键盘的上、下、左、右键可连续移动地enableKeyboard()none图。同时按下其中两个键可使地图进行对角移动。PgUp、PgDn、Home和 End 键会使地图平移其1/2的大小。+、-键会使地图放大或缩小一级。disableKeyboard()enableInertialDragging()disableInertialD

3、ragging()enableContinuousnone禁用键盘操作。启用地图惯性拖拽（默认为关闭状态）。(自 1.1 新增)禁用地图惯性拖拽(自 1.1 新增)启用连续缩放效果（默认为禁用状态）。1 / 55nonenonenoneXX地图 API 类参考Zoom()disableContinuousZoom()enablePinchToZoom()disablePinchToZoom()none(自 1.1 新增)禁用连续缩放效果(自 1.1 新增)启用双指操作缩放（默认为开启状态）。(自 1.1 新增)禁用双指操作缩放。(自 1.1 新增)nonenone地图状态方法返方法回值getB

4、ounds()BoundsPointNumberMapgetMapType()TypesgetSize()Size返回地图可视区域，以地理坐标表示。描述getCenter()getDistance(start:Point,end:Point)返回地图当前中心点。获取两点之间的距离，单位是米。(自 1.1 新增)获取地图类型。(自 1.1 新增)返回地图视图的大小，以像素表示。根据提供的地理区域或坐标获得最佳的地图视getViewport(view: Array,viewportOptions:ViewportOptions)Viewport野，返回的对象中包含 center 和 zoom 属性

5、，分别表示地图的中心点和级别。此方法仅返回视野信息，不会将新的中心点和级别做用到当前地图上。(自 1.1 新增)getZoom()NumberString返回地图当前缩放级别。toString()返回类型描述字符串。修改地图状态方法返方法回值2 / 55描述XX地图 API 类参考centerAndZoom(center:Point,zoom:Number)none设置地图中心点地理坐标，并改变缩放等级。在创建地图实例后应立即调用此方法对地图进行初始化。将地图的中心点更改为给定的点。如果该点在当前的地图视图中已经可见，则会以平滑动画的方式移动到中心点位置。将地图在水平位置上移动 x 像素，垂直

6、位置上移动 y 像素。如果指定的像素大于可视区域范围，不执行滑动效果。重新设置地图，恢复地图初始化时的中心点和级别。设置地图中心点地理坐标。设置地图城市，注意当地图初始化时的类型设置为 BMAP_PERSPECTIVE_MAP 时，需要在调用centerAndZoom 之前调用此方法设置地图所在城市。例如：var map = new BMap.Map(“container”,mapType: BMAP_PERSPECTIVE_MAP);map.setCurrentCity(“北京市”);map.centerAndZoom(newBMap.Point(116.404, 39.915), 18);

7、注意：初始化的坐标应与您设置的城市对应，否则地图将无法正常显示如果地图初始化为 BMAP_NORMAL_MAP，则在调用 setMapType 切换地图类型时不必调用此方法。(自 1.1 新增)panTo(center:Point)nonepanBy(x:Number, y:Number)nonenonenonereset()setCenter(center:Point)setCurrentCity(city: String)nonesetMapType(mapType:MapTypes)setViewport(view:Array|Viewport,ViewportOptions)viewp

8、ortOptions:nonenone设置地图类型。(自 1.1 新增)根据提供的地理区域或坐标设置地图视野，调整后的视野会保证包含提供的地理区域或坐标。(自 1.1 新增)将视图切换到指定的缩放等级，中心点坐标不变。注意：当有信息窗口在地图上打开时，地图缩放将保证信息窗口所在的坐标位置不动。放大一级视图。zoomTo(zoom:Number)nonenonezoomIn()3 / 55XX地图 API 类参考zoomOut()none缩小一级视图。控件方法方法addControl(control:Control)removeControl(control:Control)返回值none描述将

9、控件添加到地图，一个控件实例只能向地图中添加一次。从地图中移除控件。如果控件从未被添加到地图中，则该移除不起任何作用。返回地图的容器元素。当创建用户自定义控件时，需要自行实现 Control.initialize()方法，并将控件的容器元素添加到地图上，通过此方法可获得地图容器。nonegetContainer()HTMLElement右键菜单方法方法addContextMenu(menu:ContextMenu)removeContextMenu(menu:ContextMenu)返回值nonenone描述添加右键菜单。移除右键菜单。覆盖物方法方法addOverlay(overlay:Ove

10、rlay)removeOverlay(overlay:Overlay)clearOverlays()openInfoWindow(infoWnd:InfoWindow, point:Point)closeInfoWindow()返回值none描述将覆盖物添加到地图中，一个覆盖物实例只能向地图中添加一次。从地图中移除覆盖物。如果覆盖物从未被添加到地图中，则该移除不起任何作用。清除地图上所有覆盖物。在地图上打开信息窗口。关闭在地图上打开的信息窗口。在标注上打开的信息窗口也可通过此方法进行关闭。根据地理坐标获取对应的覆盖物容器的坐标，此方法Pixel用于自定义覆盖物。(自 1.1 新增)PointI

11、nfoWindow|Nul根据覆盖物容器的坐标获取对应的地理坐标。(自 1.1 新增)获取地图上处于打开状态的信息窗的实例。当地图没有打开的信息窗口时，此方法返回 null。4 / 55nonenonenonenonepointToOverlayPixel(point:Point)overlayPixelToPoint(pixel:Pixel)getInfoWindow()XX地图 API 类参考lgetOverlays()Array(自 1.1 新增)获取地图上的所有覆盖物。(自 1.1 新增)获取地图覆盖物容器列表。对象包含覆盖物可被添加的各个 HTML 容器元素。此方法返回的对象包括：f

12、loatPane,markerMouseTarget,floatShadow,labelPane,markerPane,mapPane(自 1.1 新增)getPanes()Object地图图层方法方法addTileLayer(tileLayer:TileLayer)removeTileLayer(tilelayer:TileLayer)getTileLayer(mapType:String)返回值nonenoneTileLayer描述添加一个自定义地图图层。移除一个自定义地图图层。通过地图类型得到一个地图图层对象。坐标变换方法pixelToPoint(pixel:Pixel)pointToP

13、ixel(point:Point)返回值PointPixel描述像素坐标转换为经纬度坐标。经纬度坐标转换为像素坐标。事件事件参数描述左键单击地图时触发此事件。clickeventtype,target,当双击时，产生的事件序列为：click click dblclick(自 1.1 更新)dblclickrightclickeventtype,pixel, pointeventtype,target,target,鼠标双击地图时会触发此事件。右键单击地图时触发此事件。当双击时，产生的事件序列为：5 / 55point, pixel, overlaypoint, pixel, overlayXX

14、地图 API 类参考rightclick rightclick rightdblclick(自 1.1 更新)rightdblclickmaptypechangemousemovemovestartmovingmoveendzoomstartzoomendaddoverlayaddcontrolremovecontrolremoveoverlayclearoverlaysdragstartdraggingdragendaddtilelayerremoveteventtype,target,右键双击地图时触发此事件。(自 1.1 新增)地图类型发生变化时触发此事件。(自 1.1 新增)鼠标在地图

15、区域移动过程中触发此事件。(自 1.1 更新)地图移动开始时触发此事件。地图移动过程中触发此事件。地图移动结束时触发此事件。地图更改缩放级别开始时触发触发此事件。地图更改缩放级别结束时触发触发此事件。当使用 Map.addOverlay()方法向地图中添加单个覆盖物时会触发此事件。当使用 Map.addControl()方法向地图中添加单个控件时会触发此事件。当使用 Map.removeControl()方法移除单个控件时会触发此事件。当使用 Map.removeOverlay()方法移除单个覆盖物时会触发此事件。当使用 Map.clearOverlays()方法一次性移除全部覆盖物时会触发此

16、事件。开始拖拽地图时触发。point, pixel, overlayeventtype, targeteventtype,target,point, pixel, overlayeventtype, targeteventtype, targeteventtype, targeteventtype, targeteventtype, targeteventtype, targeteventtype, targeteventtype, targeteventtype, targeteventtype, targeteventtype,pixel, pointeventtype,pixel, po

17、inteventtype,pixel, pointeventtype, targeteventtype, targettarget,target,target,拖拽地图过程中触发。停止拖拽地图时触发。添加一个自定义地图图层时触发此事件。移除一个自定义地图图层时触发此事件。6 / 55XX地图 API 类参考ilelayereventtype,target,调用 Map.centerAndZoom()方法时会触发此事件。这表示位置、缩放层级已经确定，但可能还在载入地图图块。地图可视区域大小发生变化时会触发此事件。loadpixel, point, zoomeventtype,sizetarget

18、,resizeb)MapOptions此类表示 Map 构造函数的可选参数。它没有构造函数，但可通过对象字面量形式表示。属性属性zoomLevelMinzoomLevelMaxmapType类型NumberNumberMapTypes描述设置地图显示最小缩放级别。设置地图显示最大缩放级别。地图类型，默认为 BMAP_NORMAL_MAP(自 1.1 新增)c)Viewport此类代表视野，不可实例化。属性属性center类型Point描述视野中心点。(自 1.1 新增)视野级别。(自 1.1 新增)zoomNumberd)ViewportOptions此类作为 map.getViewport

19、与 map.setViewport 方法的可选参数，不可实例化。属性属性enableAnimationmargins类型描述是否启用动画效果移动地图，默认为 true。当调整后的级别与当前地Boolean图级别一致时，将使用动画效果移动地图。(自 1.1 新增)Arraymargins: 30, 20, 0, 20表示坐标点会限制在上述区域内。(自 1.1 新增)地图级别的偏移量，您可以在方法得出的结果上增加一个偏移值。例zoomFactorNumber如 map.setViewport 计算出地图的级别为10，如果 zoomFactor 为-1，则最终的地图级别为9。(自 1.1 新增)改变

20、地图视野的延迟执行时间，单位毫秒，默认为200ms。此延时仅delayNumber针对动画效果有效。(自 1.1 新增)e)MapTypes此常量表示地图展示的类型。常量常量BMAP_NORMAL_MAP描述此地图类型展示普通街道视图。(自 1.1 新增)此地图类型展示透视图像视图。(自 1.1 新增)BMAP_PERSPECTIVE_MAP二、a)基础类Point此类表示一个地理坐标点。构造函数构造函数Point(lng:Number, lat:Number)描述以指定的经度和纬度创建一个地理点坐标。属性属性lnglat类型NumberNumber描述地理经度。地理纬度。方法方法equals

21、(other:Point)返回值Boolean描述判断坐标点是否相等，当且仅当两点的经度和纬度均相等时返回true。8 / 55XX地图 API 类参考toString()String返回类型描述字符串。b)Pixel此类表示地图上的一点，单位为像素。构造函数构造函数Pixel(x:Number,y:Number)描述创建像素点对象实例。像素坐标的坐标原点为地图区域的左上角。属性属性xy类型NumberNumber描述x 坐标。y 坐标。方法方法equals(other:Pixel)toString()返回值BooleanString描述判断坐标点是否相等，当且仅当两点的 x 坐标和 y 坐标

22、均相等时返回 true。返回类型描述字符串。c)Bounds此类表示地理坐标的矩形区域。矩形区域通过两个点的 x、y 坐标进行描述，其中数值较小的点位于矩形的左下角、数值较大的点位于矩形的右上角。构造函数构造函数Bounds(minX:Number, minY:Number, maxX:Number,maxY:Number)描述创建一个包含所有给定点坐标的矩形区域。属性属性minXminYmaxXmaxY类型NumberNumberNumberNumber描述矩形左下角的 x 坐标。矩形左下角的 y 坐标。矩形右上角的 x 坐标。矩形右上角的 y 坐标。9 / 55XX地图 API 类参考方法

23、方法返回值BooleanBooleanBooleanBoundsnonePointBooleanString描述当且仅当此矩形中的两点参数都等于其他矩形的两点参数时，返回 true。如果点的地理坐标位于此矩形内，则返回 true。equals(other:Bounds)containsPoint(point:Point)containsBounds(bounds:Bounds)intersects(other:Bounds)extend(point:Point)getCenter()isEmpty()传入的矩形区域完全包含于此矩形区域中，则返回 true。计算与另一矩形的交集区域。放大此矩形，

24、使其包含给定的点。返回矩形的中心点。如果矩形为空，则返回 true。toString()返回类型描述字符串。d)Size此类以像素表示一个矩形区域的大小。Size 对象包含两个属性：width、height，分别表示矩形的水平方向的数值和竖直方向的数值。属性属性widthheight类型NumberNumber描述水平方向数值。竖直方向的数值。方法方法equals(other:Size)toString()返回值BooleanString描述当且仅当此矩形中的宽度和高度都等于其他矩形的宽度和高度时，返回 true。返回类型描述字符串。三、a)控件类ControlNavigation10 / 5

25、5XX地图 API 类参考此类是所有控件的基类，您可以通过此类来实现自定义控件。所有控件均包含 Control类的属性、方法和事件。通过 Map.addControl()方法可将控件添加到地图上。构造函数构造函数Control()描述创建一个控件原型实例，通过该原型实例可创建自定义控件。属性属性defaultAnchordefaultOffset类型enumControlAnchorSize描述控件默认的停靠位置。自定义控件时需要提供此属性，作为控件的默认停靠位置。控件默认的位置偏移值。自定义控件时需要提供此属性，作为控件的默认偏移位置。方法方法返回值描述抽象方法。调用 Map.addCont

26、rol()方法添加控件时将调initialize(map:Map)HTMLElement用此方法，从而实现该控件的初始化。自定义控件时需要实现此方法，并将元素的 DOM 元素在该方法中返回。DOM元素需要添加到地图的容器中，使用map.getContainer()方法可获得地图容器元素。setAnchor(anchor:enum ControlAnchor)noneenumgetAnchor()ControlAnchorsetOffset(offset:Size)getOffset()show()hide()isVisible()toString()noneSizenonenoneBoolea

27、nString设置控件停靠的偏移量获取控件停靠的偏移量显示控件隐藏控件判断控件的可见性返回描述类型字符串。如果需要，自定义控件需要自行实现此方法以获得描述自身类型的字符串。获取控件停靠的位置设置控件停靠的位置b)ControlOptions此类表示 NavigationControl 构造函数的可选参数。它没有构造函数，但可通过对象字11 / 55XX地图 API 类参考面量形式表示。属性属性anchoroffsettype类型enum ControlAnchorSizeenum NavigationControlType描述控件的停靠位置。控件的水平偏移值。平移缩放控件的类型。c)ScaleControlOptions此类表示 ScaleControl 构造函数的可选参数。它没有构造函数，但可通过对象字面量形式表示。属性属性anchoroffset类型enum ControlAnchorSize描述控件的停靠位置。控件的偏移值。d)Copyrig