51ditu Maps API 类参考文档

51ditu Maps API 类参考文档2008-7-9 [更新到2.13]

本文档是灵图提供的51ditu Maps api的类参考文档，用来在页面上展示一幅地图并与其交互，更多详细的使用范例和说明请访问51ditu API开发文档页面，API使用交流清访问51ditu产品论坛

类列表：
LTPoint　 LTEvent　 LTBounds　 LTEllipse　 LTEllipseControl　 LTFunction　 LTHtmlElementControl　 LTIcon　 LTInfoWindow　 LTMaps　 LTMapText　 LTMarkControl　 LTMarker　 LTOverviewMapControl　 LTPlace　 LTPlaceList　 LTPolygon　 LTPolygonControl　 LTPolyLine　 LTPolyLineControl　 LTRect　 LTRectControl　 LTScaleControl　 LTStandMapControl　 LTZoomInControl　 LTZoomSearchControl　 LTRegoLoader　

代表地理点坐标，该点的位置通过灵图的NTU坐标来描述。

构造函数：

函数名称	最后更新版本	返回值类型	说明
LTPoint(lng 说　明：NTU经度类　型：Number ,lat 说　明：NTU纬度类　型：Number )		LTPoint	以指定的NTU经度和纬度创建一个地理点坐标

方法：

函数名称	最后更新版本	返回值类型	说明
getLongitude()		Number	获取NTU经度
getLatitude()		Number	获取NTU纬度

返回顶部

51ditu JavaScript API之中用来进行事件处理的类，该类的所有方法都是静态方法，因此不需要构造该类的实例而直接使用方法即可，例如LTEvent.addListener(obj,event,handle);

静态方法：

函数名称	最后更新版本	返回值类型	说明
getCallback(obj 类　型：Object ,handle 类　型：Function )		Function	返回一个对实例obj的handle方法的调用函数
cancelBubble(event? 类　型：Event 默认值：window.event )		无	中止事件处理的执行并返回事件处理结果false
returnTrue(event? 类　型：Event 默认值：window.event )		无	中止事件处理的执行并返回事件处理结果true
bind(obj 说　明：事件发生的对象类　型：Object ,event 说　明：事件名称，例如“click” 类　型：Eventname ,hObj 说　明：该事件被触发时将会执行hObj对象的hMethod方法类　型：Object ,hMethod 说　明：该事件被触发时将会执行hObj对象的hMethod方法类　型：Function ,runOnce? 说　明：指定该事件绑定是否只运行一次，如果为true,该事件绑定将会在第一次运行后移除类　型：Bool 默认值：false )	2.13	Listener	将hObj对象的hMethod方法绑定到obj的event事件，返回一个listener对象,对浏览器集成的事件和自定义的事件都能使用范例：双击结束测距控件范例：双击结束测面控件范例：鼠标移动到标注上显示信息浮窗
addListener(obj 说　明：事件发生的对象类　型：Object ,event 说　明：事件名称，例如“click” 类　型：Eventname ,handle 说　明：该事件被触发时需要执行的函数类　型：Function ,runOnce? 说　明：指定该事件绑定是否只运行一次，如果为true,该事件绑定将会在第一次运行后移除类　型：Bool 默认值：false )	2.13	Listener	将handle函数绑定到obj的event事件，返回一个listener对象，对浏览器集成的事件和自定义的事件都能使用范例：使用拉框查找控件让用户选择位置区域范例：双击放大(先定位到中心然后放大) 范例：使用move事件实时的显示地图的坐标信息范例：双击放大(先放大然后定位到中心) 范例：响应地图点击(标点) 范例：在文字标签上信息浮窗范例：给标记添加点击事件范例：为不同的标记显示不同的信息浮窗
removeListener(listener 类　型：Listener )		无	删除指定的事件注册，参数必须是通过LTEvent.bind方法或者LTEvent.addListener方法返回的事件监视器范例：双击放大(先定位到中心然后放大)
clearListeners(obj 类　型：Object ,event? 类　型：Eventname 默认值：null )		无	删除obj对象的所有event事件注册，如果不指定event或者event为空，则删除obj对象的所有事件
deposeNode(obj 类　型：Object )		无	删除指定HTML节点及其子节点的所有event事件注册，用来清除节点，防止内存溢出
trigger(obj 类　型：Object ,event 类　型：Eventname ,args 类　型：Array )		无	触发obj的event事件，args是触发的参数数组

返回顶部

代表一个矩形地理区域的对象，例如地图当前显示的地理范围

构造函数：

函数名称	最后更新版本	返回值类型	说明
LTBounds(Xmin 说　明：经度最小值类　型：Number ,Ymin 说　明：纬度最小值类　型：Number ,Xmax 说　明：经度最大值类　型：Number ,Ymax 说　明：纬度最大值类　型：Number )		LTBounds	以指定的坐标范围新建一个经纬度矩形区域范例：将地图控制在一定范围内

静态方法：

函数名称	最后更新版本	返回值类型	说明
getPointsBounds(points 类　型：点坐标LTPoint数组 )	2.09	无	返回包含点数组之中所有点的最小范围

方法：

函数名称	最后更新版本	返回值类型	说明
getXmin()		Number	获取经度最小值
getYmin()		Number	获取纬度最小值
getXmax()		Number	获取经度最大值
getYmax()		Number	获取纬度最大值
getCenterPoint()	2.13	LTPoint	获取该范围的中心点坐标
extend(point 类　型：LTPoint )	2.13	无	扩展该范围以包含该点,本方法在通过一系列点得到一个LTBounds的时候比较有用
containsBounds(bounds 类　型：LTBounds )		Bool	返回该区域(LTBounds)是否包含指定的区域(LTBounds)
containsPoint(point 类　型：LTPoint )		Bool	返回该区域(LTBounds)是否包含指定的点(LTPoint) 范例：将地图控制在一定范围内
getIntersection(startPoint 类　型：LTPoint ,endPoint 类　型：LTPoint )		Bool	返回指定线段在该区域(LTBounds)之中的那一段，线段通过起点(LTPoint)和终点(LTPoint)指定

返回顶部

