51ditu Maps API 类参考文档

51ditu Maps API 类参考文档2007-5-14 [更新到2.13]

本文档是灵图提供的51ditu maps api的类参考文档，更多详细的使用范例和说明请访问51ditu API开发文档,页面，API使用交流清访问51ditu产品论坛

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

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

静态方法：

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

返回顶部

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

静态方法：

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

返回顶部

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

构造函数：

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

方法：

函数名称	最后更新版本	返回值类型	说明
getLongitude()		数字	获取NTU经度
getLatitude()		数字	获取NTU纬度
setLongitude(lng 说　明：经度类　型：数字 )		无	设置NTU经度
setLatitude(lat 说　明：纬度类　型：数字 )		无	设置NTU纬度

返回顶部

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

构造函数：

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

静态方法：

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

方法：

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

返回顶部

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

构造函数：

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

方法：

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

事件：

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

返回顶部

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

构造函数：

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

方法：

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

返回顶部

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

构造函数：

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

方法：

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

返回顶部

一个地图控件，用来实时的显示地图的当前比例尺

构造函数：

函数名称	最后更新版本	返回值类型	说明
LTScaleControl()		LTScaleControl	创建一个LTScaleControl控件范例：设置比例尺控件样式

方法：

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

返回顶部

地图导航控件，LTSmallMapControl控件是LTStandMapControl没有加载缩放等级条的一种形式。

构造函数：

函数名称	最后更新版本	返回值类型	说明
LTStandMapControl(type? 说　明：导航控件的类型，一共有3种类型：0(默认)：显示移动按钮、缩放按钮和缩放等级条,等同于使用LTSmallMapControl控件；2:只显示缩放按钮。类　型：数字默认值：0 )	2.09	LTStandMapControl	创建一个LTStandMapControl控件范例：迷你缩放控件范例：标准导航控件范例：简易导航控件

方法：

函数名称	最后更新版本	返回值类型	说明
setLeft(length 类　型：数字 )		无	设置控件相对于地图左边的像素距离
setRight(length 类　型：数字 )		无	设置控件相对于地图右边的像素距离
setTop(length 类　型：数字 )		无	设置控件相对于地图上方的像素距离
setBottom(length 类　型：数字 )		无	设置控件相对于地图下方的像素距离
setVisible(booleans 类　型：布尔值 )		无	设置控件在地图上是否可见
setOpacity(opacity 说　明：不透明度,范围从0到1，该数字越小越透明类　型：数字 )		无	设置地图的显示不透明度
setZoomInImage(url 说　明：图片的URL地址类　型：字符串 )		无	设置放大按钮的图片
setZoomOutImage(url 说　明：图片的URL地址类　型：字符串 )		无	设置缩小按钮的图片
setZoomNodeImage(url 说　明：图片的URL地址类　型：字符串 )		无	设置缩放等级条的每一个等级显示的图片
setCursorImage(url 说　明：图片的URL地址类　型：字符串 )		无	设置缩放等级条游标的图片
setControlUpImage(url 说　明：图片的URL地址类　型：字符串 )		无	设置上移按钮的图片
setControlDownImage(url 说　明：图片的URL地址类　型：字符串 )		无	设置下移按钮的图片
setControlLeftImage(url 说　明：图片的URL地址类　型：字符串 )		无	设置左移按钮的图片
setControlRightImage(url 说　明：图片的URL地址类　型：字符串 )		无	设置右移按钮的图片
setRefreshImage(url 说　明：图片的URL地址类　型：字符串 )		无	设置"返回到最初视图"按钮的图片

返回顶部

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

构造函数：

函数名称

最后更新版本

返回值类型

说明

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

2.12

LTOverviewMapControl

创建一个LTOverviewMapControl控件

范例：使用鹰眼地图控件

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

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

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

方法：

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

事件：

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

返回顶部

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

构造函数：

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

方法：

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

事件：

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

返回顶部

一个地图控件，用来实现在地图上选择一个区域或绘制矩形的功能

构造函数：

