51地图地图参考类.docx
《51地图地图参考类.docx》由会员分享，可在线阅读，更多相关《51地图地图参考类.docx（99页珍藏版）》请在冰豆网上搜索。
51地图地图参考类
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|LTExpandMaptext
类LTPoint
代表地理点坐标，该点的位置通过灵图的NTU坐标来描述。
构建函数
函数名称
最后更新版本
返回值类型
说明
LTPoint（lng,Lat）
LTPoint
以指定的NTU经度和纬度创建一个地理点坐标
配置方法
函数名称
最后更新版本
返回值类型
说明
getLongitude（）
Number
获取NTU经度
getLatitude（）
Number
获取NTU经度
类LTEvent
51dituJavaScriptAPI之中用来进行事件处理的类，该类的所有方法都是静态方法，因此不需要构造该类的实例而直接使用方法即可，例如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
代表一个矩形地理区域的对象，例如地图当前显示的地理范围
构造函数
函数名称
最后更新版本
返回值类型
说明
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）指定
类LTEllipse
代表地图上的一个椭圆形状，在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
椭圆绘制控件，用来让用户绘制一个椭圆，同时也可以通过事件来获取用户绘制的椭圆信息。
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
）
用户每次完成一次椭圆绘制时触发
类LTFunction
51dituMapsAPI之中的公用函数类，包含一些常用的函数，该类的所有方法都是静态方法，因此不需要构造该类的实例而直接使用方法即可，例如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
一个地图控件，用来将指定的层显示到地图上，用来让用户往地图上方便地添加自定义的内容
构造函数
函数名称
最后更新版本
返回值类型
说明
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
用来显示到地图上的一个图标对象
构造函数
函数名称
最后更新版本
返回值类型
说明
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图标的复制和使用
类LTInfoWindow
地图上的信息浮窗对象，该对象可以初始化，也可以使用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
无
当信息浮窗被关闭时触发
范例：
鼠标移动到标注上显示信息浮窗
类LTMaps
51dituMapsAPI的核心对象，每个实例代表页面上的一幅地图
构造函数
函数名称
最后更新版本
返回值类型
说明
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（）
像素
升级会员 