2022年天地图JavaScriptAPI接口说明实用 .pdf
《2022年天地图JavaScriptAPI接口说明实用 .pdf》由会员分享,可在线阅读,更多相关《2022年天地图JavaScriptAPI接口说明实用 .pdf(42页珍藏版)》请在淘文阁 - 分享文档赚钱的网站上搜索。
1、JavaScript API接口文档V2.0 天地图有限公司2013 年 3 月名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 1 页,共 42 页 - - - - - - - - - 天地图有限公司文档说明本文档包含所有的内容除说明以外,版权均属天地图有限公司所有,受中华人民共和国著作权法保护及相关法律法规和中国加入的所有知识产权方面的国际条约的保护。未经本公司书面许可,任何单位和个人不得以任何方式翻印和转载本文档的任何内容,否则视为侵权,天地图有限公司保留已发追究其法律责任的权利
2、。本文档是天地图Java Script API的用户使用参考手册, 详细阐述了 API 提供用户的类和方法,以及可以实现的功能介绍。天地图Java Script API 让您可以将地图嵌入您自己的网页中。 API 提供了许多方法与地图进行交互,以及一系列向地图添加内容的服务,从而使您可以在自己的网站上创建稳定的地图应用程序。本文档分为地图主类、控件类、工具类、叠加物、右键菜单类、实体类、事件类7 个大章节。以类(描述、属性、构造函数、方法)为索引讲述接口用法。用户在阅读下面的文档时, 可以根据需求对文档进行查询或跳跃式阅读。从而更好地应用 API 类服务于自己的领域。名师资料总结 - - -精
3、品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 2 页,共 42 页 - - - - - - - - - 天地图有限公司JavaScript API 整体概要设计API 接口基本结构图API 接口类基本关系图名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 3 页,共 42 页 - - - - - - - - - I 目录JavaScript API接口文档V2.0 .I JavaScript API
4、 整体概要设计 .II 1 地图主类 . 5 1.1 TMap 类 . 5 1.1.1 构造函数 . 5 1.1.2 配置方法 . 5 1.1.3 地图状态方法 . 5 1.1.4 修改地图状态方法. 6 1.1.5 坐标变换 . 6 1.1.6 覆盖物方法 . 7 1.1.7 控件. 7 1.1.8 地图图层方法 . 7 1.1.9 事件方法 . 8 1.2 TMapOptions 类 . 8 1.2.1 属性. 9 1.3 TMapTypeOptions 类 . 9 1.3.1 属性. 9 1.4 TMapType 类 . 9 1.4.1 构造函数 . 9 1.4.2 方法. 9 1.4.
5、3 常量. 10 1.5 TTileLayer 类 . 10 1.5.1 构造函数 . 10 1.5.2 方法. 10 1.5.3 事件.11 1.6 TTileLayerOptions类 .11 1.6.1 属性.11 2 控件类 .11 2.1 TControl 类 .11 2.1.1 方法. 12 2.2 TNavigationControlOptions类 . 12 2.2.1 属性. 12 2.3 TNavigationControl类 . 13 2.3.1 构造函数 . 13 2.4 TOverviewMapControlOptions类. 13 2.4.1 属性. 13 2.5
6、TOverviewMapControl类 . 13 2.5.1 构造函数 . 13 2.5.2 方法. 14 2.5.3 事件. 14 2.6 TScaleControl 类 . 14 2.6.1 构造函数 . 14 2.6.2 方法. 14 2.7 TCopyrightControl类 . 14 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 4 页,共 42 页 - - - - - - - - - II 2.7.1 方法. 15 2.8 TCopyright类 . 15 2.8.
7、1 属性. 15 2.9 TMapTypeOptions 类 . 15 2.9.1 属性. 15 2.10 TMapTypeControl类. 15 2.10.1 构造函数 . 15 3 工具类 . 16 3.1 TMarkToolOptions类 . 16 3.1.1 属性. 16 3.2 TMarkTool类. 16 3.2.1 构造函数 . 16 3.2.2 方法. 16 3.2.3 事件. 17 3.3 TPolygonToolOptions类 . 17 3.3.1 属性. 17 3.4 TPolygonTool 类. 17 3.4.1 构造函数 . 17 3.4.2 方法. 17 3
8、.4.3 事件. 18 3.5 TPolylineToolOptions类 . 18 3.5.1 属性. 18 3.6 TPolylineTool 类 . 18 3.6.1 构造函数 . 19 3.6.2 方法. 19 3.6.3 事件. 19 3.7 TRectToolOptions 类. 19 3.7.1 属性. 19 3.8 TRectTool 类 . 20 3.8.1 构造函数 . 20 3.8.2 方法. 20 3.8.3 事件. 20 4 叠加物 . 20 4.1 TOverlay 类 . 20 4.1.1 属性. 21 4.1.2 方法. 21 4.2 TLabelOptions
9、 类. 21 4.2.1 属性. 21 4.3 TLabel 类. 22 4.3.1 构造函数 . 22 4.3.2 方法. 22 4.3.3 事件. 23 4.4 TMarkerOptions类 . 23 4.4.1 属性. 23 4.5 TMarker 类 . 24 4.5.1 构造函数 . 24 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 5 页,共 42 页 - - - - - - - - - III 4.5.2 方法. 24 4.5.3 事件. 25 4.6 TIcon
10、Options 类 . 25 4.6.1 属性. 26 4.7 TIcon 类 . 26 4.7.1 构造函数 . 26 4.7.2 方法. 26 4.8 TPolylineOptions类 . 26 4.8.1 属性. 26 4.9 TPolyline 类 . 27 4.9.1 构造函数 . 27 4.9.2 方法. 27 4.9.3 事件. 27 4.10 TPolygonOptions 类 . 28 4.10.1 属性 . 28 4.11 TPolygon 类 . 28 4.11.1 构造函数 . 28 4.11.2 方法 . 28 4.11.3 事件 . 29 4.12 TInfoWi
11、ndowOptions类 . 29 4.12.1 属性 . 29 4.13 TInfoWindow类 . 29 4.13.1 构造函数 . 29 4.13.2 方法 . 30 4.13.3 事件 . 30 4.14 TRectOptions 类 . 31 4.14.1 属性 . 31 4.15 TRect 类 . 31 4.15.1 构造函数 . 31 4.15.2 方法 . 31 4.15.3 事件 . 32 4.16 TCircleOptions 类 . 32 4.16.1 属性 . 32 4.17 TCircle 类 . 32 4.17.1 构造函数 . 32 4.17.2 方法 . 3
12、3 4.17.3 事件 . 33 4.18 TEllipseOptions 类 . 33 4.18.1 属性 . 33 4.19 TEllipse 类 . 34 4.19.1 构造函数 . 34 4.19.2 方法 . 34 4.19.3 事件 . 35 5 右键菜单类 . 35 5.1 TContextMenu 类 . 35 5.1.1 构造函数 . 35 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 6 页,共 42 页 - - - - - - - - - IV 5.1.2 方
13、法. 35 5.1.3 事件. 35 5.2 TMenuItem 类 . 35 5.2.1 构造函数 . 36 5.2.2 属性. 36 5.3 TContextMenuOptions类 . 36 5.3.1 属性. 36 6 实体类 . 36 6.1 TLngLat 类 . 36 6.1.1 构造函数 . 36 6.1.2 方法. 36 6.2 TBounds 类. 37 6.2.1 构造函数 . 37 6.2.2 方法. 37 6.3 TPixel 类 . 37 6.3.1 属性. 38 6.3.2 构造函数 . 38 6.3.3 方法. 38 6.4 TSize 类. 38 6.4.1
14、属性. 38 6.4.2 方法. 38 7 事件类 . 38 7.1 TEvent 类 . 38 7.1.1 静态方法 . 39 7.1.2 事件. 39 7.2 TEventListener 类 . 39 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 7 页,共 42 页 - - - - - - - - - 天地图有限公司5 1地图主类1.1 TMap 类此类是天地图地图API 的基础类,是地图实例化的基础函数。1.1.1构造函数构造函数说明TMap(container:Node
15、,config: TMapOptions)在指定的容器内创建地图实例,之后需要调用TMap.centerAndZoom() 方法对地图进行初始化。未进行初始化的地图将不能进行任何操作。cntainer 参数用于显示地图的 DIV 对象。config 参数用于初始化地图,具体设置请参考TMapOptions 。1.1.2配置方法方法返回值说明enableDrag()none 启用地图拖拽,默认启用。disableDrag()none 禁用地图拖拽。isDrag()boolean 是否启用地图拖拽,true 表示启用, false 表示禁止。enableHandleMouseScroll()non
16、e启用滚轮放大缩小,默认禁用。disableDragHandleMouseScroll() none禁用滚轮放大缩小。isHandleMouseScroll()boolean是否启用滚轮放大缩小,true 表示启用, false 表示禁止。enableDoubleClickZoom()none启用双击放大,默认禁止。disableDoubleClickZoom()none禁用双击放大。isDoubleClickZoom()none是否启用双击放大,true 表示启用, false 表示禁止。enableHandleKeyboard()none启用键盘操作,默认禁用。键盘的上、下、左、右键可连续
17、移动地图。同时按下其中两个键可使地图进行对角移动。PgUp、PgDn、 Home 和 End 键会使地图平移其1/2 的大小。+、-键会使地图放大或缩小一级。disableHandleKeyboard()none禁用键盘操作。isHandleKeyboard()none是否启用键盘操作,true 表示启用, false 表示禁止。enableInertia()none启用地图惯性拖拽,默认禁用。disableInertia()none禁用地图惯性拖拽。isInertia()none是否启用地图惯性拖拽,true 表示启用, false 表示禁止。setMapCursor(default:Str
18、ing, move:String)none设置鼠标在地图上的样式。参数cursor 应符合 CSS 的 cursor 属性规范。1.1.3地图状态方法方法返回值说明名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 8 页,共 42 页 - - - - - - - - - 天地图有限公司6 getBounds()TBounds返回地图可视区域,以地理坐标表示。getCenter()TLngLat返回地图当前中心点。getViewSize()TSize返回地图视图的大小,以像素表示。get
19、Zoom()number返回地图当前缩放级别。getZoomUnits()number返回当前地图中心点的比例尺,即一个像素代表的实际距离,单位为米。getViewport(view:Array) json 根据提供的地理区域或坐标获得最佳的地图视野,返回的对象中包含center 和 zoom 属性,分别表示地图的中心点和级别。1.1.4修改地图状态方法方法返回值说明centerAndZoom(lnglat:TLngLat,zoom:Number)none初始化定位地图。lnglat 参数指定地图的中心点地理坐标。zoom 参数指定地图的比例尺级别。panTo(lnglat:TLngLat,z
20、oom:Number)none将地图的中心点变换到指定的地理坐标,如果移动范围不大,则执行一个滑动过程, 如果同时指定了缩放等级,则同时滑动到指定的等级。panBy(position: TSize)none将地图缓动指定的像素单位,例如参数为new TSize(100,100) 则代表地图向右、下方向分别滑动100 个像素单位,参数为TSize(-100,0)代表地图向左滑动100 个像素单位。position 参数指定的滑动的像素。setCenterAtLngLat(lnglat:TLngLat)none将地图的中心点直接变换到指定的地理坐标,不执行滑动过程。setViewport(view
21、:Array) none 根据提供的坐标点数组设置地图视野,调整后的视野会保证包含提供的坐标点。setZoom(zoom:Number)none将视图缩放到指定的缩放等级,中心点坐标不变。zoomIn()none放大一级视图。zoomOut()none缩小一级视图。checkResize()none通知地图其容器大小已更改。在更改了容器对象的大小后调用此方法,以便地图能够调整自己适合于新的大小。setZoomLevels(lvs:Array)none设置地图有哪些缩放级别。 Lvs 参数指定地图等级范围。savePosition()none存储当前的地图位置和缩放级别,以便 returnToS
22、avedPosition ()调用。returnToSavedPosition ()none将地图重新定位到上次savePosition()保存的位置。1.1.5坐标变换方法返回值说明fromContainerPixelToLngLat(pixel: TPixel)TLngLat将地图上相对于container的像素坐标转化为地理坐标,参数是TPixel,返回值类型是TLngLat 。Pixel 参数是像素对象。fromLngLatToContainerPixel(lnglat: TLngLat)TPixel将地理坐标转化为地图上点的像素坐标,相对于container 左上角,参数是 TLng
23、Lat ,返回值是TPixel。fromLngLatToDivPixel(lnglat:TLngLat)TPixel类似于 fromLngLatToContainerPixel方法,将地理坐标转化为地图上点的像素坐标(此坐标相对于放置标注的层),自定义标注的时候会名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 9 页,共 42 页 - - - - - - - - - 天地图有限公司7 用到此方法,返回值是数组TPixel 对象。fromDivPixelToLngLat(pixel:T
24、Pixel)TLngLat将地图上点的像素坐标(此坐标相对于放置标注的层)转化为地理坐标,自定义标注的时候会用到此方法,返回值是TLngLat 对象。1.1.6覆盖物方法方法返回值说明addOverLay(overlay:OverLay) none 将覆盖物添加到地图中,一个覆盖物实例只能向地图中添加一次。removeOverLay(overlay:OverLay) none 从地图中移除覆盖物。如果覆盖物从未被添加到地图中,则该移除不起任何作用。clearOverLays()none 清除地图上所有覆盖物。1.1.7控件方法返回值说明addControl(control:Control) n
25、one 将控件添加到地图,一个控件实例只能向地图中添加一次。removeControl(control:Control) none从地图中移除控件。如果控件从未被添加到地图中,则该移除不起任何作用。getContainer() HTMLElement 返回地图的容器元素。当创建用户自定义控件时,需要自行实现Control.initialize() 方法,并将控件的容器元素添加到地图上,通过此方法可获得地图容器。1.1.8地图图层方法方法返回值说明getLayers()TTileLayer获取所有叠加层对象,可以自己判断需要移除哪些叠加层。addLayer(layer:TTileLayer)no
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 2022年天地图JavaScriptAPI接口说明实用 2022 天地 JavaScriptAPI 接口 说明 实用
限制150内