高德地图API类参考讲述.docx

概述 命名空间：AMap 是整个高德地图JavaScript API 的命名空间，本手册中介绍的所有类和对象都通过AMap.XXX 的方式调用。?如创建一个?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 LngLat 发生事件时光标所在处的经纬度坐标。 pixel Pixel 发生事件时光标所在处的像素坐标。 type String 事件类型。 target Object 发生事件的目标对象。 地图 Map 类 地图对象类，封装了地图显示、交互等操作的方法。 构造函数 说明 AMap.Map(mapDiv:Node,?opts:MapOptions) 构造一个地图对象，参数mapDiv中传入地图容器DIV的ID值，opts地图初始化参数对象，参数详情参看MapOptions列表。 MapOptions 类型 说明 view View2D 地图视口，用于控制影响地图静态显示的属性，如：地图中心点“center” （自v1.3 新增） layers Array 地图图层数组，数组可以是图层?中的一个或多个，默认为普通二维地图。当叠加多个图层时，普通二维地图需通过实例化一个TileLayer类实现 （自v1.3 新增） level Number 地图显示的缩放级别，若center与level未赋值，地图初始化默认显示用户所在城市范围 （自V1.3.0起变更为view对象中的zoom属性） center LngLat 地图中心点坐标