《地图API类参考7》由会员分享，可在线阅读，更多相关《地图API类参考7（50页珍藏版）》请在金锄头文库上搜索。
1、百度地图API类参考百度地图API类参考一、核心类a）Map此类是地图API的核心类，用来实例化一个地图。构造函数构造函数描述Map(container:String|HTMLElement, opts:MapOptions)在指定的容器内创建地图实例，之后需要调用Map.centerAndZoom（）方法对地图进行初始化。未进行初始化的地图将不能进行任何操作。配置方法方法返 回 值描述enableDragging()none启用地图拖拽，默认启用。disableDragging()none禁用地图拖拽。enableScrollWhee lZoom()none启用滚轮放大缩小，默认禁用。dis
2、ableScrollWheelZoom()none禁用滚轮放大缩小。enableDoubleClickZoom()none启用双击放大，默认启用。disableDoubleClickZoom()none禁用双击放大。enableKeyboard()none启用键盘操作，默认禁用。键盘的上、下、左、右键可连续移动地图。同时按下其中两个键可使地图进行对角移动。PgUp、PgDn Home和End键会使地图平移其1/2的大小。+、-键会使地图放大或缩小一 级。disableKeyboard()none禁用键盘操作。enableInertialDragging()none启用地图惯性拖拽（默认为关闭状
3、态）。（自1.1新增）disableInertialDragging()none禁用地图惯性拖拽（自1.1新增）enableContinuousnone启用连续缩放效果（默认为禁用状态）。Zoom()（自1.1新增）disableContinuousZoom()none禁用连续缩放效果（自1.1新增）enablePinchToZoom()none启用双指操作缩放（默认为开启状态）。（自1.1新增）disablePinchToZoom()none禁用双指操作缩放。（自1.1新增）地图状态方法方法返 回 值描述getBounds()Bounds返回地图可视区域，以地理坐标表示。getCenter(
4、)Point返回地图当前中心点。getDistance(start:Point, end:Point)Number获取两点之间的距离，单位是米。（自1.1新增）getMapType()Map Typ es获取地图类型。（自1.1新增）getSize()Siz e返回地图视图的大小，以像素表示。getViewport(view: Array, viewportOptions:ViewportOptions)Viewpo rt根据提供的地理区域或坐标获得最佳的地图视野，返回的对象中包含center 和zoom属性，分别表示地图的中心点和级别。此方法仅返回视野信息，不会将新的中心点和级 别做用到当前
5、地图上。（自1.1新增）getZoom()Number返回地图当前缩放级别。toString()Str ing返回类型描述字符串。修改地图状态方法方法返 回 值描述centerAndZoom(center:Point, zoom:Number)none设置地图中心点地理坐标，并改变缩放等级。在 创建地图实例后应立即调用此方法对地图进行 初始化。panTo(center:Point)none将地图的中心点更改为给定的点。如果该点在当 前的地图视图中已经可见，则会以平滑动画的方 式移动到中心点位置。panBy(x:Number, y:Number)none将地图在水平位置上移动 x像素，垂直位置上
6、移 动y像素。如果指定的像素大于可视区域范围， 不执行滑动效果。reset()none重新设置地图，恢复地图初始化时的中心点和级 别。setCenter(center:Point)none设置地图中心点地理坐标。setCurrentCity(city: String)none设置地图城市，注意当地图初始化时的类型设置为 BMAP_PERSPECTIVE_MAP时，需要在调用centerAndZoom之前调用此方法设置地图所在城市。例如：var map = new BMap.Map（ a container , mapType: BMAP_PERSPECTIVE_MAP）;map.setCurr
7、entCity（北京市”）;map.centerAndZoom（newBMap.Point（116.404, 39.915）, 18）;注意：初始化的坐标应与您设置的城市对应，否则地图将无法正常显示如果地图初始化为BMAP_NORMAL_MA P则在调用setMapType 切换地图类型时不必调用此方法。（自1.1新增）setMapType(mapType:MapTypes)none设置地图类型。（自1.1新增）setViewport(view:Array|Viewport,viewportOptions:ViewportOptions)none根据提供的地理区域或坐标设置地图视野，调整后的视
8、野会保证包含提供的地理区域或坐标。（自1.1新增）zoomTo(zoom:Number)none将视图切换到指定的缩放等级，中心点坐标不 变。注意：当有信息窗口在地图上打开时，地图 缩放将保证信息窗口所在的坐标位置不动。zoomIn()none放大一级视图。zoomOut()none缩小一级视图。控件方法方法返回值描述addControl(control :Control)none将控件添加到地图，一个控件实例只能向地图中添加一次。removeControl(cont rol:Control)none从地图中移除控件。如果控件从未被添加到地图中，则该移除 不起任何作用。getContainer
9、()HTMLElement返回地图的容器元素。当创建用户自定义控件时，需要自行实现Control.initialize（）方法，并将控件的容器元素添加到地图上，通过此方法可获得地图容器。右键菜单方法方法返回值描述addContextMenu(menu:ContextMenu)none添加右键菜单。removeContextMenu(menu:ContextMenu)none移除右键菜单。覆盖物方法方法返回值描述addOverlay(overlay:Overl ay)none将覆盖物添加到地图中，一个覆盖物实例只能向地图 中添加一次。removeOverlay(overlay:Overlay)n
10、one从地图中移除覆盖物。如果覆盖物从未被添加到地图 中，则该移除不起任何作用。clearOverlays()none清除地图上所有覆盖物。openInfoWindow(infoWnd:I nfoWindow, point:Point)none在地图上打开信息窗口。closeInfoWindow()none关闭在地图上打开的信息窗口。在标注上打开的信息 窗口也可通过此方法进行关闭。pointToOverlayPixel(point:Point)Pixel根据地理坐标获取对应的覆盖物容器的坐标，此方法用于自定义覆盖物。（自1.1新增）overlayPixelToPoint(pixe l:Pixe
11、l)Point根据覆盖物容器的坐标获取对应的地理坐标。（自1.1新增）getInfoWindow()InfoWindow|Nul获取地图上处于打开状态的信息窗的实例。当地图没有打开的信息窗口时，此方法返回null ol（自1.1新增）getOverlays()Array获取地图上的所有覆盖物。（自1.1新增）getPanes()Object获取地图覆盖物容器列表。对象包含覆盖物可被添加的各个HTML容器元素。此方法返回的对象包括：floatPane,markerMouseTarget, floatShadow, labelPane, markerPane, mapPane （自1.1新增）地图
12、图层方法方法返回值描述addTileLayer(tileLayer:TileLayer)none添加一个自定义地图图层。removeTileLayer(tilelayer:TileLay er)none移除一个自定义地图图层。getTileLayer(mapType:String)TileLayer通过地图类型得到一个地图图层对象。坐标变换方法返回值描述pixelToPoint(pixel:Pixel)Point像素坐标转换为经纬度坐标。pointToPixel(point:Point)Pixel经纬度坐标转换为像素坐标。事件事件参数描述clickeventtype, point, pixel
13、, overlaytarget,左键单击地图时触发此事件。当双击时，产生的事件序列为：click click dblclick（自1.1更新）dblclickeventtype, pixel, pointtarget,鼠标双击地图时会触发此事件。rightcl ickeventtype, point, pixel, overlaytarget,右键单击地图时触发此事件。 当双击时，产生的事件序列为：rightclick rightclick rightdblclick（自1.1更新）rightdbIclickeventtype,target,point, pixel, overlay右键双击地
14、图时触发此事件。(自1.1新增)maptype changeeventtype, target地图类型发生变化时触发此事件。(自1.1新增)mousemoveeventtype,target,point, pixel, overlay鼠标在地图区域移动过程中触发此事件。(自1.1更新)movestarteventtype, target地图移动开始时触发此事件。movingeventtype, target地图移动过程中触发此事件。moveendeventtype, target地图移动结束时触发此事件。zoomstarteventtype, target地图更改缩放级别开始时触发触发此事件。zoo
