高德地图API类参考概览.docx

概述 命名空间：AMap 是整个高德地图JavaScript API 的命名空间，本手册中介绍的所有类和对象都通过AMap.XXX 的方式调用。?如创建一个? HYPERLINK /api/javascript-api/reference/core \l LngLat \t _self LngLat?对象：new AMap.LngLat(116.397428,39.90923)。 已过时方法声明 已过时方法： 不符合 JavaScript API 最新版本的设计规范的方法。 已过时方法的处理原则： API 将不再更新和维护这些方法，新的应用请使用正式的方法；已使用过时方法的应用，请尽快进行代码改造，使用正式方法，以获取最新支持。 事件 1.event 事件命名空间 静态方法 方法返回值说明addDomListener(?instance,?eventName,?handler,?context)EventListener注册DOM对象事件：给DOM对象注册事件，并返回eventListener。运行AMap.event.removeListener(eventListener)可以删除该事件的监听器。参数：instance：需注册事件的DOM对象（必填），eventName：事件名称（必填），handler：事件功能函数（必填），context：事件上下文（可选，缺省时，handler中this指向参数instance引用的对象，否则this指向context引用的对象）addListener(?instance,?eventName,?handler,?context)EventListener注册对象事件：给对象注册事件，并返回eventListener。运行AMap.event.removeListener(eventListener)可以删除该事件的监听器。参数：instance：需注册事件的对象（必填），eventName：事件名称（必填），handler：事件功能函数（必填），context：事件上下文（可选，缺省时，handler中this指向参数instance引用的对象，否则this指向context引用的对象）addListenerOnce(?instance,?eventName,?handler,?context)EventListener类似于addListener，但处理程序会在处理完第一个事件后将自已移除。removeListener(?listener)none删除由上述 event.addDomListener 和 event.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 的 addDomListener()、addListener()方法返回，在需要移除事件监听器时，作为参数传递给 removeListener() 方法。 MapsEvent 对象规范（自v1.2 新增） 此对象用于表示地图、覆盖物、叠加层上的各种鼠标事件返回，包含以下字段： MapsEventOptions类型说明lnglat HYPERLINK /api/javascript-api/reference/core \l LngLat LngLat发生事件时光标所在处的经纬度坐标。pixel HYPERLINK /api/javascript-api/reference/core \l Pixel Pixel发生事件时光标所在处的像素坐标。typeString事件类型。targetObject发生事件的目标对象。 地图 Map 类 地图对象类，封装了地图显示、交互等操作的方法。 构造函数说明AMap.Map(mapDiv:Node,?opts: HYPERLINK /api/javascript-api/reference/map/ \l MapOption \t _self MapOptions)构造一个地图对象，参数mapDiv中传入地图容器DIV的ID值，opts地图初始化参数对象，参数详情参看MapOptions列表。MapOpti