地图API类参考7802894

百度地图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:ArrayPoint[,viewportOptions:ViewportOptions])Viewport野，返回的对象中包含center和zoom属性，分别表示地图的中心点和级别。此方法仅返回视野信息，不会将新的中心点和级别做用到当前地图上。(自1.1新增)getZoom()NumberString返回地图当前缩放级别。toString()返回类型描述字符串。修改地图状态方法返方法回值2/55描述百度地图API类参考centerAndZoom(center:Point,zoom:Number)none设置地图中心点地理坐标，并改变缩放等级。在创建地图实例后应立即调用此方法对地图进行初始化。将地图的中心点更改为给定的点。如果该点在当前的地图视图中已经可见，则会以平滑动画的方式移动到中心点位置。将地图在水平位置上移动x像素，垂直位置上移动y像素。如果指定的像素大于可视区域范围，不执行滑动效果。重新设置地图，恢复地图初始化时的中心点和级别。设置地图中心点地理坐标。设置地图城市，注意当地图初始化时的类型设置为BMAP_PERSPECTIVE_MAP时，需要在调用centerAndZoom之前调用此方法设置地图所在城市。例如：varmap=newBMap.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:ArrayPoint|Viewport[,ViewportOptions])viewportOptions:nonenone设置地图类型。(自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新增)获取地图上处于打开状态的信息窗的实例。当地图没有打开的信息窗口时，此方法返回null。4/55nonenonenonenonepointToOverlayPixel(point:Point)overlayPixelToPoint(pixel:Pixel)getInfoWindow()百度地图API类参考lgetOverlays()ArrayOverlay(自1.1新增)获取地图上的所有覆盖物。(自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,当双击时，产生的事件序列为：clickclickdblclick(自1.1更新)dblclickrightclickevent{type,pixel,point}event{type,target,target,鼠标双击地图时会触发此事件。右键单击地图时触发此事件。当双击时，产生的事件序列为：5/55point,pixel,overlay}point,pixel,overlay}百度地图API类参考rightclickrightclickrightdblclick(自1.1更新)rightdblclickmaptypechangemousemovemovestartmovingmoveendzoomstartzoomendaddoverlayaddcontrolremovecontrolremoveoverlayclearoverlaysdragstartdraggingdragendaddtilelayerremovetevent{type,target,右键双击地图时触发此事件。(自1.1新增)地图类型发生变化时触发此事件。(自1.1新增)鼠标在地图区域移动过程中触发此事件。(自1.1更新)地图移动开始时触发此事件。地图移动过程中触发此事件。地图移动结束时触发此事件。地图更改缩放级别开始时触发触发此事件。地图更改缩放级别结束时触发触发此事件。当使用Map.addOverlay()方法向地图中添加单个覆盖物时会触发此事件。当使用Map.addControl()方法向地图中添加单个控件时会触发此事件。当使用Map.removeControl()方法移除单个控件时会触发此事件。当使用Map.removeOverlay()方法移除单个覆盖物时会触发此事件。当使用Map.clearOverlays()方法一次性移除全部覆盖物时会触发此事件。开始拖拽地图时触发。point,pixel,overlay}event{type,target}event{type,target,point,pixel,overlay}event{type,target}event{type,target}event{type,target}event{type,target}event{type,target}event{type,target}event{type,target}event{type,target}event{type,target}event{type,target}event{type,pixel,point}event{type,pixel,point}event{type,pixel,point}event{type,target}event{type,target}target,target,target,拖拽地图过程中触发。停止拖拽地图时触发。添加一个自定义地图图层时触发此事件。移除一个自定义地图图层时触发此事件。6/55百度地图API类参考ilelayerevent{type,target,调用Map.centerAndZoom()方法时会触发此事件。这表示位置、缩放层级已经确定，但可能还在载入地图图块。地图可视区域大小发生变化时会触发此事件。loadpixel,point,z