函数名称	最后更新版本	返回值类型	说明
LTRectControl(color? 说　明：矩形框的边框颜色类　型：字符串默认值：#003366 ,bgcolor? 说　明：矩形框的背景颜色类　型：字符串默认值：#CCCCFF ,weight? 说　明：矩形框的边框宽度类　型：数字默认值：1 ,opacity? 说　明：矩形框的透明度,0-1 类　型：数字默认值：0.5 )	2.13 New!	LTRectControl	创建一个LTRectControl控件范例：在地图上绘制矩形

方法：

函数名称	最后更新版本	返回值类型	说明
setLeft(length 类　型：数字 )		无	设置控件相对于地图左边的像素距离
setRight(length 类　型：数字 )		无	设置控件相对于地图右边的像素距离
setTop(length 类　型：数字 )		无	设置控件相对于地图上方的像素距离
setBottom(length 类　型：数字 )		无	设置控件相对于地图下方的像素距离
setVisible(booleans 类　型：布尔值 )		无	设置控件在地图上是否可见
setOpacity(opacity 说　明：不透明度,范围从0到1，该数字越小越透明类　型：数字 )		无	设置控件的显示不透明度
setLabel(label 说　明：按钮文本内容类　型：字符串 )		无	设置控件的按钮文本，默认为“拉框查找”
btnClick()		无	模拟控件的按钮被点击，每运行一次该方法，相当于点击一次控件的按钮切换该控件的打开/关闭状态，该方法在使用setVisible(false)方法将控件按钮隐藏之后十分有用。
clear()	2.13 New!	无	清除所有该控件在地图上绘制的矩形图形。

属性：

属性名称	最后更新版本	值类型	说明
autoClear	2.13 New!	布尔值类　型：布尔值默认值：true	是否在退出时自动删除页面上绘制的图形
lineColor	2.13 New!	字符串类　型：字符串默认值：空，即使用默认线条颜色	默认绘制的线条颜色
fillColor	2.13 New!	字符串类　型：字符串默认值：空，即使用默认填充颜色	默认绘制的填充颜色
lineStroke	2.13 New!	数字类　型：数字默认值：空，即使用默认线宽	默认绘制的线条宽度
lineStyle	2.13 New!	数字类　型：数字默认值：空，即使用默认线条样式	默认绘制的线条样式
fillOpacity	2.13 New!	数字类　型：数字默认值：空，即使用默认透明度	默认绘制的透明度（0-1）

事件：

事件名称	最后更新版本	参数	说明
draw	2.13 New!	(bounds 说　明：用户拉框选择的地理范围类　型：LTBounds ,rect 说　明：用户最后绘制的矩形图形对象类　型：LTRect )	用户每次完成拉框操作时触发

返回顶部

LTZoomSearchControl目前使用LTRectControl实现，因此请参看LTRectControl文档,LTZoomSearchControl因为功能上的局限性建议不使用。

返回顶部

一个地图控件，用来实现拉框放大的功能
LTZoomInControl目前使用LTRectControl实现，因此请参看LTRectControl文档察看详细的方法和事件信息。

构造函数：

函数名称	最后更新版本	返回值类型	说明
LTZoomInControl(zoomAdd? 说　明：每次放大变化的等级数,例如填写-1,则实际上变为拉框缩小了类　型：数字默认值：1 )		LTZoomInControl	创建一个LTZoomInControl控件范例：拉框放大控件

返回顶部

测距控件，用来测量地图上的距离，同时也可以通过事件来获取用户绘制的折线，因此也可以作为折线绘制工具使用

构造函数：

函数名称	最后更新版本	返回值类型	说明
LTPolyLineControl(showLabel? 说　明：是否显示距离，如果不显示距离，将可以很好的作为画线控件使用类　型：布尔值默认值：true )		LTPolyLineControl	创建一个LTPolyLineControl控件

静态方法：

函数名称	最后更新版本	返回值类型	说明
getPointsDistance(points 类　型：点坐标LTPoint数组 )		数字	计算一系列地理点的距离总和，实际上就是一条折线的地理长度

方法：

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

属性：

属性名称	最后更新版本	值类型	说明
autoClear	2.11	布尔值类　型：布尔值默认值：true	是否在退出时自动删除页面上绘制的标注
lineColor	2.11	字符串类　型：字符串默认值：空，即使用折线的默认线条颜色	默认绘制的线条颜色范例：自定义画线控件的线条样式
lineStroke	2.11	数字类　型：数字默认值：折线的默认线宽	默认绘制的线条宽度范例：自定义画线控件的线条样式
lineOpacity	2.11	数字类　型：数字默认值：折线的默认透明度	默认绘制的透明度（0-1）范例：自定义画线控件的线条样式
lineStyle	2.11	字符串类　型：字符串默认值：折线的默认线型	默认绘制的线型范例：自定义画线控件的线条样式
lineArrow	2.11	数组类　型：数组默认值：折线的默认箭头	默认绘制的箭头,要求是一个数组，例如["None","None"] 范例：自定义画线控件的线条样式

事件：

事件名称	最后更新版本	参数	说明
draw	2.11	(points 说　明：用户最后绘制的折线的点坐标数组类　型：点坐标LTPoint数组 ,length 说　明：用户最后绘制的折线的地理长度类　型：数字 ,polyline 说　明：用户最后绘制的折线标记类　型：LTPolyLine )	用户每次敲右键完成一次折线绘制时触发

返回顶部

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

构造函数：

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

静态方法：

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

方法：

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

属性：