您当前的位置: 首页 > JavaScript API 触控版 > 核心类

Class:核心类/Map
目录
构造函数
构造函数 描述
Map(container:String|HTMLElement, center:Point|KeyPoint|GbPoint, zoom:Number [, opts:MapOptions]) 在指定的容器内创建地图实例,之后需要调用Map.load()方法对地图进行初始化。 (container为指定容器节点对象或ID;center为地图初始化中心点位置坐标;zoom为地图初始化级别;opts为可选地图配置参数)
MapOptions
属性 类型 描述
minZoom Number 地图允许展示的最小级别
maxZoom Number 地图允许展示的最大级别
enableAutoResize Boolean 是否自动适应容器尺寸变化,默认禁用
viewBounds Bounds 地图允许展示的可视范围
核心方法
方法 返回值 描述
load() none 加载地图, 在创建地图实例后必须调用此方法才会正常加载地图
配置方法
方法 返回值 描述
enableInertialDragging() none 启用地图惯性拖拽,默认禁用
disableInertialDragging() none 禁用地图惯性拖拽
enableDoubleClickZoom() none 启用双击放大,默认启用
disableDoubleClickZoom() none 禁用双击放大
enableCenterIcon([o:Object{ width: Number, height: Number, image: String }]) none 启用地图中心点图标,默认禁用。 (o为可选参数,属性分别为中心图片宽度、中心图片高度、中心图片地址)
disableCenterIcon() none 禁用地图中心点图标
enableDragging() none 启用地图拖拽,默认启用
disableDragging() none 禁用地图拖拽
enableScrollWheelZoom() none 启用滚轮缩放,默认启用
disableScrollWheelZoom() none 禁用滚轮缩放
enablePinchToZoom() none 启用双指触控缩放,默认启用
disablePinchToZoom() none 禁用双指触控缩放
enableAutoResize() none 启用自动适应容器尺寸变化,默认禁用
disableAutoResize() none 禁用自动适应容器尺寸变化
setMinZoom(zoom:Number) none 设置地图允许的最小级别。取值不得小于地图类型所允许的最小级别
setMaxZoom(zoom:Number) none 设置地图允许的最大级别。取值不得大于地图类型所允许的最大级别
地图状态方法
方法 返回值 描述
getCenter() Point 获取当前中心点
getZoom() Number 获得缩放级别。(范围为从3到19,数值越大,地图内容越详细)
getBounds() Bounds 获得视图范围
pointInMap(point:Point|KeyPoint|GbPoint) Boolean 判断点是否在视图内
getDistance(aPoint:Point|KeyPoint|GbPoint, bPoint:Point|KeyPoint|GbPoint) Number 计算两点间的距离(单位为:米)
getPoint2LineDistance(point:Point|KeyPoint|GbPoint, aPoint:Point|KeyPoint|GbPoint, bPoint:Point|KeyPoint|GbPoint) Number 计算点到线段的距离,point为目标点,aPointbPoint为目标线段的起终点。(单位为:米)
getSize() Size 获得地图视图的宽高大小
getViewport(points:Array [,margins: Array]) Viewport 根据提供的坐标获得最佳的地图视野。此方法仅返回视野信息,不会将新的中心点和级别作用到当前地图上。 (margins为视野调整的预留边距,数组的四个数值分别表示上、右、下、左边距,默认预留边距为[6, 6, 6, 6])
getBoundsByDistance( point: Point|KeyPoint|GbPoint, d: Number) Bounds 通过中心点和半径,获取圆形外框。(point为中心点坐标;d为半径,单位为:米,取值范围为:100-20000)
修改地图状态方法
方法 返回值 描述
centerAndZoom(center:Point|KeyPoint|GbPoint|String,zoom:Number) none 地图定位并且缩放到对应级别。center除了可以为坐标点外,还支持城市名
setCenter(center:Point|KeyPoint|GbPoint|String) none 设设置地图中心点。center除了可以为坐标点外,还支持城市名。 (如果该点在当前的地图视图中已经可见,则会以平滑动画的方式移动到中心点位置)
setCurrentCity(city:String) none 设置地图城市
setZoom(zoom:Number) none 设置缩放级别。(范围为从4到18,数值越大,地图内容越详细)
pan (offsetx:Number, offsety:Number) none 平移地图。(offsetx和offsety都以像素表示,正负数代表平移方向)
zoomIn([point:Point|KeyPoint|GbPoint]) none 放大地图。 (point可选参数,是放大地图的中心位置)
zoomOut([point:Point|KeyPoint|GbPoint]) none 缩小地图。(point可选参数,是缩小地图的中心位置)
setSize (width:Number,height:Number) none 设置地图视图的大小
setViewport(points:Array [,margins: Array]) none 根据提供的坐标设置最佳的地图视野,调整后的视野会保证包含提供的坐标。 (margins为视野调整的预留边距,数组的四个数值分别表示上、右、下、左边距,默认预留边距为[6, 6, 6, 6])
控件方法
方法 返回值 描述
addMapControl (contrl: Control|Navigation|Overview|Scale |InfoWindow|CustomPanel) none 将控件添加到地图,一个控件实例只能向地图中添加一次
removeMapControl (contrl: Control|Navigation|Overview|Scale |InfoWindow|CustomPanel) none 从地图中移除控件。如果控件从未被添加到地图中,则该移除不起任何作用
getUserContainer() HTMLElement 返回地图的容器元素。当创建用户自定义控件时,需要自行实现Control.initialize()方法,并将控件的容器元素添加到地图上,通过此方法可获得地图容器
setCopyrightColor(color: String) none 设置版权信息的字体颜色
openInfoWindow(win: InfoWindow|CustomPanel, point:Point) none 在地图上打开信息窗口
closeInfoWindow() none 关闭在地图上打开的信息窗口。在标注上打开的信息窗口也可通过此方法进行关闭
点线面方法
方法 返回值 描述
addLayer(layer:Layer|Overlay) none 添加图层/自定义覆盖物
removeLayer(layer:Layer|Overlay) none 移除图层/自定义覆盖物
removeLayerById(id:String) none 通过ID移除图层
clearLayer() none 清空所有图层,包括自定义覆盖物
clearDistance() none
getLayerById(id:String) Layer 获取图层
pointToOverlayPixel(point:Point|KeyPoint|GbPoint) Pixel 将地理坐标转换为对应的标注容器的坐标,此方法用于自定义覆盖物
overlayPixelToPoint(pixel:Pixel) Point 根据标注容器的坐标获取对应的地理坐标,此方法用于自定义覆盖物
gotoObject(layerid:String,id:String [,left: Number,top: Number]) none 将点线面对象定位到地图视图中心点位置,并置顶。 (layerid:图层ID号,id:点线面对象ID号,lefttop为可选参数,分别代表偏移中心点位置的横向距离和纵向距离)
addHotspot(hotspot:Hotspot) none 向地图添加一个热区
removeHotspot(hotspot:Hotspot) none 移除某个地图热区
clearHotspots() none 清空地图所有热区
坐标变换方法
方法 返回值 描述
pixelToPoint(pixel: Pixel) Point 像素坐标转换为地理坐标
pointToPixel(point: Point|KeyPoint|GbPoint) Pixel 地理坐标转换为像素坐标
kcodeToPoint(kcode: String) Point K码坐标转换为地理坐标
pointToKcode(point: Point|KeyPoint|GbPoint) String 地理坐标转换为K码坐标
BAIDUtoKCode(longitude:Number, latitude:Number) String 百度地图坐标转换为K码
事件方法
方法 返回值 描述
addEventListener(key:String, fun:Function) none 添加地图事件。(key参数详见事件Key对照表;fun为回调函数)
removeEventListener(key:String) none 移除地图事件。(key参数详见事件Key对照表)
事件Key对照表
事件Key 回传值(回调函数) 描述
mapchange desc:String, code:String, regions:Array<{ name: String,code: String }> (回传参数为三个,分别代表中心点的位置描述、地理编码和行政区域详细等级列表) 地图平移、缩放或定位引起地图发生变化时触发此事件
zoomstart none 地图更改缩放级别开始时触发此事件
zoomend none 地图更改缩放级别结束时触发此事件
movestart none 地图移动开始时触发此事件
moving none 地图移动过程中触发此事件
moveend none 地图移动结束时触发此事件
dragstart none 开始拖拽地图时触发
dragging none 拖拽地图过程中触发
dragend none 停止拖拽地图时触发
click Point (事件响应的鼠标位置坐标) 左键单击地图时触发此事件。(相当于触控按下touchstart)
mousemove Point (事件响应的鼠标位置坐标) 鼠标在地图区域移动过程中触发此事件。(相当于触控移动touchmove)
mouseup Point (事件响应的鼠标位置坐标) 鼠标在地图上弹起时触发此事件。(相当于触控松开touchend)
dblclick Point (事件响应的鼠标位置坐标) 鼠标双击地图时会触发此事件。 (当双击时,产生的事件序列为: click click dblclick)
resize none 地图可视区域大小发生变化时会触发此事件
distanceend Object :{ distance:Number,points: Array} (回传值为一个对象,包括:distance此次测距总距离, points此次测距经过的点坐标集合数组) 每次完成一次测距操作时触发此事件
gesturechange none 每次完成一次多点触控移动后触发此事件