资源描述:
《高德地图api类参考》由会员上传分享,免费在线阅读,更多相关内容在行业资料-天天文库。
1、概述命名空间:AMap是整个高德地图JavaScriptAPI的命名空间,本手册中介绍的所有类和对象都通过AMap.XXX的方式调用。 如创建一个 LngLat 对象:newAMap.LngLat(116.397428,39.90923)。已过时方法声明已过时方法:不符合JavaScriptAPI最新版本的设计规范的方法。已过时方法的处理原则:API将不再更新和维护这些方法,新的应用请使用正式的方法;已使用过时方法的应用,请尽快进行代码改造,使用正式方法,以获取最新支持。事件1.event事件命名空间
2、静态方法方法返回值说明addDomListener( instance, eventName, handler, context)EventListener注册DOM对象事件:给DOM对象注册事件,并返回eventListener。运行AMap.event.removeListener(eventListener)可以删除该事件的监听器。参数:instance:需注册事件的DOM对象(必填),eventName:事件名称(必填),handler:事件功能函数(必填),context:事件上下文(可选,
3、缺省时,handler中this指向参数instance引用的对象,否则this指向context引用的对象)addListener( instance, eventName, handler, context)EventListener注册对象事件:给对象注册事件,并返回eventListener。运行AMap.event.removeListener(eventListener)可以删除该事件的监听器。参数:instance:需注册事件的对象(必填),eventName:事件名称(必填),hand
4、ler:事件功能函数(必填),context:事件上下文(可选,缺省时,handler中this指向参数instance引用的对象,否则this指向context引用的对象)addListenerOnce( instance, eventName, handler, context)EventListener类似于addListener,但处理程序会在处理完第一个事件后将自已移除。removeListener( listener)none删除由上述event.addDomListener和event.
5、addListener传回的指定侦听器。trigger( instance, eventName, extArgs)none触发非DOM事件:触发非DOM事件eventName,extArgs将扩展到事件监听函数(handler)接受到的event参数中。如:在extArgs内写入{m:10,p:2},eventName监听函数(handler)可以接收到包含m,p两个key值的event对象。EventListener对象规范(自v1.2新增)此对象没有构造函数,由event的addDomListe
6、ner()、addListener()方法返回,在需要移除事件监听器时,作为参数传递给removeListener()方法。MapsEvent对象规范(自v1.2新增)此对象用于表示地图、覆盖物、叠加层上的各种鼠标事件返回,包含以下字段:MapsEventOptions类型说明lnglatLngLat发生事件时光标所在处的经纬度坐标。pixelPixel发生事件时光标所在处的像素坐标。typeString事件类型。targetObject发生事件的目标对象。地图Map类地图对象类,封装了地图显示、交互
7、等操作的方法。构造函数说明AMap.Map(mapDiv:Node, opts:MapOptions)构造一个地图对象,参数mapDiv中传入地图容器DIV的ID值,opts地图初始化参数对象,参数详情参看MapOptions列表。MapOptions类型说明viewView2D地图视口,用于控制影响地图静态显示的属性,如:地图中心点“center”(自v1.3新增)layersArray地图图层数组,数组可以是图层 中的一个或多个,默认为普通二维地图。当叠加多个图层时,普通二维地图需通过实例化一个T
8、ileLayer类实现(自v1.3新增)levelNumber地图显示的缩放级别,若center与level未赋值,地图初始化默认显示用户所在城市范围(自V1.3.0起变更为view对象中的zoom属性)centerLngLat地图中心点坐标值(自V1.3.0起变更为view对象中的center属性)zoomsArray地图显示的缩放级别范围,在PC上,默认为[3,18],取值范围[3-18];在移动设备上,默认为[3-19],取值范围[3-19]lan