地图API类参考7802894.doc
55页
百度地图 API 类参考百度地图 API 类参考一、a)核心类Map此类是地图 API 的核心类，用来实例化一个地图构造函数构造函数Map(container:String|HTMLElement[, opts:MapOptions])描述在指定的容器内创建地图实例，之后需要调用Map.centerAndZoom()方法对地图进行初始化未进行初始化的地图将不能进行任何操作配置方法返方法回值enableDragging()disableDragging()enableScrollWheelZoom()disableScrollWheelZoom()enableDoubleClickZoom()disableDoubleClickZoom()nonenone启用地图拖拽，默认启用禁用地图拖拽描述none启用滚轮放大缩小，默认禁用none禁用滚轮放大缩小none启用双击放大，默认启用none禁用双击放大启用键盘操作，默认禁用键盘的上、下、左、右键可连续移动地enableKeyboard()none图同时按下其中两个键可使地图进行对角移动PgUp、PgDn、Home和 End 键会使地图平移其1/2的大小。
键会使地图放大或缩小一级disableKeyboard()enableInertialDragging()disableInertialDragging()enableContinuousnone禁用键盘操作启用地图惯性拖拽（默认为关闭状态）自 1.1 新增)禁用地图惯性拖拽(自 1.1 新增)启用连续缩放效果（默认为禁用状态）1 / 55nonenonenone百度地图 API 类参考Zoom()disableContinuousZoom()enablePinchToZoom()disablePinchToZoom()none(自 1.1 新增)禁用连续缩放效果(自 1.1 新增)启用双指操作缩放（默认为开启状态）自 1.1 新增)禁用双指操作缩放自 1.1 新增)nonenone地图状态方法返方法回值getBounds()BoundsPointNumberMapgetMapType()TypesgetSize()Size返回地图可视区域，以地理坐标表示描述getCenter()getDistance(start:Point,end:Point)返回地图当前中心点获取两点之间的距离，单位是米。
自 1.1 新增)获取地图类型自 1.1 新增)返回地图视图的大小，以像素表示根据提供的地理区域或坐标获得最佳的地图视getViewport(view: Array
设置地图中心点地理坐标设置地图城市，注意当地图初始化时的类型设置为 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);注意：初始化的坐标应与您设置的城市对应，否则地图将无法正常显示如果地图初始化为 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
自 1.1 新增)根据提供的地理区域或坐标设置地图视野，调整后的视野会保证包含提供的地理区域或坐标自 1.1 新增)将视图切换到指定的缩放等级，中心点坐标不变注意：当有信息窗口在地图上打开时，地图缩放将保证信息窗口所在的坐标位置不动放大一级视图zoomTo(zoom:Number)nonenonezoomIn()3 / 55百度地图 API 类参考zoomOut()none缩小一级视图控件方法方法addControl(control:Control)removeControl(control:Control)返回值none描述将控件添加到地图，一个控件实例只能向地图中添加一次从地图中移除控件如果控件从未被添加到地图中，则该移除不起任何作用返回地图的容器元素当创建用户自定义控件时，需要自行实现 Control.initialize()方法，并将控件的容器元素添加到地图上，通过此方法可获得地图容器nonegetContainer()HTMLElement右键菜单方法方法addContextMenu(menu:ContextMenu)removeContextMenu(menu:ContextMenu)返回值nonenone描述添加右键菜单。
移除右键菜单覆盖物方法方法addOverlay(overlay:Overlay)removeOverlay(overlay:Overlay)clearOverlays()openInfoWindow(infoWnd:InfoWindow, point:Point)closeInfoWindow()返回值none描述将覆盖物添加到地图中，一个覆盖物实例只能向地图中添加一次从地图中移除覆盖物如果覆盖物从未被添加到地图中，则该移除不起任何作用清除地图上所有覆盖物在地图上打开信息窗口关闭在地图上打开的信息窗口在标注上打开的信息窗口也可通过此方法进行关闭根据地理坐标获取对应的覆盖物容器的坐标，此方法Pixel用于自定义覆盖物自 1.1 新增)PointInfoWindow|Nul根据覆盖物容器的坐标获取对应的地理坐标自 1.1 新增)获取地图上处于打开状态的信息窗的实例当地图没有打开的信息窗口时，此方法返回 null4 / 55nonenonenonenonepointToOverlayPixel(point:Point)overlayPixelToPoint(pixel:Pixel)getInfoWindow()百度地图 API 类参考lgetOverlays()Array
自 1.1 新增)获取地图覆盖物容器列表对象包含覆盖物可被添加的各个 HTML 容器元素此方法返回的对象包括：{floatPane,markerMouseTarget,floatShadow,labelPane,markerPane,mapPane}(自 1.1 新增)getPanes()Object地图图层方法方法addTileLayer(tileLayer:TileLayer)removeTileLayer(tilelayer:TileLayer)getTileLayer(mapType:String)返回值nonenoneTileLayer描述添加一个自定义地图图层移除一个自定义地图图层通过地图类型得到一个地图图层对象坐标变换方法pixelToPoint(pixel:Pixel)pointToPixel(point:Point)返回值PointPixel描述像素坐标转换为经纬度坐标经纬度坐标转换为像素坐标事件事件参数描述左键单击地图时触发此事件clickevent{type,target,当双击时，产生的事件序列为：click click dblclick(自 1.1 更新)dblclickrightclickevent{type,pixel, point}event{type,target,target,鼠标双击地图时会触发此事件。
右键单击地图时触发此事件当双击时，产生的事件序列为：5 / 55point, pixel, overlay}point, pixel, overlay}百度地图 API 类参考rightclick rightclick rightdblclick(自 1.1 更新)rightdblclickmaptypechangemousemovemovestartmovingmoveendzoomstartzoomendaddoverlayaddcontrolremovecontrolremoveoverlayclearoverlaysdragstartdraggingdragendaddtilelayerremovetevent{type,target,右键双击地图时触发此事件。
