当前位置： >>
高德地图API类参考
概述命名空间：AMap 是整个高德地图 JavaScript API 的命名空间，本手册中介绍的所有 类和对象都通过 AMap.XXX 的方式调用。 如创建一个 LngLat 对象：new AMap.LngLat(116..90923)。 已过时方法声明 已过时方法： 不符合 JavaScript API 最新版本的设计规范的方法。 已过时方法的处理
原则： API 将不再更新和维护这些方法，新的应用请使用正式的方法；已使用过时方法的应 用，请尽快进行代码改造，使用正式方法，以获取最新支持。事件1.event 事件命名空间静态方法 方法 返回值 说明注册 DOM 对象事件：给 DOM 对象注册事件，并返回addDomListener( instance, eventName, handler, context) EventLis tenereventListener。运行 AMap.event.removeListener( eventListener)可以删除该事件的监听器。 参数： instance：需注册事件的 DOM 对象（必填） ， eventName： 事件名称 （必填） ， handler： 事件功能函数 （必填） ， context：事件上下文（可选，缺 省时，handler 中 this 指向参数 instance 引用的对象，否则 this 指向 context 引用的对象）注册对象事件： 给对象注册事件， 并返回 eventListener。运行 AMap.event.removeListener( eventListener)可以删除该事件 的监听器。addListener( instance, eventName, han dler, context) EventLis tener参数： instance： 需注册事件的对象 （必 填） ， eventName： 事件名称 （必填） ， handler： 事件功能函数 （必填） ， context：事件上下文（可选，缺省时，handler 中 this 指向参数 instance 引用的对象，否则 this 指向 context 引用的对象）类似于 addListener，但处理程addListenerOnce( instance, eventName, handler, context) EventLis tener序会在处理完第一个事件后将自 已移除。删除由上述 event.addDomListener 和removeListener( listener) noneevent.addListener 传回的指定 侦听器。触发非 DOM 事件： 触发非 DOM 事件 eventName，extArgs 将 扩展到事件监听函数（handler）trigger( instance, eventName, extArgs )接受到的 event 参数中。如:在noneextArgs 内写入{m:10,p:2}， eventName 监听函数 （handler） 可以接收到包含 m,p 两个 key 值的 event 对象。EventListener 对象规范（自 v1.2 新增）此对象没有构造函数，由 event 的 addDomListener()、addListener()方法返回，在 需要移除事件监听器时，作为参数传递给 removeListener() 方法。MapsEvent 对象规范（自 v1.2 新增）此对象用于表示地图、覆盖物、叠加层上的各种鼠标事件返回，包含以下字段：MapsEventOptions类型说明lnglatLngLat发生事件时光标所在处的经纬度坐标。pixelPixel发生事件时光标所在处的像素坐标。typeString事件类型。targetObject发生事件的目标对象。地图Map 类地图对象类，封装了地图显示、交互等操作的方法。构造函数说明AMap.Map(mapDiv:Node, opts:MapOptions)构造一个地图对象，参数 mapDiv 中传入地 图容器 DIV 的 ID 值，opts 地图初始化参数对象，参数详情参看 MapOptions 列表。MapOptions类型说明地图视口，用于控制影响地图静态显示的属View2Dview性，如：地图中心点“center”（自 v1.3 新增）地图图层数组， 数组可以是图层 中的一个或 多个，默认为普通二维地图。当叠加多个图 层时，普通二维地图需通过实例化一个 TileLayer 类实现layersArray（自 v1.3 新增）地图显示的缩放级别， 若 center 与 level 未 赋值，地图初始化默认显示用户所在城市范 围levelNumber（自 V1.3.0 起变更为 view 对象中的 zoom 属性）centerLngLat地图中心点坐标值（自 V1.3.0 起变更为 view 对象中的 center 属性）地图显示的缩放级别范围，在 PC 上，默认zooms Array为[3,18]，取值范围[3-18]；在移动设备上， 默认为[3-19],取值范围[3-19]地图语言类型 可选值： zh_cn： 中文简体， en： 英文， zh_en： 中英文对照 默认为: zh_cn：中文简体 注：由于图面内容限制，中文、英文 、中 英文地图 POI 可能存在不一致的情况langString（自 v1.3 新增）地图默认鼠标样式。 参数 cursor 应符合 CSScursor String的 cursor 属性规范地图显示的参考坐标系，取值： 'EPSG3857' 'EPSG3395' 'EPSG4326'crsString自 V1.3.0 移入 view 对象中地图平移过程中是否使用动画（如调用 panBy、panTo、setCenter、animateEnable BooleansetZoomAndCenter 等函数，将对地图产 生平移操作，是否使用动画平移的效果） ， 默认为 true，即使用动画是否开启地图热点，默认 false 不打开isHotspot Boolean（自 v1.3 新增）当前地图中默认显示的图层。默认图层可以 是 TileLayer.Satellite 等切片地图，也可以defaultLayer TileLayer是通过 TileLayer 自定义的切片图层（自 v1.3 废弃）地图是否可旋转，默认 falserotateEnable Boolean（自 v1.3 新增）resizeEnableBoolean是否监控地图容器尺寸变化， 默认值为 false地图是否可通过鼠标拖拽平移，默认为dragEnable Booleantrue。此属性可被 setStatus/getStatus 方 法控制地图是否可缩放，默认值为 true。此属性可zoomEnable Boolean被 setStatus/getStatus 方法控制地图是否可通过双击鼠标放大地图，默认为doubleClickZoom Booleantrue。此属性可被 setStatus/getStatus 方 法控制地图是否可通过键盘控制，方向键控制地图 平移，&+&和&-&可以控制地图的缩放，Ctrl+keyboardEnable Boolean“→” 顺时针旋转， Ctrl+ “←” 逆时针旋转， 默认为 true。此属性可被 setStatus/getStatus 方法控制地图是否使用缓动效果，默认值为 true。此jogEnable Boolean属性可被 setStatus/getStatus 方法控制scrollWheelBoolean地图是否可通过鼠标滚轮缩放浏览，默认为 true。此属性可被 setStatus/getStatus 方法控制地图在移动终端上是否可通过多点触控缩touchZoom Boolean放浏览地图，默认为 true设置地图显示样式，目前支持 normal（默mapStyle String认样式） 、dark（深色样式） 、light（浅色样 式） 、fresh(osm 清新风格样式)四种设置地图上显示的元素种类，支持 bg（地features Array图背景） 、point（兴趣点） 、road（道路） 、 building（建筑物）获取当前地图缩放级别,在 PC 上， 默认取值getZoom( ) Number范围为[3,18]；在移动设备上，默认取值范 围为[3-19]获取地图图层数组， 数组为一个或多个图层getLayers( ) Array（自 v1.3 新增）getCenter( )LngLat获取地图中心点经纬度坐标值。获取地图中心点所在区域， 回调函数返回对{province, getCity(callback:functi on(result)) city, citycode, district}象属性分别对应为{省，市，区/县}（自 v1.3 新增）getBounds( )Bounds获取当前地图视图范围getLimitBounds( )Bounds获取 Map 的限制区域获取底图语言类型getLang( ) String（自 v1.3 新增）getSize( )Size获取地图容器像素大小获取地图顺时针旋转角度getRotation( ) Number（自 v1.3 新增）获取当前地图状态信息， 包括是否可鼠标拖 拽移动地图、地图是否可缩放、 、地图是否getStatus( ) Object可旋转（rotateEnable） 、是否可双击放大 地图、是否可以通过键盘控制地图旋转 （keyboardEnable）等getDefaultCursor( )String获取地图默认鼠标指针样式获取指定位置的地图分辨率，单位：米/像getResolution(point:Lng Number Lat)素。 参数 point 有指定值时，返回指定点 地图分辨率，point 缺省时，默认返回当前 地图中心点位置的分辨率获取当前地图比例尺。 其值为当前地图中心getScale(dpi:Number) Number点处比例尺值的倒数设置地图显示的缩放级别，在 PC 上，参数setZoom(level:Number)zoom 可设范围：[3,18]；在移动端：参数 zoom 可设范围：[3,19]设置地图图层数组，数组为一个或多个图 层。当叠加多个图层时，普通二维地图需通setLayers(layers:Array)过实例化一个 TileLayer 类实现 （自 v1.3 新 增）添加地图覆盖物数组， 数组为一个或多个覆add(overlayers:Array)盖物。remove(overlayers:Array删除地图覆盖物数组， 数组为一个或多个覆)盖物。返回添加的覆盖物对象，可选类型包括 marker、 circle、 polyline、 polygon； Type 可缺省，缺省时返回所有覆盖物（marker、getAllOverlays(type) Objectcircle、polyline、polygon） 。 返回结果 不包含官方覆盖物等，比如定位 marker， 周边搜索圆等setCenter(position:LngLa设置地图显示的中心点t)setZoomAndCenter (zoomLevel:Number,cent er:LngLat)地图缩放至指定级别并以指定点为地图显 示中心点按照行政区名称设置地图显示的中心点， 行 政区名称支持中国、省、市、区/县。建议setCity(city:String， callback:Functon)不要同时使用 center/setCenter()和 setCity()，如一起使用程序将以 setCity() 作为最后结果setBounds(bound:Bounds指定当前地图显示范围， 参数 bounds 为指)定的范围设置 Map 的限制区域，设定区域限制后，setLimitBounds(bound:B传入参数为限制的 Bounds。地图仅在区域ounds)内可拖拽clearLimitBounds( )清除限制区域设置地图语言类型，设置后底图重新加载setLang(lang:String) String（自 v1.3 新增）setRotation(rotation:Nu mber)设置地图顺时针旋转角度，取值范围Number[0-360]（自 v1.3 新增）设置当前地图显示状态， 包括是否可鼠标拖 拽移动地图、地图是否可缩放、地图是否可setStatus(status:Object)旋转（rotateEnable） 、是否可双击放大地 图、是否可以通过键盘控制地图旋转 （keyboardEnable）等setDefaultCursor(cursor :String)设置鼠标指针默认样式，参数 cursor 应符 合 CSS 的 cursor 属性规范。 可为 CSS 标注中的光标样式， 如： setCursor( “pointer” ) 等； 或者自定义的光标样式， 如：setCursor (&url('/webapi/stati c/Images//0.png'), pointer&)zoomIn( )地图放大一级显示zoomOut( )地图缩小一级显示panTo(positon:LngLat)地图中心点平移至指定点位置panBy(x:Number,y:Numb er)以像素为单位， 沿 x 方向和 y 方向移动地图， x 向右为正，y 向下为正根据地图上添加的覆盖物分布情况， 缩放平setFitView(overlayList:Ar ray)移地图到合适的视野级别，参数 overlayList 默认为当前地图上添加的所有 覆盖物图层clearMap( )删除地图上所有的覆盖物destroy( )注销地图对象，并清空地图容器插件加载方法。参数 name 中指定需要加 载的插件类型，同时加载多个插件时，以字plugin(name:String/Array , callback:Function)符串数组的形式添加。在 Callback 回调函 数中进行地图插件的创建、 插件事件的绑定 等操作； 插件为地图功能的扩展， 按需加载； 插件写作方法，请参考 相关示例 。添加控件。 参数可以是插件列表中的任何插addControl(obj:Object)件对象，如：ToolBar、OverView、Scale 等removeControl(obj:Object )移除地图上的指定控件clearInfoWindow( )清除地图上的信息窗体。pixelToLngLat (pixel:Pixel,level:Number ) LngLat平面地图像素坐标转换为地图经纬度坐标lnglatToPixel (lngLat:LngLat,level:NumPixel地图经纬度坐标转换为平面地图像素坐标ber)containerToLngLat (pixel:Pixel,level:Number ) LngLat地图容器像素坐标转为地图经纬度坐标lngLatToContainer (lnglat:LngLat,level:Numb er) Pixel地图经纬度坐标转为地图容器像素坐标设置地图显示样式，目前支持 normal（默setMapStyle(style:String)认样式） 、dark（深色样式） 、light（浅色 样式） 、fresh(osm 风格清新样式)四种getMapStyle( )String获取地图显示样式设置地图上显示的元素种类，支持 bg（地setFeatures(feature:Arra图背景） 、point（兴趣点） 、road（道路） 、y)building（建筑物）getFeatures( )Array获取地图显示元素种类setDefaultLayer(layer:Til eLayer)修改底图图层（自 v1.3 废弃）事件参数说明complete地图图块加载完成后触发事件clickMapsEvent鼠标左键单击事件dblclickMapsEvent鼠标左键双击事件mapmove地图平移时触发事件鼠标点击热点时触发hotspotclick {type,lnglat,n ame,id}（自 v1.3 新增）鼠标滑过热点时触发hotspotover {type,lnglat,n ame,id}（自 v1.3 新增）鼠标移出热点时触发hotspotout {type,lnglat,n ame,id}（自 v1.3 新增）movestart地图平移开始时触发moveend地图平移结束后触发。 如地图有拖拽缓动效果，则在缓动结束后触发zoomchange地图缩放级别更改后触发zoomstart缩放开始时触发zoomend缩放停止时触发mousemoveMapsEvent鼠标在地图上移动时触发mousewheelMapsEvent鼠标滚轮开始缩放地图时触发mouseoverMapsEvent鼠标移入地图容器内时触发mouseoutMapsEvent鼠标移出地图容器时触发mouseupMapsEvent鼠标在地图上单击抬起时触发mousedownMapsEvent鼠标在地图上单击按下时触发rightclickMapsEvent鼠标右键单击事件dragstart开始拖拽地图时触发dragging拖拽地图过程中触发停止拖拽地图时触发。 如地图有拖拽缓动效dragend果，则在拽停止，缓动开始前触发resize地图容器大小改变事件touchstartMapsEvent触摸开始时触发事件，仅适用移动设备触摸移动进行中时触发事件， 仅适用移动设touchmove MapsEvent备touchendMapsEvent触摸结束时触发事件，仅适用移动设备View2D 类二维地图显示视口，用于定义二维地图静态显示属性，如地图缩放级别“zoom”、地 图中心点“center”等。构造函数说明构造一个二维地图显示视口对象， opts 二维地图视AMap.View2D(opt:View2DOptions)口对象初始化属性，详见 View2DoptionsView2DOptions类型说明centerLngLat地图中心点坐标值地图顺时针旋转角度， 取值范围 [0-360]， 默认值：rotation Number0地图显示的缩放级别。 若 center 与 zoom 未赋值，zoom Number地图初始化默认显示用户所在城市范围地图显示的参考坐标系，取值： 'EPSG3857'crs String'EPSG3395' 'EPSG4326' 默认值：'EPSG3857'基础类基础类类名 说明Pixel像素坐标，确定地图上的一个像素点。Size地物对象的像素尺寸LngLat地理坐标类Bounds地物对象的经纬度矩形范围Pixel 类像素坐标，确定地图上的一个像素点。构造函数说明AMap.Pixel(x:Number,y:Number)构造一个像素坐标对象。方法返回值说明获得 X 方向像素坐标getX( ) Number（自 v1.2 新增）获得 Y 方向像素坐标getY( ) Number（自 v1.2 新增）当前像素坐标与传入像素坐标是否相等equals(point:Pixel) Boolean（自 v1.2 新增）以字符串形式返回像素坐标对象toString( ) String（自 v1.2 新增）Size 类地物对象的像素尺寸构造函数说明构造尺寸对象。参数 width：宽度，height：AMap.Size(width:Number,height:Number)长度，单位：像素；方法返回值说明获得宽度。getWidth( ) Number（自 v1.2 新增）获得高度。getHeight( ) Number（自 v1.2 新增）以字符串形式返回尺寸大小对象toString( )（自 v1.2 新增）LngLat 类经纬度坐标，确定地图上的一个点。构造函数说明构造一个地理坐标对象，lng、lat 分别代表经度、AMap.LngLat(lng:Number,lat:Number)纬度值方法返回值说明当前经纬度坐标值经度移动 w，纬度移动 s，得 到新的坐标。 经度向右移为正值，纬度向上移offset(w:Number,s:Number) LngLat为正值，单位为米。 （自 v1.2 新增）当前经纬度和传入经纬度之间的地面距离，单distance(lnglat:LngLat) Number位为米 （自 v1.2 新增）获取经度值。getLng( ) Float（自 v1.2 新增）获取纬度值。getLat( ) Float（自 v1.2 新增）判断当前坐标对象与传入坐标对象是否相等equals(lnglat:LngLat) Boolean（自 v1.2 新增）LngLat 对象以字符串的形式返回。toString( ) String（自 v1.1 新增）Bounds 类地物对象的经纬度矩形范围。构造函数说明矩形范围构造函数，参数 southWest、northEast 分别代表地AMap.Bounds(southWest:LngLat, northEast:LngLat)物对象西南角经纬度和东北角经纬 度值。方法返回值说明指定点坐标是否在矩形范围内。contains(point：LngLat) Boolean（自 v1.2 新增）获取当前 Bounds 的中心点经纬度坐标。getCenter( ) LngLat（自 v1.2 新增）获取西南角坐标。getSouthWest( ) LngLat（自 v1.2 新增）获取东北角坐标。getNorthEast( ) LngLat（自 v1.2 新增）toString( )String以字符串形式返回地物对象的矩形范围。覆盖物覆盖物类名 说明Marker点标记Icon覆盖物&点标记&复杂点标记对象，对普通点标记 Marker 的扩展Polyline覆盖物&折线Polygon覆盖物&多边形Circle覆盖物&圆GroundImage图片覆盖物InfoWindow信息窗体ContextMenu地图右键菜单Marker 类点标记。构造函数说明构造一个点标记对象，通过 MarkerOptions 设置点标AMap.Marker(opt:MarkerOptions)记对象的属性MarkerOptions类型说明mapMap要显示该 marker 的地图对象点标记在地图上显示的位置， 默认为地图中心position LngLat点点标记显示位置偏移量，默认值为 Pixel(-10,-34)。Marker 指定 position 后， 默认以 marker 左上角位置为基准点，对准所offset Pixel给定的 position 位置，若需使 marker 指定 位置对准在 position 处，需根据 marker 的 尺寸设置一定的偏移量。 详细方法可参考开发 指南中覆盖物一节中的相关介绍需在点标记中显示的图标。 可以是一个本地图icon String/Icon标地址，或者 Icon 对象。有合法的 content 内容时，此属性无效点标记显示内容，可以是 HTML 要素字符串content String/Object或者 HTML DOM 对象。 content 有效时， icon 属性将被覆盖鼠标点击时 marker 是否置顶，默认 false ，topWhenClick Boolean不置顶 （自 v1.3 新增）鼠标移进时 marker 是否置顶，默认 false，topWhenMouseOver Boolean不置顶 （自 v1.3 新增）draggableBoolean设置点标记是否可拖拽移动，默认为 false设置拖拽点标记时是否开启点标记离开地图raiseOnDrag Boolean的效果指定鼠标悬停时的鼠标样式，自定义 cursor，cursor StringIE 仅支持 cur/ani/ico 格式， Opera 不支持自 定义 cursorvisibleBoolean点标记是否可见，默认为 true点标记的叠加顺序。 地图上存在多个点标记叠 加时， 通过该属性使级别较高的点标记在上层zIndex Number显示 默认 zIndex：100点标记的旋转角度angle Number注：angle 属性是使用 CSS3 来实现的，支持IE9 及以上版本是否自动旋转。 点标记在使用 moveAlong 动 画时，路径方向若有变化，点标记是否自动调autoRotation Boolean整角度，默认为 false IE8 以下不支持旋转， autoRotation 属性无效点标记的动画效果，默认值： “AMAP_ANIMATION_NONE” 可选值： “AMAP_ANIMATION_NONE”，无动画效animation String果 “AMAP_ANIMATION_DROP”，点标掉落 效果 “AMAP_ANIMATION_BOUNCE”，点标弹 跳效果shadowIcon点标记阴影，不设置该属性则点标记无阴影鼠标滑过点标记时的文字提示， 不设置则鼠标title String滑过点标无文字提示clickableBoolean点标记是否可点击设置 Marker 的可点击区域，在定义的区域内shape MarkerShape可触发 Marker 的鼠标点击事件用户自定义属性， 支持 JavaScript API 任意数extData Any据类型，如 Marker 的 id 等添加文本标注，content 为文本标注的内容，label {content,offset}offset 为偏移量，左上角为偏移量为（0,0）方法返回值说明 获取 Marker 偏移量getOffset( )Pixel（自 v1.3 新增） 设置 Marker 偏移量 （自 v1.3 新增） 设置点标记的动画效果，默认值： “AMAP_ANIMATION_NONE” 可选值： “AMAP_ANIMATION_NONE”，无动画效setAnimation(animate:setOffset(offset:Pixel )果String )“AMAP_ANIMATION_DROP”，点标掉落 效果 “AMAP_ANIMATION_BOUNCE”，点标弹 跳效果getAnimation( ) String获取点标记的动画效果类型setClickable(clickable:设置点标记是支持鼠标单击事件Boolean )getClickable( )Boolean获取点标记是否支持鼠标单击事件 获取点标记的位置getPosition( )LngLatsetPosition(lnglat:Lng设置点标记位置Lat) setAngle(angle:Number ) setLabel(label:Object ) getLabel() Object设置点标记的旋转角度 设置点标记文本标签内容 获取点标记文本标签内容 获取点标记的旋转角度 设置点标记的叠加顺序，默认最先添加的点标 记在最底层 设置点标记的显示图标。 参数 image 可传入 String、Icon 两种类型的getAngle()NumbersetzIndex(index:Numb er)setIcon(content:String/ Icon)值。 若为 String（图片 url），表示点标记以指定图 片形式显示；若为 Icon，表示点标记以 Icon 对象形式显示String getIcon( ) /Icon当点标记未自定义图标时，获取 Icon 内容setDraggable(draggabl设置点标记对象是否可拖拽移动e:Boolean)getDraggable( )Boolean获取点标记对象是否可拖拽移动 点标记隐藏 点标记显示 设置鼠标悬停时的光标。 参数 cur 可为 CSS 标注中的光标样式，如： setCursor(“pointer”)等；或者自定义的光 标样式，如：hide( )show( )setCursor(Cursor)StringsetCursor(&url('/i mages/0.png') ,pointer&) 注：当浏览器不支持 css2，url 值不起作用， 鼠标样式就按 pointer 来设置setContent(html:String| htmlDOM)设置点标记显示内容， 可以是 HTML 要素字符 串或者 HTML DOM 对象StringgetContent( )获取点标记内容 以指定的速度，点标记沿指定的路径移动。参 数 lnglats 为路径坐标串；speed 为指定速度，moveAlong(lnglatlist:Arr ay,speed:Number,单位：千米/小时； 回调函数 f 为变化曲线函数，缺省为f:Function,circlable:Bool ean)function(k){return k}；参数 circlable 表明是 否循环执行动画，默认为 false 以给定速度移动点标记到指定位置。参数moveTo(lnglat:LngLat,splnglat 为指定位置， 必设； speed 为指定速度，eed:Number,单位： 千米/小时； 回调函数 f 为变化曲线函数，f:Function)缺省为 function(k){return k}。stopMove( )点标记停止动画 为 Marker 指定目标显示地图。 当参数值取 nullsetMap(map:Map)时，地图上移除当前 Marker：setMap(null)getMap() Map获取 Marker 所在地图对象 鼠标滑过点标时的文字提示setTitle(title:String)getTitle( )String获取点标记的文字提示 地图上有多个 marker 时， 当 isTop 为 true 时，setTop(isTop:Boolean)marker 将显示在最前面；当为 false 时， marker 取消置顶getTop( ) setShadow(icon:Icon)Boolean为 marker 设置阴影效果getShadow( )Icon获取 marker 的阴影图标setShape(shape:Marker设置 marker 的可点击区域Shape)MarkerS getShape( ) hape获取 marker 的可点击区域设置用户自定义属性，支持 JavaScript API 任setExtData(ext:Any)意数据类型，如 Marker 的 id 等getExtData( ) Any获取用户自定义属性 说明事件参数MapsEvclick ent鼠标左键单击事件MapsEv dblclick ent鼠标左键双击事件MapsEv rightclick ent鼠标右键单击事件MapsEv mousemove ent鼠标移动mouseoverMapsEv鼠标移近点标记时触发事件entMapsEv mouseout ent鼠标移出点标记时触发事件MapsEv mousedown ent鼠标在点标记上按下时触发事件MapsEv mouseup ent鼠标在点标记上按下后抬起时触发事件MapsEv dragstart ent开始拖拽点标记时触发事件MapsEv dragging ent鼠标拖拽移动点标记时触发事件MapsEv dragend ent点标记拖拽移动结束触发事件点标记在执行 moveTo，moveAlong 动画时moving触发事件 点标记执行 moveTo 动画结束时触发事件， 也moveend可以由 moveAlong 方法触发movealong点标记执行 moveAlong 动画一次后触发事件MapsEv touchstart ent触摸开始时触发事件，仅适用移动设备MapsEv touchmove ent触摸移动进行中时触发事件，仅适用移动设备MapsEv touchend ent触摸结束时触发事件，仅适用移动设备MarkerShape 类MarkerShape 用于划定 Marker 的可点击区域范围。需要注意的是，在 IE 浏览器中图标透 明区域默认为不触发事件，因此 MarkerShape 在 IE 中不起作用。构造函数说明构造一个 Marker 可点击区域对象，通过AMap.MarkerShape(opt:MarkerShapeOptions)MarkerShapeOptions 设置可点击区域属 性MarkerShapeOptions类型说明可点击区域组成元素数组，存放图形的像 素坐标等信息， 该数组元素由 type 决定：coordsArray.&Number&- circle:coords 格式为 [x1, y1, r]，x1， y1 为圆心像素坐标，r 为圆半径 - poly: coords 格式为 [x1, y1, x2, y2 …xn, yn]，各 x，y 表示多边形边界像素坐 标 - rect: coords 格式为 [x1, y1, x2, y2]， x1，y1 为矩形左上角像素坐标，x2，y2 为矩形右下角像素坐标 Markshape 的像素坐标是指相对于 marker 的左上角的像素坐标偏移量可点击区域类型，可选值： - circle:圆形type String- poly:多边形 - rect:矩形Icon 类表示点标记的图标用于添加复杂点标记，即在普通点标记的基础上，添加 Icon 类，通过在 Icon 表示的大图上截取其中一部分作为标注的图标构造函数AMap.Icon(opt:IconOptions)说明构造点覆盖物图标，通过 IconOptions 设置图标属性IconOptions 类型size Size说明图标尺寸，默认值(36,36)imageOffsetPixel图标取图偏移量。 当 image 中指定了一个大图时， 可通过 size和 imageOffset 配合，显示图标的指定范围imageString图标的取图地址。默认为蓝色图钉图片图标所用图片大小，根据所设置的大小拉伸或压缩图片，等同imageSize Size于 CSS 中的 background-size 属性。可用于实现高清屏的高 清效果方法getImageSize( )返回值说明Size获取图标图片大小setImageSize(size:Size)设置图标图片大小Polyline 类覆盖物&折线构造函数说明构造折线对象，通过 PolylineOptions 指定折线样AMap.Polyline(opt:PolylineOptions)式PolylineOptionsmap类型Map说明要显示该 polyline 的地图对象折线覆盖物的叠加顺序。默认叠加顺序，先添加的线在zIndex Number底层， 后添加的线在上层。 通过该属性可调整叠加顺序，使级别较高的折线覆盖物在上层显示 默认 zIndex：50是否绘制大地线，默认 false，不支持geodesic Boolean（自 v1.3 新增）isOutlineBoolean线条是否带描边，默认 false线条描边颜色， 此项仅在 isOutline 为 true 时有效， 默outlineColor String认：#000000pathArray折线的节点坐标数组线条颜色，使用 16 进制颜色代码赋值。默认值为strokeColor String#006600线条透明度，取值范围[0,1]，0 表示完全透明，1 表示strokeOpacity Number不透明。默认为 0.9strokeWeightNumber线条宽度，单位：像素strokeStyleString线样式，实线:solid，虚线:dashed勾勒形状轮廓的虚线和间隙的样式，此属性在 strokeStyle 为 dashed 时有效， 此属性在 ie9+浏览strokeDasharray Array器有效 取值： 实线：[0,0,0] 虚线：[10,10] ，[10,10] 表示 10 个像素的实线和 10个像素的空白（如此反复）组成的虚线 点画线：[10,2,10]， [10,2,10] 表示 10 个像素的实线 和 2 个像素的空白 + 10 个像素的实线和 10 个像素的 空白 （如此反复）组成的虚线用户自定义属性，支持 JavaScript API 任意数据类型，extData Any如 Polyline 的 id 等方法setPath(path:Array)返回值说明设置组成该折线的节点数组getPath( )Array获取折线路径的节点数组修改折线属性（包括路径的节点、线样式、setOptions(opt:PolylineOptions)是否绘制大地线等。属性详情参看 PolylineOptions 列表）getOptions( )Object获取线的属性getLength( )Number获取折线的总长度（单位：米）getBounds( )Bounds获取当前折线的矩形范围对象hide( )地图上隐藏指定折线show( )地图上显示指定折线setMap(map:Map)设置折线所在的地图。参数 map 即为目标地图，参数为 null 时，在地图上移除当前 折线设置用户自定义属性， 支持 JavaScript APIsetExtData(ext:Any)任意数据类型，如 Polyline 的 id 等getExtData( )Any获取用户自定义属性事件click参数MapsEvent说明鼠标左键单击事件dblclickMapsEvent鼠标左键双击事件rightclickMapsEvent鼠标右键单击事件hide{type, target}隐藏show{type, target}显示mousedownMapsEvent鼠标按下mouseupMapsEvent鼠标抬起mouseoverMapsEvent鼠标经过mouseoutMapsEvent鼠标移出change属性发生变化时touchstartMapsEvent触摸开始时触发事件，仅适用移动设备touchmoveMapsEvent触摸移动进行中时触发事件，仅适用移动设备touchendMapsEvent触摸结束时触发事件，仅适用移动设备Polygon 类覆盖物&多边形构造函数说明构造多边形对象，通过 PolygonOptions 指定多边AMap.Polygon(opt:PolygonOptions)形样式PolygonOptionsmap类型Map说明要显示该 polygon 的地图对象多边形覆盖物的叠加顺序。 地图上存在多个多边形覆 盖物叠加时， 通过该属性使级别较高的多边形覆盖物zIndex Number在上层显示 默认 zIndex：10多边形轮廓线的节点坐标数组，当为“环”多边形时Array.&Ln gLat&|Arra y.&Array. &LngLat&&（多边形区域在多边形内显示为“岛”），path 为 二维数组， 数组元素为多边形轮廓线的节点坐标数组 “环”多边形时，要求数组第一个元素为外多边形， 其余为“岛”多边形，外多边形需包含“岛”多边形，path否则程序不作处理线条颜色，使用 16 进制颜色代码赋值。默认值为strokeColor String#006600轮廓线透明度，取值范围[0,1]，0 表示完全透明，1strokeOpacity float表示不透明。默认为 0.9strokeWeightNumber轮廓线宽度多边形填充颜色，使用 16 进制颜色代码赋值，如：fillColor String#FFAA00多边形填充透明度， 取值范围[0,1]， 0 表示完全透明，fillOpacity Float1 表示不透明。默认为 0.9用户自定义属性，支持 JavaScript API 任意数据类extData Any型，如 Polygon 的 id 等strokeStyleString轮廓线样式，实线:solid，虚线:dashed勾勒形状轮廓的虚线和间隙的样式，此属性在 strokeStyle 为 dashed 时有效， 此属性在 ie9+浏 览器有效 取值：strokeDasharray Array实线：[0,0,0] 虚线：[10,10] ，[10,10] 表示 10 个像素的实线和 10 个像素的空白（如此反复）组成的虚线点画线：[10,2,10]， [10,2,10] 表示 10 个像素的实 线和 2 个像素的空白 + 10 个像素的实线和 10 个像 素的空白 （如此反复）组成的虚线方法setPath(path:Array.& LngLat&|Array.&Array. &LngLat&&)返回值说明设置多边形轮廓线节点数组，当为“环”多边形时， path 为二维数组，数组元素为多边形轮廓线的节点 坐标数组getPath( )array获取多边形轮廓线节点数组修改多边形属性（样式风格，包括组成多边形轮廓线setOptions(opt:Poly的节点、轮廓线样式等。属性详情参看gonOptions)PolygonOptions 列表）getOptions( )object获取多边形的属性获取当前多边形的矩形范围对象。getBounds( )Bounds （自 v1.2 新增）获取多边形的面积（单位：平方米）getArea( )Number （自 v1.1 新增）hide( )隐藏多边形show( )显示多边形在指定地图上显示当前的多边形。参数取值为 nullsetMap(map:Map)时，在地图上移除当前多边形 （自 v1.2 新增）设置用户自定义属性， 支持 JavaScript API 任意数据setExtData(ext:Any)类型，如 Polygon 的 id 等getExtData( ) contains(point:LngL at)Any获取用户自定义属性Boolean判断指定点坐标是否在多边形范围内事件click参数MapsEvent说明鼠标左键单击事件dblclickMapsEvent鼠标左键双击事件rightclickMapsEvent {type, target} {type, target} MapsEvent右键单击hide隐藏show显示mousedown鼠标按下mouseupMapsEvent鼠标抬起mouseoverMapsEvent鼠标经过mouseoutMapsEvent鼠标移出change属性发生变化时touchstartMapsEvent触摸开始时触发事件，仅适用移动设备touchmoveMapsEvent触摸移动进行中时触发事件，仅适用移动设备touchendMapsEvent触摸结束时触发事件，仅适用移动设备Circle 类覆盖物&圆构造函数AMap.Circle(opt:CircleOptions)说明构造圆形覆盖物，通过 CircleOptions 设置圆形CircleOptions类型说明要显示该 circle 的地图对象mapMap（自 v1.2 新增）层叠顺序zIndex Number默认 zIndex:10centerLngLat圆心位置radiusNumber圆半径，单位:米线条颜色，使用 16 进制颜色代码赋值。默认值为strokeColor String#006600轮廓线透明度，取值范围[0,1]，0 表示完全透明，1strokeOpacity Float表示不透明。默认为 0.9strokeWeightNumber轮廓线宽度圆形填充颜色,使用 16 进制颜色代码赋值。 默认值为fillColor String#006600圆形填充透明度，取值范围[0,1]，0 表示完全透明，fillOpacity Float1 表示不透明。默认为 0.9strokeStyleString轮廓线样式，实线:solid，虚线:dashed用户自定义属性，支持 JavaScript API 任意数据类extData Any型，如 Circle 的 id 等勾勒形状轮廓的虚线和间隙的样式，此属性在 strokeStyle 为 dashed 时有效， 此属性在 ie9+ 浏览器有效 取值： 实线：[0,0,0]strokeDasharray Array虚线：[10,10] ，[10,10] 表示 10 个像素的实线和 10 个像素的空白（如此反复）组成的虚线 点画线：[10,2,10]， [10,2,10] 表示 10 个像素的 实线和 2 个像素的空白 + 10 个像素的实线和 10 个像素的空白 （如此反复）组成的虚线方法setCenter(lnglat:LngLat)返回值说明设置圆中心点getCenter( )LngLat获取圆中心点getBounds( )Bounds获取圆外切矩形范围setRadius(radius:Number)设置圆形的半径getRadius( )Number获取圆形的半径修改圆属性（样式风格，包括组成圆形setOptions(circleopt:CircleOptions)轮廓线的节点、轮廓线样式等。属性详 情参看 CircleOptions 列表）getOptions( )Object获取圆形的属性hide( )地图上隐藏圆形show( )地图上显示圆形在指定地图上添加该圆形覆盖物。参数setMap(map:Map)取值为 null 时，在地图上移除当前圆形 （自 v1.2 新增）设置用户自定义属性，支持 JavaScriptsetExtData(ext:Any)API 任意数据类型，如 Circle 的 id 等getExtData( )Any获取用户自定义属性contains(point:LngLat)Boolean判断指定点坐标是否在圆内事件click参数MapsEvent说明鼠标左键单击事件dblclickMapsEvent鼠标左键双击事件rightclickMapsEvent {type, target} {type, target} MapsEvent右键单击hide隐藏show显示mousedown鼠标按下mouseupMapsEvent鼠标抬起mouseoverMapsEvent鼠标经过mouseoutMapsEvent {type, target} MapsEvent鼠标移出change属性发生变化时touchstart触摸开始时触发事件，仅适用移动设备touchmoveMapsEvent触摸移动进行中时触发事件，仅适用移动设备touchendMapsEvent触摸结束时触发事件，仅适用移动设备GroundImage 类图片覆盖物类，用于添加一个只有一张图片的图层，图片会随缩放级别而自适应缩放。构造函数AMap.GroundImage(Url:String说明构造 GroundImage 对象，需要提供一个图片 url，以及它,bounds:Bounds,opt:Ground覆盖的 Bounds。图片会根据 Bounds 大小显示ImageOptions)GroundImageOptionsmap类型Map说明要显示该 groundimage 的地图对象图层是否可点击，若为可点击则 GroundImageclickable Boolean支持鼠标点击事件 默认值：false图片透明度，取值范围[0,1]，0 表示完全透明，1opacity Number表示不透明 默认值：1方法getMap( )返回值说明Map获取 GroundImage 的 Map 对象设置显示 GroundImage 的 Map 对setMap(map:Map)象getOpacity( )Number获取图片透明度值setOpacity(opacity:Number)设置图片透明度获取 GroundImage 的覆盖地理范getBounds( )Bounds 围getImageUrl( )String获取图片 url事件click参数值MapsEvent说明鼠标左键单击事件dblclickMapsEvent鼠标左键双击事件InfoWindow 类用于在地图上弹出一个详细信息展示窗体构造函数Window(opt:InforWindowOptions)说明构造详细信息展示窗体。InfoWindowOptions 类型说明是否自定义窗体。设为 true 时，信息窗体 外框及内容完全按照 content 所设的值添isCustomBoolean加（默认为 false，即在系统默认的信息窗 体外框中显示 content 内容）是否自动调整窗体到视野内（当信息窗体autoMove Boolean超出视野范围时，通过该属性设置是否自 动平移地图，使信息窗体完全显示）控制是否在鼠标点击地图后关闭信息窗closeWhenClickMap Boolean体，默认 false，鼠标点击地图后不关闭信 息窗体显示内容，可以是 HTML 要素字符串或者content Html/DomObjectHTML DOM 对象信息窗体尺寸（isCustom 为 true 时，该size Size属性无效）相对于基点的偏移量。默认情况是信息窗offset Pixel体的底部中心点(BOTTOM_CENTER) 和 基点之间的偏移量信息窗体显示基点位置position LngLat（自 v1.2 新增）Boolean 控制是否显示信息窗体阴影，取 值 false 时不显示窗体阴影，取值 true 时showShadow Boolean显示窗体阴影 默认值：false方法返回值说明在地图的指定位置打开信息open(map:Map,pos:AMap.LngLat)窗体close( )关闭信息窗体getIsOpen( )Boolean获取信息窗体是否打开设置信息窗体内容， 可通过该setContent(content:String|htmlDOM)函数动态更新信息窗体中的 信息获取信息窗体内容 ，结果以getContent( )String 字符串方式返回setPosition(lnglat:LngLat)设置信息窗体显示基点位置getPosition( )LngLat获取信息窗体显示基点位置设置信息窗体大小setSize(size:Size)（isCustom 为 false 时有效）getSize( )Size获取信息窗体大小事件change参数说明属性发生变化时open信息窗体打开之后触发事件close信息窗体关闭之后触发事件ContextMenu 类地图右键菜单构造函数AMap.ContextMenu(opt:ContextMenuOptions)说明构造一个右键菜单对象ContextMenuOptions类型说明右键菜单显示的位置positionLngLat（自 v1.2 废弃）右键菜单内容（针对自定义菜单 时，添加菜单内容及功能。可以content Html/DomObject是 HTML 要素字符串或者 HTML DOM 对象。）右键菜单宽度width Number（自 v1.2 废弃）方法返回值说明右键菜单中添加菜单项。参数 text:菜单显示内容；fn：该菜单addItem(text:String,fn:Function,n下需进行的操作；num：当前菜um:Number)单项在右键菜单中的排序位置， 以 0 开始removeItem(text:String,fn:Functio删除一个菜单项n)在地图的指定位置打开右键菜open(map:Map,position:LngLat)单。close( )关闭右键菜单事件open参数{type, target}说明右键菜单打开事件close{type, target}右键菜单关闭事件图层图层类名 说明TileLayer切片图层类TileLayer.Satellite卫星图层类，继承自 TileLayerTileLayer.RoadNet路网图层类，继承自 TileLayerTileLayer.Traffic实时交通图层类，继承自 TileLayer类名说明Buildings3D 楼块图层类IndoorMap室内地图图层类ImageLayer图片图层类MassMarks海量麻点图层类TileLayer 类切片图层类，该类为基础类。构造函数说明构造一个切片图层对象，通过AMap.TileLayer(tileOpt:TileLayerOptions)TileLayerOptions 设置图层属性。TileLayerOptionsmap类型Map说明要显示该图层的地图对象切片大小，取值：tileSize Number256，表示切片大小为 256*256， 128，表示切片大小为 128*128，64，表示切片大小为 64*64。默认值为 256tileUrlString切片取图地址errorUrlString取图错误时的代替地址获取图块取图地址。该属性值为一个函 数，函数参数 z 为地图缩放级别，x,y 分getTileUrl Function(x,y,z)别为相应缩放级别下图块横向、纵向索引 号。若 tileUrl 属性值有效，则可不实现此 接口。图层叠加的顺序值，0 表示最底层。默认zIndex NumberzIndex：1图层的透明度，取值范围[0,1]，1 代表完opacity Float全不透明，0 代表完全透明支持的缩放级别范围，默认范围[3-18]，zooms Array在 PC 上，取值范围为[3-18]；在移动设 备上，取值范围为[3-19]是否区分高清屏，在移动设备上（手机、detectRetina Boolean平板电脑），如果该值设置为 true，则会 根据移动设备屏幕分辨率，调用不同的地图图片，以适配不同屏幕分辨率。默认值 是 true方法setOpacity(alpha:Float)返回值说明设置图层透明度show( )在地图上显示该图层hide( )隐藏图层获取当前图层所有切片号。getTiles( ) Array（自 v1.1 新增）reload( )重新加载此图层setTileUrl( )设置图层的取图地址获取该图层可显示的级别范围； 在 PC 上，getZooms( ) Array取值范围为[3-18]；在移动设备上，取值 范围为[3-19]setzIndex(index:Number)设置图层叠加的顺序值，默认 zIndex：1setMap(map:Map)设置要显示图层的地图对象事件complete参数说明 图块切片加载完成事件TileLayer.Satellite 类（自 v1.1 新增）卫星图层类，继承自 TileLayer。构造函数说明构造一个卫星切片图层对象，通过AMap.TileLayer.Satellite(sateOpt:SatelliteOptions)SatelliteOptions 设置图层属性。SatelliteOptions 类型map Map说明要显示该图层的地图对象zIndexNumber图层叠加的顺序值，0 表示最底层，默认 zIndex：2图层的透明度，取值范围[0,1]，1 代表完全不透明，0 代opacity Float表完全透明zoomsArray支持的缩放级别范围， 默认范围为[3,18],取值范围[3-18]是否区分高清屏，在移动设备上（手机、平板电脑）， 如果该值设置为 true，则会根据移动设备屏幕分辨率，detectRetina Boolean调用不同的地图图片，以适配不同屏幕分辨率。默认值 是 true方法setOpacity(alpha:Float)返回值说明设置图层透明度show( )在地图上显示该图层hide( )隐藏图层getTiles( )Array获取当前图层所有切片号reload( )重新加载此图层setTileUrl( )设置图层的取图地址获取该图层可显示的级别范围， 默认取值范getZooms( )Array 围为[3-18]setzIndex(index:Number)设置图层叠加的顺序值，默认 zIndex：2setMap(map:Map)设置要显示图层的地图对象事件参数说明complete图块切片加载完成事件TileLayer.RoadNet 类路网图层类，继承自 TileLayer。构造函数说明构造路网图层对象，通过AMap.TileLayer.RoadNet(roadnetOpt:RoadNetOptions)RoadNetOptions 设置图层属 性。RoadNetOptions类型说明mapMap要显示该图层的地图对象zIndexNumber图层叠加的顺序值，0 表示最底层，默认 zIndex：3图层的透明度，取值范围[0,1]，1 代表完全不透明，0opacity Float代表完全透明支持的缩放级别范围，默认范围为[3-18]，取值范围zooms Array[3-18]； 在手机、 平板等高清设备上， 取值范围为[3-17]是否区分高清屏，在移动设备上（手机、平板电脑）， 如果该值设置为 true，则会根据移动设备屏幕分辨率，detectRetina Boolean调用不同的地图图片，以适配不同屏幕分辨率。默认值 是 true方法setOpacity(alpha:Float)返回值说明设置图层透明度show( )在地图上显示该图层hide( )隐藏图层getTiles( )Array获取当前图层所有切片号reload( )重新加载此图层setTileUrl( )设置图层的取图地址getZooms( )Array获取该图层可显示的级别范围， 默认取值范围为[3-18]；在平板、手机等高清设备上，取值 范围为[3-17]setzIndex(index:Number)设置图层叠加的顺序值，默认 zIndex：3setMap(map:Map)设置要显示图层的地图对象事件complete参数说明图块切片加载完成事件TileLayer.Traffic 类实时交通图层类，继承自 TileLayer。请点击[覆盖城市]来查看已覆盖了实时交通图层的城 市名单。构造函数AMap.TileLayer.Traffic(trafficOpt:TrafficOptions)说明构造一个实时交通图层对象。TrafficOptionsmap类型Map说明要显示该图层的地图对象 图层叠加的顺序值，0 表示最底层，默认 zIndex：4 图层的透明度，取值范围[0,1]，1 代表完全不透明，0zIndexNumberopacityFloat代表完全透明 支持的缩放级别范围，矢量图：默认取值范围[6-20]；zoomsArray栅格图：默认取值范围[6-17] 是否区分高清屏，在移动设备上（手机、平板电脑）， 如果该值设置为 true，则会根据移动设备屏幕分辨率，detectRetina Boolean调用不同的地图图片，以适配不同屏幕分辨率。默认值 是 true 是否设置可以自动刷新实时路况信息，默认为 false，每autoRefresh Boolean3 分钟刷新一次 设置刷新间隔时长，单位：秒interval Number默认值：180s方法setOpacity(alpha:Float)返回值说明 设置图层透明度 在地图上显示该图层 隐藏图层 获取当前图层所有切片号 重新加载此图层 设置图层的取图地址 获取该图层可显示的级别范围， 默认取值范围show( )hide( )getTiles( )Arrayreload( )setTileUrl( )getZooms( )Array 为[3-17]；在平板、手机登高清设备上，取值范围为[3-16]setzIndex(index:Number)设置图层叠加的顺序值，默认 zIndex：4 设置要显示图层的地图对象setMap(map:Map)事件complete参数说明图块切片加载完成事件Buildings 类用于在地图上显示 3D 楼块层,当地图缩放级别达到 17、18 级时可以显示。构造函数Buildings( )说明构造一个 3D 楼块图层对象方法setMap(map:Map)返回值说明设置要显示图层的地图对象事件complete参数说明图层加载完成事件IndoorMap 类室内图层类，用户在将地图缩放到一定缩放级别后，可以显示某些建筑物内的地图信息。构造函数说明AMap.IndoorMap(opts:IndoorMapOptions)构造函数，实例化一个室内地图类 说明是否隐藏楼层切换控件，默认值：falseIndoorMapOptionshideFloorBar类型Boolean图层透明度，取值范围[0,1]，0 表示完opacity Number全透明，1 表示不透明zIndexNumber图层叠加的顺序值，0 表示最底层指定鼠标悬停到店铺面时的鼠标样式，cursor String自定义 cursor，IE 仅支持 cur/ani/ico 格式，Opera 不支持自定义 cursor方法setMap(map:Map)返回值说明设置显示 IndoorMap 的 Map 对象showIndoorMap(indoorid:Strin g,floor:number,shopid:String )显示指定室内地图信息；Indoorid 为必 填参数，shopid 为可选参数showFloor(Integer)显示楼层showLabels()显示室内地图标注hideLabels()隐藏室内地图标注show()显示室内地图hide()隐藏室内地图setzIndex(index:Number)设置图层叠加的顺序值showFloorBar()显示楼层控件hideFloorBar()隐藏楼层控件show( )显示图层hide( )隐藏图层setOpacity(alpha:Float)设置图层透明度getOpacity()Float获取图层透明度getSelectedBuilding()Building获取设定的楼宇信息事件complete参数说明室内图层加载完成事件楼层加载完成事件，当 status 为 0,时， 返回的 Object 对象包含floor_complete {status,Obj ect}(id,Building,Shop)，其中 id 为楼层的 id 当 status 为 1 时，返回的信息为楼 宇 idclick{lnglat,bui lding_id,fl点击事件oor,Shop}Building 对象属性floor类型String说明所属楼层nameString建筑物名称lnglatLngLat建筑物的经纬度idString所属楼宇信息Shop 对象属性id类型String说明店铺的 idnameString商铺的名称lnglatLngLat店铺的经纬度building_idString所属建筑物 idImageLayer 类图片图层类， 用户可以将一张静态图片作为图层添加在地图上， 图片图层会随缩放级别而自 适应缩放。构造函数说明构造一个图片图层 ImageLayer 对象，需要提供AMap.ImageLayer(opts:ImageLayerO一个图片 url，以及它覆盖的 Bounds。图片会根ptions)据 Bounds 大小显示ImageLayerOptionsbounds类型Bounds说明ImageLayer 显示的范围,必填参数urlStringImageLayer 图片 url，必填参数要叠加该 ImageLayer 的地图对象，也可以在map MapMap 中的 layers 设置为默认显示的图层图片透明度，取值范围[0,1]，0 表示完全透明，1opacity Number表示不透明visibleBoolean图层是否可视，默认：true图层叠加的顺序值，0 表示最底层;默认 zIndex：zIndex Number6支持的缩放级别范围，默认范围[3-18],在 PC 上，zooms Array取值范围为[3-18]；在移动设备上，默认取值范 围为[3-19]方法返回值说明setMap(map:Map)设置显示 ImageLayer 的 Map 对象getBounds( )Bounds获取图层边界大小getImageUrl( )String获取图层图片 urlsetImageUrl(url:String)设置图层图片 url设置图层边界大小，可以大于图片本setBounds(bounds:Bounds)身，或者小于图片本身设置图片图层的属性，可用于更新图setOptions(opt:ImageLayerOptions)片图层(缩放级别范围、叠加顺序等)getOptions( )Object获取图层的属性信息hide( )隐藏图层show( )显示图层getMap( )Map显示图片图层的地图对象事件complete参数说明图片图层加载完成事件MassMarks 类此类表示海量点类，利用该类可同时在地图上展示万级别的点，目前仅适用于 html5 浏览 器。构造函数说明创建海量点类。datas 为点对象的数组，点对象为包含经纬AMap.MassMarks(data:Arra y.&Object&,opts:MassMar ksOptions)度 lnglat 属性的 Object，opts 为点与点集合的绘制样式。 例 data: [{lnglat: [116..904989], name: i,id:1},{}, …]或 url 串，支持从服务器直接取数据MassMarksOptionszIndex类型Number说明图层叠加的顺序值，0 表示最底层。默认 zIndex：5图层的透明度，取值范围[0,1]，1 代表完全不透明，opacity Float0 代表完全透明支持的缩放级别范围，默认范围[3-18]，在 PC 上，zooms Array取值范围为[3-18]；在移动设备上，取值范围为 [3-19]必填参数，图标显示位置偏移量，以图标的左上角anchor Pixel为基准点（0,0）点，例如：anchor:new AMap.Pixel(5,5)urlString必填参数,图标的地址必填参数，图标的尺寸；例如：size:newsize SizeAMap.Size(11,11)指定鼠标悬停时的鼠标样式，自定义 cursor，IE 仅cursor String支持 cur/ani/ico 格式， Opera 不支持自定义 cursor表示是否在拖拽缩放过程中实时重绘，默认 true，alwaysRender Boolean建议超过 10000 的时候设置 false方法setMap(map:Map)返回值说明设置显示 MassMark 的地图对象getMap()Map获取 Marker 所在地图对象设置 MassMark 的显示样式， style 里面包含图标的setStyle(style:Object)anchor、url 和 size获取 MassMark 的显示样式，数据结构同 setStylegetStyle() Object中的属性一致设置 MassMark 展现的数据集，数据集格式为：, data: Array 坐标数据集. 例：data: [{lnglat:setData(data:Object)[116..904989], name: i,id:1},{}, …],{}, …]}输出 MassMark 的数据集，数据结构同 setDatasgetData() Object中的数据集show( )显示海量点图层hide( )隐藏海量点图层事件complete参数说明海量点加载完成事件clickObject鼠标左键单击事件dblclickObject鼠标左键双击事件mouseoutObject鼠标移出海量点图标时触发事件mouseupObject鼠标在海量点图标上按下后抬起时触发事件mousedownObject鼠标在海量点图标按下时触发事件触摸开始时触发事件， 仅适用移动设备, 数据结构同 setDatas 中的touchstart Object数据集触摸移动进行中时触发事件，仅适用移动设备, 数据结构同touchmove ObjectsetDatas 中的数据集触摸结束时触发事件， 仅适用移动设备, 数据结构同 setDatas 中的touchend Object数据集插件在线插件在线插件是在基础地图服务上增加的额外功能， 您可以根据自己的需要选择添加。 插件分为 两类：一类是地图控件，它们是用户与地图交互的 UI 元素，例如缩放控制条（ToolBar） 等； 一类是功能型插件， 它不依赖于 UI 元素， 完成某些地图功能， 比如鼠标工具 （MouseTool） 等。插件名称说明AMap.MapType地图类型切换插件AMap.OverView地图鹰眼插件AMap.Scale地图比例尺插件AMap.ToolBar地图工具条插件AMap.Geolocation浏览器定位插件，利用浏览器的定位接口获取位置信息AMap.MouseTool鼠标工具插件AMap.CircleEditor圆编辑插件，用于编辑 AMap.Circle 对象插件名称说明AMap.PolyEditor折线、多边形编辑插件AMap.Hotspot底图热点AMap.MarkerClusterer点聚合插件AMap.Heatmap热力图插件AMap.RangingTool距离量测插件AMap.DragRoute拖拽导航插件AMap.PlaceSearchLayer麻点图插件，提供海量搜索结果的辅助显示功能AMap.CustomLayer自定义图层，是一种由开发者实现绘制，由 API 帮助实 现与地图同步的图层类AMap.AdvancedInfoWindow高级信息窗体，在普通信息窗体的基础上，整合了 POI 搜索和多种路径规划的功能AMap.MapType 插件地图类型切换插件。用户通过该插件进行地图切换。代码示例 1 2 3 4 5 6 7 8 9 10 11mapObj = newAMap.Map(&imap&,{ center:newAMap.LngLat(116..913423), level:16 }); mapObj.plugin([&AMap.MapType&],function(){ //地图类型切换 vartype= newAMap.MapType({ defaultType:0 //使用 2D 地图 }); mapObj.addControl(type); });相关示例构造函数说明AMap.MapType(MaptypeOptions)地图类型切换插件，用于切换地图。MaptypeOptions类型说明初始化默认图层类型。 取值为 0：2D 地图 取值为 1：defaultType Number卫星图 默认值：0showTrafficBoolean叠加实时交通图层 默认值：falseshowRoadBoolean叠加路网图层 默认值：false方法返回值说明show( )显示地图类型切换控件hide( )隐藏地图类型切换控件AMap.OverView 插件地图鹰眼插件。代码示例 1 2 3 4 5//加载鹰眼 mapObj.plugin([&AMap.OverView&],function(){ view = newAMap.OverView(); mapObj.addControl(view); });相关示例构造函数说明AMap.OverView( OverViewOptions )OverViewOptions类型说明tileLayerTileLayer鹰眼窗体中需显示的切片图层isOpenBoolean鹰眼是否展开，默认为 falsevisibleBoolean鹰眼是否显示，默认为 true方法返回值说明show( )显示鹰眼窗体hide( )隐藏鹰眼窗体open( )展开鹰眼窗口close( )折叠鹰眼窗口setTileLayer( TileLayer )设置鹰眼中需显示的切片图层getTileLayer( )TileLayer获取窗体中显示的切片图层事件参数说明show执行显示鹰眼窗体时触发的事件hide执行隐藏鹰眼窗体时触发的事件open执行展开鹰眼窗体时触发的事件close执行折叠鹰眼窗体时触发的事件AMap.Scale 插件比例尺插件。位于地图右下角，用户可控制其显示与隐藏。代码示例 1 2 3 4mapObj.plugin([&AMap.Scale&],function(){ varscale = newAMap.Scale(); mapObj.addControl(scale); });相关示例构造函数说明AMap.Scale( )方法返回值说明show( )显示比例尺hide( )隐藏比例尺事件参数说明show显示比例尺插件时触发的事件hide隐藏比例尺插件时触发的事件AMap.ToolBar 插件地图操作工具条插件。可支持方向导航、位置定位、视野级别缩放、视野级别选择等操作。代码示例1 2 3 4 5mapObj.plugin([&AMap.ToolBar&],function(){ //加载工具条 vartool = newAMap.ToolBar(); mapObj.addControl(tool); });相关示例构造函数说明AMap.ToolBar( ToolbarOptions )ToolbarOptions类型说明相对于地图容器左上角的偏移量，正数代表向右下偏offset Pixel移。默认为 AMap.Pixel(10,10)rulerBoolean标尺键盘是否可见，默认为 truedirectionBoolean方向键盘是否可见，默认为 true是否自动定位，即地图初始化加载完成后，是否自动定autoPosition Boolean位的用户所在地，该功能仅在支持 HTML5 的浏览器中 有效，默认为 falselocationMarkerMarker自定义定位图标，值为 Marker 对象是否使用高德定位 sdk 用来辅助优化定位效果，默认： false 仅供在使用了高德定位 sdk 的 APP 中，嵌入 webview 页面时使用 注：如果要使用辅助定位的功能，除了需要将useNative BooleanuseNative 属性设置为 true 以外，还需要调用高德定 位 sdk 中， LocationManagerProxy 类的 startSocket() 方法，开启辅助 H5 定位功能；如果不用，就调用 stopSocket()方法停止辅助 H5 定位功能。具体用法可 参考定位 SDK 的参考手册方法返回值说明getOffset( )Pixel获取工具条相对于地图容器左上角的偏移量setOffset( Pixel )设置工具条相对于地图容器左上角的偏移量hideRuler( )隐藏缩放级别等级条showRuler( )显示缩放级别等级条hideDirection( )隐藏方向键盘showDirection( )显示方向键盘hideLocation( )隐藏定位小部件showLocation( )显示定位小部件进行位置定位，浏览器须支持 html5，且用户须同doLocation( )意共享位置信息。结果位置信息通过 location 事件 函数获取获取定位结果信息(lng、lat)。执行该功能的前须进getLocation( ) Object行位置定位：doLocation，且定位事件已经执行完 毕hide( )隐藏工具条show( )显示工具条事件参数说明show工具条显示时触发此事件hide工具条隐藏时触发此事件使用 ToolBar 定位按钮或 doLocation 函数进行定 位，定位完成时触发此事件，浏览器须支持 html5location {type,lnglat}type: 事件类型 lnglat: 定位结果坐标值使用工具条缩放地图时触发此事件 type：事件类型zoomchanged {type}放大地图时， type 值为 zoomin； 缩小地图时， type 值为 zoomoutAMap.Geolocation 插件AMap.Geolocation 定位服务插件。基于 HTML5 的定位接口，只有支持该定位接口的浏 览器才能使用该功能。 它在浏览器原生定位接口基础上增加了高德地图坐标纠偏功能和在地 图上展现定位结果的功能，集成了 IP 定位和缓存策略。用户可以通过自定义回调函数取回 定位结果。若定位失败，系统将返回错误信息。注： 当浏览器原生定位接口定位失败后， 系统会调用 IP 定位， 返回定位点所在城市中心点。 此时，定位精度范围返回“null”。1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19mapObj = newAMap.Map('iCenter'); mapObj.plugin('AMap.Geolocation', function() { geolocation = newAMap.Geolocation({ enableHighAccuracy: true,//是否使用高精度定位，默 认:true timeout: 10000, //超过 10 秒后停 止定位，默认：无穷大 maximumAge: 0, //定位结果缓存 0 毫秒，默认：0 convert: true, //自动偏移坐标， 偏移后的坐标为高德坐标，默认：true showButton: true, //显示定位按钮，默 认：true buttonPosition: 'LB', //定位按钮停靠位置，默 认：'LB'，左下角 buttonOffset: newAMap.Pixel(10, 20),//定位按钮与设 置的停靠位置的偏移量，默认：Pixel(10, 20) showMarker: true, //定位成功后在定位 到的位置显示点标记，默认：true showCircle: true, //定位成功后用圆圈 表示定位精度范围，默认：true panToLocation: true, //定位成功后将定位到 的位置作为地图中心点，默认：true zoomToAccuracy:true //定位成功后调整地图视野范 围使定位位置及精度范围视野内可见，默认：false }); mapObj.addControl(geolocation); AMap.event.addListener(geolocation, 'complete', onComplete);//返回定位信息 AMap.event.addListener(geolocation, 'error', onError); //返回定位出错信息 });相关示例构造函数说明AMap.Geolocation(opts:GeolocationOptions )构造函数，创建浏览器定位实例GeolocationOptions类型说明是否使用高精度enableHighAccuracy Boolean默认值：true超时毫秒数， 若在指定时间内未定位成功，timeout Number返回超时错误信息“TIMEOUT” 默认值：无穷大缓存毫秒数。定位成功后，定位结果的保maximumAge Number留时间 默认值：0是否使用坐标偏移， 取值 true:为高德地图convert Boolean坐标，取值 false:为浏览器定位坐标 默认值：true是否显示定位按钮showButton Boolean默认值：truebuttonDomString|DomElement自定义定位按钮的内容。可支持 HTML 代码或 Dom 元素对象，不设置该属性则使 用默认按钮样式定位按钮可停靠的位置 “LT” ：左上角 “LB” ：左下角buttonPosition String“RT” ：右上角 “RB” ：右下角 默认值： “LB”按钮距离停靠位置的偏移量buttonOffset Pixel默认值：Pixel(10,20)定位成功时是否在定位位置显示一个showMarker BooleanMarker 默认值：true定位点 Marker 的配置，不设置该属性则markerOptions MarkerOptions使用默认 Marker 样式showCircleBoolean定位成功并且有精度信息时，是否用一个 圆圈 circle 表示精度范围默认值：true定位点 Circle 的配置，不设置该属性则使circleOptions CircleOptions用默认 Circle 样式定位成功后，是否把定位得到的坐标设置panToLocation Boolean为地图中心点坐标 默认值：true定位成功且显示精度范围时，是否把地图zoomToAccuracy Boolean视野调整到正好显示精度范围 默认值：false是否使用高德定位 sdk 用来辅助优化定位 效果，默认：false 仅供在使用了高德定位 sdk 的 APP 中， 嵌 入 html 页面时使用useNative Boolean注：如果要使用辅助定位的功能，除了需 要将 useNative 属性设置为 true 以外， 还 需要调用高德定位 sdk 中， LocationManagerProxy 类的 startSocket()方法，开启辅助 H5 定位功能；如果不用，就调用 stopSocket()方法 停止辅助 H5 定位功能。具体用法可参考 定位 SDK 的参考手册方法返回值说明isSupported( )Boolean是否支持浏览器定位getCurrentPosition( )获取当前位置信息监控当前位置。在监控过程中，当前watchPosition( ) Number位置发生变化会持续调用定位成功或 失败的回调函数clearWatch(watchId:Number)Number取消对当前位置的监控事件参数说明completeGeolocationResult定位成功时触发此事件errorGeolocationError定位失败时触发此事件GeolocationResult 对象属性 类型 说明positionLngLat定位结果accuracyNumber精度范围，单位：米isConvertedBoolean是否经过坐标纠偏状态信息，可能为 &SUCCESS&和 “CONVERT_FAILED” 。info String“CONVERT_FAILED”表示 convert 为 true，查询过程中得到 浏览器返回结果，但坐标纠偏失败，此时 position 为纠偏前坐标GeolocationError 对象属性 类型 说明infoString错误信息，参考错误信息列表错误信息列表错误信息 参数含义 说明NOT_SUPPORTED当前浏览器不支持定 位功能PERMISSION_DENIED浏览器拒绝定位POSITION_UNAVAILABLE浏览器无法获取当前 位置TIMEOUT定位超时未知错误（格式为：UNKOWN_ERROE:+UNKNOWN_ERROR 未知错误代码）AMap.MouseTool 插件鼠标工具插件。通过该插件，可进行鼠标画标记点、线、多边形、矩形、圆、距离量测、面 积量测、拉框放大、拉框缩小等功能。代码示例 1 2 3 4mapObj.plugin([&AMap.MouseTool&],function(){ varmousetool = newAMap.MouseTool(mapObj); mousetool.marker(); //使用鼠标工具，在地图上画标记点 });相关示例构造函数说明MouseTool( Map )MouseTool 的构造函数，目前仅支持桌面浏览器方法返说明回 值marker( options： MarkerOptions )开启鼠标画点标注模式。鼠标在地图上单击绘制点标 注，标注样式参考 MarkerOptions 设置开启鼠标画折线模式。鼠标在地图上点击绘制折线，polyline( options：鼠标左键双击或右键单击结束绘制，折线样式参考PolylineOptions )PolylineOptions 设置开启鼠标画多边形模式。鼠标在地图上单击开始绘制polygon( options：多边形，鼠标左键双击或右键单击结束当前多边形的PolygonOptions )绘制，多边形样式参考 PolygonOptions 设置rectangle( options： PolygonOptions )开启鼠标画矩形模式。鼠标在地图上拉框即可绘制相 应的矩形。矩形样式参考 PolygonOptions 设置circle( options： CircleOptions )开启鼠标画圆模式。鼠标在地图上拖动绘制相应的圆 形。圆形样式参考 CircleOptions 设置rule( options： PolylineOptions )开启距离量测模式。鼠标在地图上单击绘制量测节 点，并计算显示两两节点之间的距离，鼠标左键双击 或右键单击结束当前量测操作。量测线样式参考 PolylineOptions 设置 注： 不能同时使用 rule 方法和 RangTool 插件进行距 离量测开启面积量测模式。鼠标在地图上单击绘制量测区measureArea( options： PolygonOptions )域，鼠标左键双击或右键单击结束当前量测操作，并 显示本次量测结果。量测面样式参考 PolygonOptions 设置rectZoomIn( options： PolygonOptions )开启鼠标拉框放大模式。鼠标可在地图上拉框放大地 图。矩形框样式参考 PolygonOptions 设置rectZoomOut( options： PolygonOptions )开启鼠标拉框缩小模式。鼠标可在地图上拉框缩小地 图。矩形框样式参考 PolygonOptions 设置关闭当前鼠标操作。参数 arg 设为 true 时，鼠标操close( Boolean)作关闭的同时清除地图上绘制的所有覆盖物对象；设 为 false 时，保留所绘制的覆盖物对象。默认为 false事件参数说明draw{type,obj}鼠标工具绘制覆盖物结束时触发此事件。AMap.CircleEditor 插件圆编辑插件。用于编辑 AMap.Circle 对象，功能包括使用鼠标改变圆半径大小、拖拽圆心 改变圆的位置。代码示例 1 2 3 4 5 6 7 8 9 1 0 1 1 1 2 1 3 1 4 1 5varcircle = newAMap.Circle({ map: mapObj, center:newAMap.LngLat(&116.63&,&39. 5715&), radius:1000, strokeColor: &#F33&, strokeOpacity: 1, strokeWeight: 3, fillColor: &ee2200&, fillOpacity: 0.35 }); mapObj.plugin([&AMap.CircleEditor&],function(){ circleEditor = newAMap.CircleEditor(mapObj,circle); circleEditor.open(); });相关示例构造函数说明CircleEditor 的构造函数，参数 Map 为指定的地图AMap.CircleEditor( Map , Circle)对象，Circle 为需要编辑的圆形对象。目前仅支持桌 面浏览器方法返回值说明open( )打开编辑功能close( )关闭编辑功能事件参数说明拖拽圆心调整圆形位置时触发此事件 type: 事件类型move {type, target, lnglat}target: 发生事件的目标对象 lnglat: 调整后圆的圆心坐标鼠标调整圆形半径时，触发此事件 type: 事件类型adjust {type, target, radius}target: 发生事件的目标对象 radius: 调整后圆的半径，单位：米end{type,target}在调用 close 方法时，触发该事件，target 即为编辑后AMap.PolyEditor 插件折线、多边形编辑插件，用于编辑 AMap.Polyline、AMap.Polygon 对象，目前支持通过 鼠标调整折线、多边形的形状。代码示例1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26//编辑折线 functioneditLine(){ vararr=newArray();//经纬度坐标数组 arr.push(newAMap.LngLat(&116.368904&,&39.913423&)); arr.push(newAMap.LngLat(&116.382122&,&39.901176&)); arr.push(newAMap.LngLat(&116.387271&,&39.912501&)); arr.push(newAMap.LngLat(&116.398258&,&39.904600&)); //定义折线对象 polyline=newAMap.Polyline({ path:arr, //设置折线的节点数组 strokeColor:&#F00&, strokeOpacity:0.4, strokeWeight:3, strokeStyle:&dashed&, strokeDasharray:[10,5] }); polyline.setMap(mapObj);//地图上添加折线 //构造折线编辑对象，并开启折线的编辑状态 mapObj.plugin([&AMap.PolyEditor&],function(){ polylineEditor = newAMap.PolyEditor(mapObj,polyline); polylineEditor.open(); }); }相关示例构造函数说明PolyEditor 的构造函数，参数 Map 为指定的地图对AMap.PolyEditor( Map , Object)象，Object 为需要编辑的折线或多边形对象。目前仅 支持桌面浏览器方法返回值说明打开编辑功能。 功能开启后，多边形/折线上显示可编辑点，其中不透 明点为实际结点，鼠标左键单击该类节点可进行删除open( )操作，半透明点为虚拟节点，单击该类节点将为多边 形/折线新增结点。 实际结点和虚拟节点均可进行拖动 操作，以改变多边形/折线的形状close( )关闭编辑功能事件参数说明通过鼠标在折线上增加一个节点或在多边形上增加一个顶addnode MapsEvent点时触发此事件鼠标调整折线上某个节点或多边形上某个顶点的位置时触adjust MapsEvent发此事件通过鼠标在折线上删除一个节点或在多边形上删除一个顶removenode MapsEvent点时触发此事件end{type,target}在调用 close 方法时， 触发该事件， target 即为编辑后的折线/多边形对象AMap.Hotspot 插件底图热点插件，该插件作用是为底图上 POI 点增加热点事件。底图热点也支持通过 Map 的 isHotspot 属性开启。代码示例1 2 3 4 5 6 7 8mapObj = newAMap.Map(&iCenter&); //加载麻点图插件 mapObj.plugin('AMap.HotSpot', function() { hotspot = newAMap.HotSpot(mapObj); AMap.event.addListener(hotspot, 'click', openInfo);//点击热 点时打开信息窗体 });或者通过 Map 的 isHotspot 属性开启1 2 3 4 5 6 7 8mapObj = newAMap.Map(&iCenter&, { //二维地图显示视口 view: newAMap.View2D({ center:newAMap.LngLat(116..90923),//地图 中心点 zoom:13 //地图显示的缩放级别 }), isHotspot:true//打开地图热点，默认：false，不打开 });相关示例构造函数说明AMap.Hotspot(map:Map)构造函数，构造底图热点类对象方法返回值说明设置添加该图层的地图对象，参数设置为 null 时，取消该setMap(map:Map)插件事件参数说明click{type,lnglat,name,id}点击热点触发事件mouseover{type,lnglat,name,id}鼠标移进热点触发事件mouseout鼠标移出热点触发事件AMap.MarkerClusterer 插件用于地图上加载大量点标记，提高地图浏览性能。点聚合支持用户自定义点标记。使用用户 自定义点样式代码如下：代码示例 1 2 3 4 5 6 7 8 9 10 11 12varsts=[{ url:&imgs/1.png&, size:newAMap.Size(32,32), offset:newAMap.Pixel(-16,-30) }, { url:&imgs/2.png&, size:newAMap.Size(32,32), offset:newAMap.Pixel(-16,-30) }, { url:&imgs/3.png&,13 14 15 16 17 18 19size:newAMap.Size(48,48), offset:newAMap.Pixel(-24,-45), textColor:'#CC0066' }]; mapObj.plugin([&AMap.MarkerClusterer&],function() { cluster = newAMap.MarkerClusterer(mapObj,markers,{styles:sts}); });相关示例构造函数说明构造一个点聚合插件对象。参数 map 为地图实AMap.MarkerClusterer( map:例，将要进行点聚合的地图对象；markers 为需Map,markers:Array.&Marker&,opts:Mar要进行聚合显示的点标记集合。Opt 属性参考kerClustererOptions )MarkerClustererOptions 列表中的说明MarkerClustererOptions类型说明gridSizeNumber聚合计算时网格的像素大小，默认 60聚合的最小数量。默认值为 2，即小于 2minClusterSize Number个点则不能成为一个聚合最大的聚合级别，大于该级别就不进行相maxZoom Number应的聚合。默认值为 18，即小于 18 级的 级别均进行聚合，18 及以上级别不进行聚合聚合点的图标位置是否是所有聚合内点averageCenter Boolean的中心点。默认为否，即聚合点的图标位 置位于聚合内的第一个点处自定义聚合后的点标记图标的样式，根据 数组元素顺序设置 1-10,11-100,101-1000…聚合样式 当用户设置聚合样式少于实际叠加的点 数，未设置部分按照系统默认样式显示 单个图标样式包括以下几个属性： 1. {string}url：图标显示图片的 url 地址Array&Object &styles（必选） 2. {AMap.Size}size：图标显示图片的大 小（必选） 3. {AMap.Pixel} offset：图标定位在地图 上的位置相对于图标左上角的偏移值。默 认为(0,0),不偏移（可选） 4. {AMap.Pixel} imageOffset： 图片相对 于可视区域的偏移值，此功能的作用等同 CSS 中的 background-position 属性。默认为(0,0)，不偏移（可选） 5. {String} textColor：文字的颜色，默认 为&#000000&（可选） 6. {Number} textSize：文字的大小，默 认为 10（可选）zoomOnClickBoolean点击聚合点时， 是否散开， 默认值为： true方法返回值说明添加一个需进行聚合addMarker( marker:Marker )的点标记删除一个聚合的点标removeMarker( marker:Marker )记getClustersCount( )Number获取聚合点的总数量获取聚合网格的像素getGridSize( ) Number大小getMaxZoom( )Number获取地图中点标记的最大聚合级别获取单个聚合的最小getMinClusterSize( ) Number数量获取聚合的样式风格getStyles( ) Array&Object&集合设置聚合网格的像素setGridSize(size:Number)大小设置地图中点标记的setMaxZoom(zoom:Number)最大聚合级别设置单个聚合的最小setMinClusterSize(size:number)数量setStyles(styles:Array)设置聚合的样式风格从地图上彻底清除所clearMarkers( )有聚合点标记setMap( map:Map )设置将进行点聚合的地图对象设置将进行点聚合显setMarkers(markers:Array&Marker&)示的点标记集合获取该点聚合的地图getMap( ) Map对象获取该点聚合中的点getMarkers( ) Array&Marker&标记集合添加一组需进行聚合addMarkers(markers:Array&Marker&)的点标记删除一组聚合的点标removeMarkers(markers:Array&Marker&)记获取单个聚合点位置isAverageCenter( ) Boolean是否是聚合内所有标 记的平均中心setAverageCenter(averageCenter:Boolean)设置单个聚合点位置 是否是聚合内所有标记的平均中心事件参数说明点击事件，其中 cluster：点击的聚合点对 象，lnglat：点击的位置点坐标，target：click {cluster,lnglat,target,markers}点聚合插件对象，marker：点击的聚合点 所包含的点对象AMap.Heatmap 插件热力图，基于第三方 heatmap.js 实现，以特殊高亮的形式显示数据密集程度。根据密集程 度的不同，图上会呈现不同的颜色，以直观的形式展现数据密度。API 引用了 heatmap.js 最新版本 v2.0， v2.0 基于新的渲染模型， 具有更高的渲染效率和更强的性能。 支持 chrome、 firefox、safari、ie9 及以上浏览器。代码示例 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 varpoints =[ {&lng&:116.191031,&lat&:39.988585,&count&:10}, {&lng&:116.389275,&lat&:39.925818,&count&:11}, {&lng&:116.287444,&lat&:39.810742,&count&:12}, {&lng&:116.481707,&lat&:39.940089,&count&:13}, {&lng&:116.410588,&lat&:39.880172,&count&:14}, {&lng&:116.394816,&lat&:39.91181,&count&:15}, {&lng&:116.416002,&lat&:39.952917,&count&:16} ]; map.plugin([&AMap.Heatmap&],function() { //加载热力图插 件 heatmap = newAMap.Heatmap({map:map}); //在地图对象叠 加热力图 heatmap.setDataSet({data:points,max:100}); //设置热力图数16 17 18 19 20 21 22 23 24据集 &!--heatmap.setOptions({ radius:40, gradient:{ 0.5:'blue', 0.65:'rgb(117,211,248)', 0.7:'rgb(0, 255, 0)', 0.9:'#ffea00', 1.0:'red' } }); --&//具体参数见接口文档 });相关示例构造函数说明AMap.Heatmap( ma构造一个热力图插件对象，map 为要叠加热力图的地图对象，optsp:Map , opts:Heat属性参考 HeatmapOptions 列表中的说明。mapOptions)HeatmapOptions类型说明radiusNumber热力图中单个点的半径， 默认： 30， 单位： pixel热力图的渐变区间，热力图按照设置的颜色及 间隔显示热力图，例：gradient Object{ 0.4:'rgb(0, 255, 255)', 0.65:'rgb(0, 110, 255)',0.85:'rgb(100, 0, 255)', 1.0:'rgb(100, 0, 255)' } 其中 key 表示间隔位置，取值范围： [0,1]， value 为颜色值。默认：heatmap.js 标准配 色方案热力图透明度数组，取值范围[0,1]，0 表示完opacity Array全透明，1 表示不透明，默认：[0,1]支持的缩放级别范围， 取值范围[3-18]， 默认：zooms Array[3,18]方法返回值说明设置热力图要叠加的地图对象， 也可以在 MapsetMap(map:Map)中的 layers 属性中设置为默认显示的图层setOptions(opts:H eatmapOptions)设置热力图属性，参考 HeatmapOptions 列 表中的说明addDataPoint(lng: Lng, lat:Lat, count:Number)向热力图数据集中添加坐标点，count 不填写时默认：1设置热力图展现的数据集，数据集格式为： {max: Number 权重的最大值, data: Array 坐标数据集}， 其中 max 不填则取数据集 count 最大值setDataSet(data:O bject,url:String, urlDataParser:Fun ction))例： {max: 100, data: [{lng: 116.405285, lat: 39.904989, count: 65},{}, …]} url：jsonp 格式数据的服务地址 urlDataParser: 当 jsonp 返回结果和官方结 构不一致的时候，用户可以传递一个函数用来 进行数据格式转换hide( )隐藏热力图show( )显示热力图getMap( )Map获取热力图叠加地图对象getOptions( )Object获取热力图的属性信息getDataSet( )Object输出热力图的数据集， 数据结构同 setDataSet中的数据集AMap.RangingTool 插件距离量测插件，提供更为丰富的样式设置功能。代码示例 1 2 3 4//加载距离测量插件 mapObj.plugin([&AMap.RangingTool&],function(){ varruler = newAMap.RangingTool(mapObj); });相关示例构造函数说明构造一个距离量测插件对象。参数 map 为地AMap.RangingTool( map:Map,opts:Rangi图实例。 Opts 属性参考ngToolOptions )RangingToolOptions 列表中的说明RangingToolOptions类型说明设置量测起始点标记属性对象，包括点标记startMarkerOptions Object样式、大小等，参考 MarkerOptions 列表设置量测中间点标记属性对象，包括点标记midMarkerOptions Object样式、大小等，参考 MarkerOptions 列表设置量测结束点标记属性对象，包括点标记endMarkerOptions Object样式、大小等，参考 MarkerOptions 列表设置距离量测线的属性对象，包括线样式、lineOptions Object颜色等，参考 PolylineOptions 列表设置距离量测过程中临时量测线的属性对tmpLineOptions Object象，包括线样式、颜色等，参 考 PolylineOptions 列表设置量测起始点标签的文字内容，默认为startLabelText String“起点”设置量测中间点处标签的文字内容，默认为midLabelText String当前量测结果值设置量测结束点处标签的文字内容，默认为endLabelText String当前量测结果值设置量测起始点标签的偏移量。默认值：startLabelOffset PixelPixel(-6, 6)设置量测中间点标签的偏移量。默认值：midLabelOffset PixelPixel(-6, 6)设置量测结束点标签的偏移量。默认值：endLabelOffset PixelPixel(-6, 6)方法返回值说明turnOn( )开启距离量测功能turnOff( )关闭距离量测功能事件参数说明每添加一个量测点时触发此事件 参数 marker：添加的标记点对象addnode {marker,positon,type}position：添加的标记点坐标 type：事件类型为 addnoderemovenode每删除一个量测点时触发此事件end{target,polyline,points,distance}距离量测结束后触发此事件 参数 target：距离量测对象polyline：量测线对象 points：量测点（LngLat）对象的 集合 distance:本次距离量测的总距离值, 单位默认为：公里AMap.DragRoute 插件拖拽导航插件。通过鼠标拖拽已有导航路径上的任一点，可以实现导航起点、途经点、终点 的调整，系统根据调整后的起点、途经点、终点信息，实时查询拖拽后的导航路径并在地图 上同步显示。支持 驾车策略。建议途径点个数不超过 16 个，以保证良好的体验效果。代码示例 mapObj = newAMap.Map(&iCenter&); //绘制初始路径 varpath = []; path.push(newAMap.LngLat(116..983412)); path.push(newAMap.LngLat(116..896436)); path.push(newAMap.LngLat(116..992093)); mapObj.plugin(&AMap.DragRoute&,function(){ route = newAMap.DragRoute(mapObj, path, AMap.DrivingPolicy.LEAST_FEE); //构造拖拽导航类，传入参数分别为： 地图对象，初始路径，驾车策略 route.search(); //查询导航路径并开启拖拽导航 });相关示例1 2 3 4 5 6 7 8 9 10构造函数说明AMap.DragRoute(map:Map,path: Array.&LngLat&,policy:DrivingPo licy,opts:DragRouteOptions)DragRoute 构造函数。参数 Map 为指定的地图对象， path 指定导航的起点、 途经点、 终点的经纬度坐标数组， policy 指定驾车策略。目前仅支持桌面浏览器DragRouteOptions类型说明设置拖拽路线插件的路线属性对polyOptions Object象，包括线样式、宽度、颜色等， 参考 PolylineOptions 列表。设置拖拽路线插件起点点标记属性startMarkerOptions Object对象，包括点标记样式、大小等， 参考 MarkerOptions 列表。设置拖拽路线插件途经点点标记属midMarkerOptions Object性对象， 包括点标记样式、 大小等， 参考 MarkerOptions 列表列表。设置拖拽路线插件终点点标记属性endMarkerOptions Object对象，包括点标记样式、大小等， 参考 MarkerOptions 列表列表。showTrafficBoolean设置显示实时路况信息，true：路线中显示实时路况信息，false：关 闭实时路况信息 默认值：true方法返回值说明开始路径导航。支持鼠标拖拽导航路径节点，更改search( )途经点时，系统实时重新计算并显示导航路径getWays( )Array.&LngLat&返回除了起点和终点之外的所有点getRoute( )Array.&LngLat&返回当前导航路径， 即导航路径的经纬度坐标数组destroy( )销毁拖拽导航插件。事件参数说明addway{type,lnglat,target}添加途经点触发的事件驾车路径规划完成时触发的事件， data 同 Drivingcomplete {type,target,data}驾车路线规划返回结果 DrivingResult驾车策略DrivingPolicy类型说明LEAST_TIMEConst最快捷模式LEAST_FEEConst最经济模式LEAST_DISTANCEConst最短距离模式REAL_TRAFFICConst考虑实时路况AMap.PlaceSearchLayer 插件AMap.PlaceSearchLayer 麻点图插件，作为海量搜索结果的辅助显示类，当需求搜索结果 数量大时，建议使用麻点图展示。代码示例 1 2 3 4 5 6 7 8 9 1 0mapObj = newAMap.Map(&iCenter&); map.plugin('AMap.PlaceSearchLayer', function(){ varsearchLayer = newAMap.PlaceSearchLayer({ keywords : '超市'//搜索关键字为“超市”的 poi }); //将海量麻点叠加在地图上 searchLayer.setMap(map); AMap.event.addListener(searchLayer, 'complete', 'complete' , onComplete); AMap.event.addListener(searchLayer, 'click',onError); });相关示例构造函数说明构造函数，构造麻点图层AMap.PlaceSearchLayer(opts:PlaceSearchLaterOptions )类PlaceSearchLayerOptions类型说明要叠加该麻点图层map Map的 Map 对象&string& code=&& keywords style=&box-sizing: border- font-family: 'Microsoft Yahei', 微软雅黑, P&&&/string&&搜索关键字，支持 中文，此项为必填方法返回值说明setMap(map:Map)设置添加该图层的地图对象setKeywords(keywords:String)设置查询关键字事件参数说明co