代表地图上的一个椭圆形状，在IE之中，将会使用VML的技术来绘制椭圆，因此必须在页面上加载VML的命名空间，在其他浏览器之中，将会使用普通的画图技术，值得注意的是：由于椭圆存在背景，因此绘制的过程之中没有使用和折线一样的切割技术，这样一个本来很小的椭圆在地图放大之后可能成为一个非常大的椭圆，从而引起性能上的问题。

注意:因为LTEllipse和LTRect对象除了表现一个为矩形框，一个是椭圆外，类的使用基本相同,因此，拥有LTRect的所有属性，方法和事件，以下只列出了LTEllipse专有的方法!

构造函数：

函数名称	最后更新版本	返回值类型	说明
LTEllipse(bounds 说　明：用来绘制椭圆的矩形坐标范围类　型：LTBounds ,color? 说　明：椭圆的显示线条颜色类　型：String 默认值：blue ,bgcolor? 说　明：椭圆的显示背景颜色类　型：String 默认值：#99FFCC ,weight? 说　明：椭圆的边框显示线宽,以像素为单位类　型：Number 默认值：3 ,opacity? 说　明：椭圆的显示不透明度，范围为0-1,越小代表越透明类　型：Number 默认值：0.5 )	2.11	LTEllipse	使用指定的坐标范围LTBounds，创建一个LTEllipse椭圆

返回顶部

椭圆绘制控件，用来让用户绘制一个椭圆，同时也可以通过事件来获取用户绘制的椭圆信息。
LTEllipseControl和LTRectControl类似，因此，LTRectControl的所有方法都对LTEllipseControl适用，下面只列出了LTEllipseControl自己独有的方法和事件。

构造函数：

函数名称	最后更新版本	返回值类型	说明
LTEllipseControl(color? 说　明：边框颜色类　型：String 默认值：#003366 ,bgcolor? 说　明：背景颜色类　型：String 默认值：#CCCCFF ,weight? 说　明：边框宽度类　型：Number 默认值：1 ,opacity? 说　明：透明度,0-1 类　型：Number 默认值：0.5 )		LTEllipseControl	创建一个LTEllipseControl控件

事件：

事件名称	最后更新版本	参数	说明
draw	2.11	(bounds 说　明：用户最后绘制的椭圆的坐标的LTBounds对象类　型：LTBounds ,ellipse 说　明：用户最后绘制的椭圆类　型：LTEllipse )	用户每次完成一次椭圆绘制时触发

返回顶部

51ditu Maps API之中的公用函数类，包含一些常用的函数，该类的所有方法都是静态方法，因此不需要构造该类的实例而直接使用方法即可，例如LTFunction.getEventPosition(event,container);

静态方法：

函数名称	最后更新版本	返回值类型	说明
getPageOffset(obj 类　型：Object )		像素值数组	返回obj对象相对于整个页面左上角的像素位置,返回一个数组point,point[0]为横向大小，point[1]为纵向大小
getEventPosition(event 类　型：window事件 ,container 类　型：Object )		像素值数组	返回事件发生位置相对于指定的HTML容器对象左上角的位置，返回一个数组point,point[0]为横向大小，point[1]为纵向大小
getPointsDistance(point1 类　型：LTPoint ,point2 类　型：LTPoint )		Number	计算两点之间的以米为单位的距离范例：计算两点之间的距离
setOpacity(obj 说　明：需要设置不透明度的层类　型：Object ,opacity 说　明：不透明度，从0到1，越小越透明类　型：Number )		无	设置指定层的不透明度

返回顶部

一个地图控件，用来将指定的层显示到地图上，用来让用户往地图上方便地添加自定义的内容

构造函数：

函数名称	最后更新版本	返回值类型	说明
LTHtmlElementControl(div 说　明：需要显示到地图上的层，该层必须当前并不在文档之中类　型：Object )		LTHtmlElementControl	创建一个LTHtmlElementControl控件

方法：

函数名称	最后更新版本	返回值类型	说明
setLeft(length 类　型：Number )		无	设置控件相对于地图左边的像素距离
setRight(length 类　型：Number )		无	设置控件相对于地图右边的像素距离
setTop(length 类　型：Number )		无	设置控件相对于地图上方的像素距离
setBottom(length 类　型：Number )		无	设置控件相对于地图下方的像素距离
setVisible(booleans 类　型：Bool )		无	设置控件在地图上是否可见
setOpacity(opacity 说　明：不透明度,范围从0到1，该数字越小越透明类　型：Number )		无	设置地图的显示不透明度

返回顶部

用来显示到地图上的一个图标对象

构造函数：

函数名称	最后更新版本	返回值类型	说明
LTIcon(url 说　明：图标使用的图片路径URL 类　型：String ,size 说　明：图标的大小，如果不指定，则使用该图标图片的大小，不过在某些情况下可能出现问题，因此，强烈建议指定图标的大小，系统集成图标的大小为[23,21] 类　型：像素值数组 ,anchor 说　明：图标的锚点(图标上用来指向到一定位置的点)相对于图标左上角的坐标，如果不指定，默认是图标底边中心位置，系统集成图标的锚点为[4,21] 类　型：像素值数组 )		LTIcon	创建一个LTIcon图标范例：给标记(marker)自定义图标

方法：

函数名称	最后更新版本	返回值类型	说明
getSrc()	2.11	String	返回图标使用的图片URL
setSrc(url 说　明：图标使用的图片路径URL 类　型：String )		无	设置图标使用的图片，通过图片路径URL指定
setSize(size 说　明：图标的大小像素数组，如[23,21] 类　型：像素值数组 )		无	设置图标的大小，如[23,21]
setAnchor(position 说　明：图标锚点相对于图片左上角的像素距离，如[4,21] 类　型：像素值数组 )		无	设置图标锚点在图片上的位置，即相对于图片左上角的像素距离
getSize()		像素值数组	获取图标的大小,如果指定了图标的大小，则返回该大小，否则返回该图标图片的实际大小，假如调用的时候该图标还没有下载完成，则可能返回[0,0],而这可能引发其他问题，因此强烈建议在自定义图标的时候指定图标的大小和锚点位置。
getAnchor()		像素值数组	获取图标锚点在图片上的位置,如果指定了图标锚点位置，则返回该位置，否则返回该图标图片底边中心位置，假如调用的时候该图标还没有下载完成，则可能返回[0,0],而这可能引发其他问题，因此强烈建议在自定义图标的时候指定图标的大小和锚点位置。
copy()		LTIcon	以该图标的图片路径、大小和锚点位置复制一个新图标，返回该新图标,这个方法非常有用，很多情况下，会有多个标记Marker使用同样的图标的情况，使用该方法可以简化开发。范例：LTIcon图标的复制和使用

返回顶部

地图上的信息浮窗对象，该对象可以初始化，也可以使用LTMapText的openInfoWinElement,openInfoWinUrl,openInfoWinHtml几个方法来创建。所有的LTMarker使用同一个LTInfoWindow实例

构造函数：

函数名称	最后更新版本	返回值类型	说明
LTInfoWindow(point 说　明：信息浮窗所指向的地理点坐标类　型：LTPoint ,offset? 说　明：信息浮窗显示时向右下角偏移量(像素)，默认为[0,0],不偏移类　型：像素值数组默认值：[0,0] )	2.11	LTInfoWindow	创建一个信息浮窗范例：给信息浮窗指定显示的偏移量范例：在指定标记(marker)处显示信息浮窗范例：在指定的座标处显示信息浮窗范例：移动地图以保证信息浮窗全部显示范例：在文字标签上信息浮窗范例：为不同的标记显示不同的信息浮窗

方法：

函数名称	最后更新版本	返回值类型	说明
setLabel(content 说　明：信息浮窗的显示内容HTML字符串类　型：String )		无	设置信息浮窗的显示内容HTML 范例：给信息浮窗指定显示的偏移量范例：在指定标记(marker)处显示信息浮窗范例：在指定的座标处显示信息浮窗范例：移动地图以保证信息浮窗全部显示
setTitle(content 说　明：信息浮窗的显示标题字符串类　型：String )		无	设置信息浮窗的显示标题范例：在指定标记(marker)处显示信息浮窗
closeInfoWindow()		无	关闭该信息浮窗范例：鼠标移动到标注上显示信息浮窗
setWidth(width 类　型：Number )		无	设置信息浮窗的宽度，如果信息浮窗的内容比较多，将会自动适应
setHeight(height 类　型：Number )		无	设置信息浮窗的高度，如果信息浮窗的内容比较多，将会自动适应
setPoint(point 类　型：LTPoint )		无	设置或改变信息浮窗指向的地理点坐标
closeInfoWindowWithMouse()		无	设置该信息浮窗在用户鼠标移开后自动关闭范例：鼠标移动到标注上显示信息浮窗
disableCloseInfoWindowWithMouse()		无	取消该信息浮窗在用户鼠标移开后自动关闭的设置
moveToShow()	2.13	无	移动地图以确保信息浮窗在地图范围内

事件：

事件名称	最后更新版本	参数	说明
close		无	当信息浮窗被关闭时触发范例：鼠标移动到标注上显示信息浮窗

返回顶部

51ditu Maps API的核心对象，每个实例代表页面上的一幅地图

构造函数：

函数名称	最后更新版本	返回值类型	说明
LTMaps(container 说　明：用来显示地图的层或层的ID，必须是已经在页面文档之中存在的层类　型：Object 或 String )		LTMaps	使用指定的层创建一个地图对象范例：显示基本地图范例：用中文名称，拼音，电话区号，行政区号代码来定位地图范例：地图的性能(页面不停刷新时)

方法：

函数名称	最后更新版本	返回值类型	说明
centerAndZoom(point 说　明：地图的中心点地理坐标类　型：LTPoint 或 String ,zoom 说　明：缩放等级，当前为0-14 类　型：Number )		无	初始化或重新定位地图的中心点和缩放等级，在运行该方法之前不能执行添加标注等操作,point参数可以为LTPoint对象，也可以是城市代码（大部分情况下为拼音，具体请参阅城市代码对照表）范例：显示基本地图范例：用中文名称，拼音，电话区号，行政区号代码来定位地图
cityNameAndZoom()		无	实际上就是centerAndZoom，为了兼容以前的版本而预留
moveToCenter(point 类　型：LTPoint ,zoom? 类　型：Number 默认值：不变化 )	2.14	无	将地图的中心点变换到指定的地理坐标，如果移动范围不大，则执行一个滑动过程，如果同时指定了缩放等级，则同时滑动到该缩放等级
setCenterAtLatLng(point 类　型：LTPoint )		无	将地图的中心点直接变换到指定的地理坐标，不执行滑动过程
getCenterPoint()		LTPoint	获取地图中心点对应的地理坐标范例：使用move事件实时的显示地图的坐标信息
getBoundsLatLng()		LTBounds	获取当前地图显示的地理区域范围
getImgNumber()		Number	获取地图上当前已经下载完成的地图分块图片数目
getTotalImgNumber()		Number	获取当前地图上总的地图分块图片数目，包含正在下载的、已经下载完成的和出错的图片
getErrorImgNumber()		Number	获取当前地图上已经下载出错的图片数目
getCurrentZoom()		Number	获取地图当前的缩放级别（当前为0-14）范例：使用move事件实时的显示地图的坐标信息
zoomTo(zoom 说　明：缩放等级（当前为0-14）类　型：Number )		无	将视图切换到指定的缩放等级,中心点坐标不变
zoomIn()		无	放大一级视图
zoomOut()		无	缩小一级视图
getViewSize()		像素值数组	获取地图显示的像素大小，返回一个数组point,point[0]为横向大小，point[1]为纵向大小
resizeMapDiv()		无	在地图所在的层大小变化后（例如窗口大小改变），调用该方法以让地图重新自适应新的大小
addControl(control 类　型：地图控件 )		无	向地图上添加一个控件,可以是系统集成的控件或自定义控件。范例：拉框放大控件范例：简易导航控件范例：简易导航控件范例：迷你缩放控件范例：标准导航控件范例：使用鹰眼地图控件范例：设置比例尺控件样式
removeControl(control 类　型：地图控件 ,depose? 说　明：是否彻底清除该控件,当为true时将完全删除该控件以释放内存，彻底清除之后该控件不能被再次使用类　型：Bool 默认值：false )	2.09	无	移除一个地图控件
addOverLay(overlay 类　型：地图标注 )		无	向地图上添加一个标注,目前系统集成的标注有：图标标记LTMarker 文字标记LTMapText 折线LTPolyLine 多边形LTPolygon 信息浮窗LTInfoWindow 范例：自定义标注：在地图上画圆范例：向地图上添加一个矩形图形范例：向地图上添加折线范例：设置折线的颜色、透明度和线宽范例：折线响应事件范例：给标记(marker)自定义图标范例：多边形响应事件范例：给信息浮窗指定显示的偏移量范例：在指定标记(marker)处显示信息浮窗范例：在指定的座标处显示信息浮窗范例：移动地图以保证信息浮窗全部显示范例：在指定的标记(marker)旁边显示文字标签范例：在指定的坐标处显示文字标签范例：根据地图的视图选择性的显示标记范例：向地图上添加标记范例：在地图初始化之前向地图上添加标记
removeOverLay(overlay 类　型：地图标注 ,depose? 说　明：是否彻底清除该标注,当为true时将完全删除该标注以释放内存，彻底清除之后该标注不能被再次使用类　型：Bool 默认值：false )	2.09	无	移除一个地图标注
clearOverLays()		无	移除地图上的所有标注
getZoomUnits(zoom 说　明：缩放等级类　型：Number )		Number	返回在指定缩放等级下1个像素代表多少个NTU单位
getPointLatLng(position 说　明：相对于地图左上角的像素坐标数组[left,top] 类　型：像素值数组 )		LTPoint	将地图上相对于container的像素坐标转化为地理坐标，参数是数组[left,top],返回值类型是LTPoint
getPixelCoord(point 类　型：LTPoint )		像素值数组	将地理坐标转化为地图上点的像素坐标，相对于container左上角，参数是LTPoint,返回值是数组[left,top]
getOverLayPosition(point 类　型：LTPoint )		像素值数组	类似于getPixelCoord方法，将地理坐标转化为地图上点的像素坐标，相对于放置标注的层，需要在自定义标注之中定位标注的位置应该用此方法,返回值是数组[left,top]
returnLastView()		无	将地图重新定位到上次通过centerAndZoom定位的视图，包括中心坐标和缩放等级
move(position 类　型：像素值数组 )		无	将地图滑动指定个像素单位，例如参数为[100,100]则代表向右、下方向移动分别移动100个像素单位，参数为[-100,0]代表地图向左滑动100个像素单位范例：地图的性能(地图移动时) 范例：将地图控制在一定范围内范例：双击放大(先定位到中心然后放大) 范例：使用move事件实时的显示地图的坐标信息
isDragging()		Bool	返回当前地图是否处在允许拖动的状态
enableDrag()		无	设置地图允许拖动（默认允许）
disableDrag()		无	设置地图禁止拖动
setSlideMaxZoom(maxZoom 类　型：Number )	2.14	无	设置地图滑动缩放等级的最大缩放等级，默认为4，即如果当前缩放等级和需要跳转到的缩放等级差为4，则不会执行滑动过程以免占用过多的浏览器性能，如果设置为0，则地图上任何时候都不会出现缩放等级滑动，包括拖动骨头棒缩放等级浮标和鼠标滚轮缩放
getMapContent(flag? 说　明：返回的内容的类型：0:标注内容和地图图片内容；1:仅打印地图图片内容; 类　型：Number 默认值：0 )		String	获取当前地图的内容HTML,用来实现打印等功能范例：地图的打印
getBestZoom(bounds 说　明：要显示的范围类　型：LTBounds ,padding? 说　明：设置计算缩放等级的时候预留的空隙，以防止将一些标记显示在地图的边缘处，以象素为单位类　型：Number 默认值：10 )	2.13	无	要在地图之中显示该范围最合适的缩放等级，要注意该函数仅仅根据区域的大小来选择缩放等级，并不判断该区域在所返回的缩放等级是否有图
getBestMap(points 类　型：点坐标LTPoint数组 )		无	将地图指定到一个特定的视图，该视图正好包含指定地理点坐标数组的所有点，要注意该函数仅仅根据点所分布区域的大小来选择缩放等级，并不判断该区域在所返回的缩放等级是否有图范例：显示最佳比例尺和位置
setMapCursor(normalCursor? 说　明：地图普通情况下的鼠标样式，可以用系统集成的鼠标样式名称如"pointer","move","hand"等,也可以使用自定义的鼠标样式文件URL地址; 类　型：String 默认值："default" ,dragCursor? 说　明：地图被拖动情况下的鼠标样式，可以用系统集成的鼠标样式名称如"pointer","move","hand"等,也可以使用自定义的鼠标样式文件URL地址; 类　型：String 默认值："move" )	2.09	无	设置地图的鼠标样式范例：设置地图鼠标样式
handleMouseScroll(toPoint? 说　明：是否跟随鼠标指向，默认情况下地图将保持当前中心点不变进行缩放，当该参数设置为true之后，将以保持鼠标指向点位置不变的模式进行缩放; 类　型：Bool 默认值：false )	2.09	无	启用鼠标滚轮滑动缩放等级的功能范例：通过键盘和鼠标滚轮操作地图范例：滑动鼠标滚轮的时候以鼠标位置为中心滑动缩放等级
clearHandleMouseScroll()		无	禁用鼠标滚轮滑动缩放等级的功能
handleKeyboard()		无	启用键盘操作支持范例：通过键盘和鼠标滚轮操作地图
clearHandleKeyboard()		无	禁用键盘操作支持

事件：

事件名称	最后更新版本	参数	说明
resize		(viewSize 说　明：viewSize[0]代表宽度，viewSize[1]代表高度类　型：Array )	在地图大小改变时触发，参数是新的地图大小数组，viewSize[0]代表宽度，viewSize[1]代表高度
zoom		(oldZoom 说　明：变化前的缩放等级，如果是地图初始化过程，则为0 类　型：Number ,newZoom 说　明：变化后的缩放等级类　型：Number )	在地图缩放等级变化后触发，因为在缩放等级滑动开始前触发，因此也可以认为是zoomstart,因此没有给地图再定义zoomstart事件范例：使用move事件实时的显示地图的坐标信息
zoomend		(newZoom 说　明：滑动完成后(当前)的缩放等级类　型：Number )	在地图缩放等级滑动完成后触发
move		(centerPoint 说　明：移动后的中心点坐标类　型：LTPoint ,flag 说　明：是否需要重新定位标注类　型：Bool )	在地图中心点变化时触发范例：地图的性能(地图移动时) 范例：将地图控制在一定范围内范例：双击放大(先定位到中心然后放大) 范例：使用move事件实时的显示地图的坐标信息
movestart	2.09	(centerPoint 说　明：当前的中心点坐标类　型：LTPoint )	在地图中心点开始移动时触发，有三种情况：按下鼠标开始拖动地图时；按下键盘方向键开始移动地图时；使用moveToCenter方法定位地图时。
moveend	2.09	(centerPoint 说　明：移动后的中心点坐标类　型：LTPoint )	在地图中心点移动完成时触发，触发情况分别与movestart方法对应。范例：双击放大(先定位到中心然后放大)
dblclick		(point 说　明：鼠标双击的位置相对于地图左上角的像素坐标，point[0]代表横向距离，point[1]代表纵向距离，如果要转化为地理坐标，请使用LTMaps的getPointLatLng方法转化为地理NTU经纬度类　型：Array )	在地图被双击时触发范例：双击放大(先定位到中心然后放大) 范例：双击放大(先放大然后定位到中心)
mousedown		(point 说　明：鼠标按下的位置相对于地图左上角的像素坐标，point[0]代表横向距离，point[1]代表纵向距离，如果要转化为地理坐标，请使用LTMaps的getPointLatLng方法转化为地理NTU经纬度类　型：Array ,button 说　明：鼠标键编号，1：左键；2：右键类　型：Number )	鼠标在地图上按下时触发
mousedrag		(point 说　明：鼠标的位置相对于地图左上角的像素坐标，point[0]代表横向距离，point[1]代表纵向距离，如果要转化为地理坐标，请使用LTMaps的getPointLatLng方法转化为地理NTU经纬度类　型：Array ,button 说　明：鼠标键编号，1：左键；2：右键类　型：Number )	鼠标在地图上拖拽时持续触发
mouseup		(point 说　明：鼠标的位置相对于地图左上角的像素坐标，point[0]代表横向距离，point[1]代表纵向距离，如果要转化为地理坐标，请使用LTMaps的getPointLatLng方法转化为地理NTU经纬度类　型：Array ,button 说　明：鼠标键编号，1：左键；2：右键类　型：Number )	鼠标在地图上释放时触发
click		(point 说　明：鼠标的位置相对于地图左上角的像素坐标，point[0]代表横向距离，point[1]代表纵向距离，如果要转化为地理坐标，请使用LTMaps的getPointLatLng方法转化为地理NTU经纬度类　型：Array ,button 说　明：鼠标键编号，1：左键；2：右键类　型：Number ,marker? 说　明：如果用户是点在一个标注上，则该参数为被点击的标注类　型：LTMarker 默认值：null )	鼠标在地图上点击时触发范例：响应地图点击(标点)
imageerror		(img 说　明：出错的分块图片对象,是一个HTML的img标签对象,可以通过设置img.src调用其他的替换图片类　型：Object )	在地图上每一个分块图片下载出错的时候触发，例如服务器返回404错误
imagechange		(img 说　明：操作的分块图片对象,是一个HTML的img标签对象类　型：Object ,type 说　明：变化的类型，1代表分块图片的首次加载和显示,2代表分块图片的显示，3代表分块图片的隐藏类　型：Object )	在地图上每一个分块图片发生变化时触发，包括分块图片加载完成，显示，隐藏。
init		无	在地图完成初始化准备开始下载图片时触发

返回顶部

地图上文本标注，在指定地理点处显示文字，文字的左边界中点和指定的地理点或标注对齐,还可以让一个文字标注始终跟随一个标记Marker,这在显示带名称的标记的时候十分有用
注意，因为实际上允许使用HTML作为内容，因此，可以用来向地图上的指定位置显示任何自定义的内容
LTMarker也是一种LTMapText，因此，可以使用下面的属性，方法和事件

构造函数：

函数名称	最后更新版本	返回值类型	说明
LTMapText(point 说　明：文本标注对象所在的地理点坐标或标记类　型：LTPoint 或 LTMarker ,offset? 说　明：文本标签显示时向右下角偏移量(像素)，默认为[0,0],不偏移类　型：像素值数组默认值：[0,0] )	2.10	LTMapText	创建一个文本标注对象,该对象显示在指定的地理位置或标注处

方法：

函数名称	最后更新版本	返回值类型	说明
onClick()	2.13	无	模拟该标注被点击，运行该方法会触发标注的click事件
setPoint(point 类　型：LTPoint )		无	设置标记所在的地理点坐标
getPoint()	2.11	LTPoint	返回该标记所在的地理点位置
setLabel(content 说　明：文本HTML字符串类　型：String )		无	设置显示的文本内容范例：设置文字标签显示的偏移量范例：在指定的标记(marker)旁边显示文字标签范例：在指定的坐标处显示文字标签
setFontSize(size 类　型：Number )		无	设置文本的字体大小
setFontColor(color 类　型：String )		无	设置文本字体颜色范例：设置文字标签的样式
setBackgroundColor(color 类　型：String )		无	设置文本的背景色范例：将文字标签的背景设置为透明范例：设置文字标签的样式
setBorderLine(width 类　型：Number )		无	设置文本边框线宽范例：将文字标签的背景设置为透明
setBorderColor(color 类　型：String )		无	设置文本边框颜色
setOpacity(opacity 说　明：不透明度，从0-1,数字越小越透明类　型：Number )		无	设置标注的显示不透明度范例：设置标记的透明度
setVisible(booleans 类　型：Bool )		无	设置是否可见
getVisible()		Bool	返回是否可见
setNoWrap(booleans 说　明：为true将禁止文本换行类　型：Bool )		无	设置是否禁止文本换行
setInfoWinWidth(width 说　明：宽度类　型：Number )	2.12	无	设置在标记上弹出的信息浮窗的宽度,信息浮窗的宽度是指其中包含的内容的宽度，不包含信息浮窗的外框和指向箭头，注意这个设置是全局的,因为所有的标记使用用一个信息浮窗,因此,在任意一个标注上使用该方法都会导致所有标注上信息浮窗大小同步改变.
setInfoWinHeight(height 说　明：高度类　型：Number )	2.12	无	设置在标记上弹出的信息浮窗的高度,信息浮窗的宽度是指其中包含的内容的宽度，不包含信息浮窗的外框和指向箭头，注意这个设置是全局的,因为所有的标记使用用一个信息浮窗,因此,在任意一个标注上使用该方法都会导致所有标注上信息浮窗大小同步改变.
openInfoWinElement(obj 说　明：作为信息浮窗内容的HTML标签类　型：Object )	2.12	LTInfoWindow	在该标记上方以指定的HTML标签的内容作为信息浮窗的内容打开信息浮窗.
openInfoWinUrl(url 说　明：作为信息浮窗内容的url地址类　型：String )	2.12	LTInfoWindow	在该标记上方以指定的URL网页内容作为信息浮窗内容打开信息浮窗.指定的URL将使用iframe形式显示到信息浮窗之中范例：InfoWin嵌入url
openInfoWinHtml(html 说　明：作为信息浮窗内容的HTML内容类　型：String )	2.12	LTInfoWindow	在该标记上方以指定的HTML内容作为信息浮窗内容打开信息浮窗. 范例：在文字标签上信息浮窗

事件：

事件名称	最后更新版本	参数	说明
click	2.12	(point 说　明：鼠标的位置相对于地图左上角的像素坐标，point[0]代表横向距离，point[1]代表纵向距离，如果要转化为地理坐标，请使用LTMaps的getPointLatLng方法转化为地理NTU经纬度类　型：Array ,button 说　明：鼠标键编号，1：左键；2：右键类　型：Number )	在用户点击标注时触发范例：在文字标签上信息浮窗
mousedown	2.12	(point 说　明：鼠标按下的位置相对于地图左上角的像素坐标，point[0]代表横向距离，point[1]代表纵向距离，如果要转化为地理坐标，请使用LTMaps的getPointLatLng方法转化为地理NTU经纬度类　型：Array ,button 说　明：鼠标键编号，1：左键；2：右键类　型：Number )	鼠标在标记上按下时触发
mouseup	2.12	(point 说　明：鼠标的位置相对于地图左上角的像素坐标，point[0]代表横向距离，point[1]代表纵向距离，如果要转化为地理坐标，请使用LTMaps的getPointLatLng方法转化为地理NTU经纬度类　型：Array ,button 说　明：鼠标键编号，1：左键；2：右键类　型：Number )	鼠标在标记上释放时触发
mouseover	2.12	(point 说　明：鼠标的位置相对于地图左上角的像素坐标，point[0]代表横向距离，point[1]代表纵向距离，如果要转化为地理坐标，请使用LTMaps的getPointLatLng方法转化为地理NTU经纬度类　型：Array )	鼠标在标记图片上时触发
mouseout	2.12	(point 说　明：鼠标的位置相对于地图左上角的像素坐标，point[0]代表横向距离，point[1]代表纵向距离，如果要转化为地理坐标，请使用LTMaps的getPointLatLng方法转化为地理NTU经纬度类　型：Array )	鼠标离开标记图片上方时触发
dragstart	2.12	(latlng 说　明：标注被拖动后的位置类　型：LTPoint )	鼠标每次开始拖动标注时触发
drag	2.12	(latlng 说　明：标注被拖动后的位置类　型：LTPoint )	鼠标拖动时持续触发范例：可拖动的文字标签
dragend	2.12	(latlng 说　明：标注被拖动后的位置类　型：LTPoint )	鼠标每次拖动标注完成之后触发范例：可拖动的文字标签

返回顶部

标注控件，用来让用户在地图上标注一个点，可以通过该控件提供的事件来获得用户标点的位置

构造函数：

函数名称	最后更新版本	返回值类型	说明
LTMarkControl(icon? 说　明：标注控件使用的图标类　型：LTIcon 默认值：API默认图标 ,cursor? 说　明：标注控件使用中地图的鼠标样式，目标应该是一个.cur文件路径,或系统集成的鼠标样式名称，例如"pointer",注意有些样式可能在特定的浏览器之中才能使用，例如十字鼠标样式"crosshair"只在IE之中能够使用类　型：String 默认值："pointer" ,follow? 说　明：是否在鼠标移动时跟随一个标记图标类　型：Bool 默认值：true )	2.13	LTMarkControl	创建一个LTMarkControl控件范例：设置标注控件的图标范例：标注控件的使用范例：禁止标注控件的图标跟随鼠标移动

方法：

函数名称	最后更新版本	返回值类型	说明
setLeft(length 类　型：Number )		无	设置控件相对于地图左边的像素距离
setRight(length 类　型：Number )		无	设置控件相对于地图右边的像素距离
setTop(length 类　型：Number )		无	设置控件相对于地图上方的像素距离
setBottom(length 类　型：Number )		无	设置控件相对于地图下方的像素距离
setVisible(booleans 类　型：Bool )		无	设置控件在地图上是否可见
setOpacity(opacity 说　明：不透明度,范围从0到1，该数字越小越透明类　型：Number )		无	设置控件的显示不透明度
setLabel(text 说　明：按钮的文本类　型：String )		无	设置控件的按钮文字，默认为："标注"
setPointImage(url 说　明：图标路径URL 类　型：String )		无	设置标注控件显示的标注图标路径URL 范例：设置标注控件的图标
getMarkControlPoint()		LTPoint	获取用户标注的点，如果用户还没标点，则返回null
btnClick()		无	模拟控件的按钮被点击，每运行一次该方法，相当于点击一次控件的按钮切换该控件的打开/关闭状态，该方法在使用setVisible(false)方法将控件按钮隐藏之后十分有用。

事件：

事件名称	最后更新版本	参数	说明
mouseup		(point 说　明：用户标注点的NTU坐标类　型：LTPoint )	在用户每完成一次标注时触发范例：设置标注控件的图标范例：标注控件的使用

返回顶部

代表地图上的一个标记，用来在指定的地理点显示一个图标；
注意:因为LTMarker继承了LTMapText,因此，拥有LTMapText的所有属性，方法和事件，以下只列出了LTMarker专有的方法!

构造函数：

函数名称	最后更新版本	返回值类型	说明
LTMarker(point 说　明：标记所指向的地理点坐标类　型：LTPoint ,icon 说　明：显示标记所使用的图标对象类　型：LTIcon )		LTMarker	创建一个LTMarker标记范例：给标记(marker)自定义图标范例：在指定标记(marker)处显示信息浮窗范例：根据地图的视图选择性的显示标记范例：向地图上添加标记范例：在地图初始化之前向地图上添加标记

方法：

函数名称	最后更新版本	返回值类型	说明
getIcon()	2.11	LTIcon	返回marker使用的图标对象
setIconImage(url 类　型：String )		无	设置标记所使用的图标的URL地址

返回顶部

鹰眼地图控件，用来直接在地图上显示一个鹰眼地图。

构造函数：

函数名称

最后更新版本

返回值类型

说明

LTOverviewMapControl(direction?,size?,point?,zoom?,zoomAdd?,padding?)

2.12

LTOverviewMapControl

创建一个LTOverviewMapControl控件

范例：使用鹰眼地图控件

范例：使用视图座标不变的鹰眼地图

范例：设置鹰眼地图上导航标志(矩形框)的大小

范例：自定义鹰眼地图的位置

方法：

函数名称	最后更新版本	返回值类型	说明
setLeft(length 类　型：Number )		无	设置控件相对于地图左边的像素距离
setRight(length 类　型：Number )		无	设置控件相对于地图右边的像素距离
setTop(length 类　型：Number )		无	设置控件相对于地图上方的像素距离
setBottom(length 类　型：Number )		无	设置控件相对于地图下方的像素距离
setVisible(booleans 类　型：Bool )		无	设置控件在地图上是否可见
setOpacity(opacity 说　明：不透明度,范围从0到1，该数字越小越透明类　型：Number )		无	设置地图的显示不透明度
setButtonImage(img1 说　明：鹰眼地图在打开状态下的按钮图片类　型：String ,img2 说　明：鹰眼地图在关闭状态下的按钮图片类　型：String )	2.10	无	设置鹰眼地图的按钮图片，应该同时设置鹰眼地图打开和关闭状态下的两张图片范例：自定义鹰眼地图的外观
setBorderColor(color 说　明：鹰眼地图和主地图之间空隙的边框颜色类　型：String )	2.10	无	设置鹰眼地图和主地图之间空隙的边框颜色范例：自定义鹰眼地图的外观
setBackColor(color 说　明：鹰眼地图和主地图之间空隙的背景颜色类　型：String )	2.10	无	设置鹰眼地图和主地图之间空隙的背景颜色范例：自定义鹰眼地图的外观
setRectBorderColor(color 说　明：鹰眼地图上的矩形框边框颜色类　型：String )	2.10	无	设置鹰眼地图上的矩形框边框颜色范例：自定义鹰眼地图的外观
setRectBackColor(color 说　明：鹰眼地图上的矩形框背景颜色类　型：String )	2.10	无	设置鹰眼地图上的矩形框背景颜色范例：自定义鹰眼地图的外观
changeView()	2.10	无	切换鹰眼地图的开-合状态
isOpen()	2.10	Bool	返回该鹰眼的视图是否被打开
getMiniMap()	2.12	LTMaps	返回该鹰眼的地图对象，利用本对象，即可向鹰眼地图上添加的标注

事件：

事件名称	最后更新版本	参数	说明
viewchange		(isOpen 说　明：状态变化后鹰眼地图是否在打开的状态中类　型：Bool )	鹰眼视图控件的开合状态变化时触发

返回顶部

代表地名列表之中的一个地名，不能构造，只能从LTPlaceList的搜索结果之中返回

方法：

函数名称	最后更新版本	返回值类型	说明
getName()	2.13	String	返回名称字符串，如“北京”
getParent()	2.13	LTPlace	返回根级节点，如果已经是根级节点，则返回null
getPinyin()	2.13	String	返回地名对应的拼音代码，如果没有该数据，则返回null
getChildren()	2.13	地名LTPlace数组	返回该节点的子节点列表
getPoint()	2.13	LTPoint	返回地名的坐标，如果没有该坐标，则返回null
canLocalSearch()	2.13	String	返回地名是否支持51ditu本地搜索服务，有以下四种返回结果： "self":支持，例如"北京" "parent":不支持，不过其上级节点支持，例如"北京市东城区" "child":不支持，不过有一个以上的下级节点支持，例如在"湖北省" "none":完全不支持
canBusSearch()	2.13	String	返回地名是否支持51ditu公交查询服务，有以下四种返回结果： "self":支持，例如"北京" "parent":不支持，不过其上级节点支持，例如"北京市东城区" "child":不支持，不过有一个以上的下级节点支持，例如在"湖北省" "none":完全不支持

返回顶部

地名列表对象，包含一个树形结构的简单行政区划列表，目前大部分地方地名显示到地级行政区划，请注意，本列表之中的地名数仅仅是一个简单的地名示意数据，用来根据地名名称进行定位。考虑到节省内存，请不要使用LTPlaceList得构造函数，请使用LTPlaceList.getDefault()静态方法来获取LTPlaceList的实例。

静态方法：

函数名称	最后更新版本	返回值类型	说明
getDefault()	2.13	LTPlaceList	返回默认的地名列表

方法：

函数名称	最后更新版本	返回值类型	说明
getPoint(word 说　明：搜索关键字，可以为某个地点的名称、拼音等类　型：String )	2.13	LTPoint	在城市列表之中搜索指定的字符串，并返回搜索结果第一项的点坐标，如果没有搜索到结果，则返回null
getRootPlace()	2.13	LTPlace	返回地名列表的根地名，即为全国节点
searchPlace(word 说　明：搜索关键字，可以为某个地点的名称、拼音等类　型：String ,num? 说　明：最大返回的搜索结果数，如果为0，则为返回所有结果类　型：Number 默认值：0 ,node? 说　明：指定只搜索指定节点和其子节点类　型：LTPlace 默认值：根节点，全国 )	2.13	地名LTPlace数组	在城市列表之中搜索指定的字符串，并返回指定数目的最大搜索结果数组

返回顶部

代表地图上的一个多边形形状，在IE之中，将会使用VML的技术来绘制多边形，因此必须在页面上加载VML的命名空间，在其他浏览器之中，将会使用普通的画线技术，值得注意的是：由于多边形存在背景，因此绘制的过程之中没有使用和折线一样的切割技术，这样一个本来很小的多边形在地图放大之后可能成为一个非常大的多边形，从而引起性能上的问题。

构造函数：

函数名称	最后更新版本	返回值类型	说明
LTPolygon(points 说　明：用来绘制多边形的顶点数组类　型：点坐标LTPoint数组 ,color? 说　明：多边形的显示颜色类　型：String 默认值：blue ,bgcolor? 说　明：多边形的显示背景颜色类　型：String 默认值：#99FFCC ,weight? 说　明：多边形的边框显示线宽,以像素为单位类　型：Number 默认值：3 ,opacity? 说　明：多边形的显示不透明度，范围为0-1,越小代表越透明类　型：Number 默认值：0.5 )		LTPolygon	使用指定的一组地理点坐标，创建一个LTPolygon多边形

方法：

函数名称	最后更新版本	返回值类型	说明
setPoints(points 说　明：用来绘制多边形的点数组类　型：点坐标LTPoint数组 )		无	设置多边形的点数组，实际上将使折线成为另一个多边形.
getLineColor()	2.11	String	获得多边形的边框颜色
setLineColor(color 说　明：多边形的显示颜色类　型：String )		无	设置多边形的显示颜色.
getFillColor()	2.11	String	获得多边形的背景填充颜色
setFillColor(color 说　明：多边形的显示背景色类　型：String )		无	设置多边形的显示背景色.
getOpacity()	2.11	Number	获得多边形的显示不透明度
setOpacity(opacity 说　明：多边形的显示不透明度，范围为0-1,越小代表越透明类　型：Number )		无	设置多边形的显示不透明度.
getLineStroke()	2.11	Number	获得多边形的显示线宽
setLineStroke(weight 说　明：多边形的显示线宽,以像素为单位类　型：Number )		无	设置多边形的显示线宽.
getLineStyle()	2.13	String	获得折线的显示线型
setLineStyle(style 说　明：折线的显示线型类　型：String )	2.13	无	设置折线的显示线型,有以下几种类型：Solid(实线，默认值)、ShortDash(虚线)、ShortDot、ShortDashDot(点划线)、ShortDashDotDot、Dot、Dash、LongDash、DashDot、LongDashDot、LongDashDotDot，注意该方法对FireFox无效

事件：

事件名称	最后更新版本	参数	说明
click	2.11	(point 说　明：鼠标的位置相对于地图左上角的像素坐标，point[0]代表横向距离，point[1]代表纵向距离，如果要转化为地理坐标，请使用LTMaps的getPointLatLng方法转化为地理NTU经纬度类　型：Array )	在用户点击多边形时触发
mouseover	2.11	(point 说　明：鼠标的位置相对于地图左上角的像素坐标，point[0]代表横向距离，point[1]代表纵向距离，如果要转化为地理坐标，请使用LTMaps的getPointLatLng方法转化为地理NTU经纬度类　型：Array )	鼠标在多边形上时触发
mouseout	2.11	(point 说　明：鼠标的位置相对于地图左上角的像素坐标，point[0]代表横向距离，point[1]代表纵向距离，如果要转化为地理坐标，请使用LTMaps的getPointLatLng方法转化为地理NTU经纬度类　型：Array )	鼠标离开多边形上方时触发

返回顶部

测面积控件，用来测量地图上的面积，同时也可以通过事件来获取用户绘制的多边形，因此也可以作为多边形绘制工具使用

构造函数：

函数名称	最后更新版本	返回值类型	说明
LTPolygonControl(showLabel? 说　明：是否显示面积，如果不显示面积，将可以很好的作为画面控件使用类　型：Bool 默认值：true )		LTPolygonControl	创建一个LTPolygonControl控件范例：测面控件的使用

静态方法：

函数名称	最后更新版本	返回值类型	说明
getPointsArea(points 类　型：点坐标LTPoint数组 )		Number	计算一系列地理点组成的多边形面积

方法：

函数名称	最后更新版本	返回值类型	说明
setLeft(length 类　型：Number )		无	设置控件相对于地图左边的像素距离
setRight(length 类　型：Number )		无	设置控件相对于地图右边的像素距离
setTop(length 类　型：Number )		无	设置控件相对于地图上方的像素距离
setBottom(length 类　型：Number )		无	设置控件相对于地图下方的像素距离
setVisible(booleans 类　型：Bool )		无	设置控件在地图上是否可见
setOpacity(opacity 说　明：不透明度,范围从0到1，该数字越小越透明类　型：Number )		无	设置控件的显示不透明度
setLabel(text 说　明：按钮的文本类　型：String )		无	设置控件的按钮文字，默认为："测面"
setTips(text 说　明：文本内容类　型：String )	2.09	无	设置绘制时跟随鼠标的文字提示的内容范例：双击结束测距控件范例：双击结束测面控件
btnClick()		无	模拟控件的按钮被点击，每运行一次该方法，相当于点击一次控件的按钮切换该控件的打开/关闭状态，该方法在使用setVisible(false)方法将控件按钮隐藏之后十分有用。
endDraw()	2.09	无	完成一个多边形的绘制，运行此方法相当于用户点击右键结束当前多边形的绘制。范例：双击结束测距控件范例：双击结束测面控件

属性：

属性名称