天地图服务二次开发调用操作指南V1.3

天地图·服务调用操作手册

目天图市...........................................................................................................................3瓦地切参....................................................................................................................2.7

数据范围3电子地图分4坐标系6瓦片大小6屏幕分辨率切图原点6瓦片存储格73

网地瓦服接（WMTS务..................................................................................73.13.2

服务描述7服务操作73.3

ETC

操作.8

操作简介.........................................................................................................................8参数说明.........................................................................................................................8调用示例.........................................................................................................................8返回结果示.................................................................................................................83.4GTILE操作93.5

操作简介.........................................................................................................................9参数说明.........................................................................................................................9调用示例.......................................................................................................................10返回结果示...............................................................................................................10示例代码1

平台API

调用例子JavaScript..................................................................................1ArcGISJavasciptAPI

调用例........................................................................................1

C#-AE版............................................................................................................................1用信...................................................................................................................................1用服信............................................................................................................................15.15.2

XX市矢量电子地图1XX市影像电子地图26

技对联人........................................................................................................................1地图·XX面向公众的“XX市之窗”是“天地图”市级节点，依XX市市最新最权威的基础地理信息构建统一的在线地图服务平台提供电子地图浏览信息点分类搜索定位、XX市景点查看、距离和面积量算、兴趣点标注、公交路线规划等功能主要包括电子地图新闻公告资源中心我的空间典型应用标准规范、开发中心模块，以门户网站和服务接口两种形式提供24小时不间断的“一站式”地图服务满足公众对位置查询等方面的需求满足企业和专业用户基于地图服务和二次开发接口开展专业应用的需求。天地图XX地址：http://XX平台用户可登录天地图XX市，浏览电子地图模块同时可在资源中心查看已有的服务资源用户如有需要相关的服务，可在线进行申请管理员审批同意后，即可获得服务资源地址。根据实际情况，在客户端进行调用访问。平台应用单位一般情况下，初次使用都由平台运维队伍进行用户注册、服务申请等操作。后续服务平台应用单位可自行登录天地图进行服务申请。瓦片地图切图参数2.1数范围资名矢量电子地图影像电子地图

数范及示别全市域显示1-16显示）平方公里（级示）全市域显示1-17显示）平方公里（级示）

对数：50000DLG1数：10000DLG数：数：数据图2-1矢量电子地17-20级数据围图2-2影像电子地17-20级数据围2.2电地图分级天地图XX市电子地图级别：1-20级。第8级比例尺下全图范围（显示全XX市市下是全图范围的坐标值：::表1天地电地显级与示例照级

地分（米/素面辨度/像）

显比

78,271.517039,135.758519,567.87929,783.93964,891.96982,445.98491,222.9925611.4962305.7481152.874176.437038.218519.10939.55464.77732.38871.19430.59720.2986

0.7031250.35156250.175781250.0878906250.04394531250.021972656250.0109863281250.0013732910156258.58306884765625E-5

1:295,497,593.058750031:147,748,796.529375021:73,874,398.2646875081:36,937,199.1323437541:18,468,599.5661718771:9,234,299.78308593851:4,617,149.89154296931:2,308,574.94577148461:1,15,4287.47288574231:577,143.736442871161:288,571.868221435581:144,285.934110717791:72,142.9670553588951:36,071.4835276794471:18,035.7417638397241:9,017.87088191986191:4,508.93544095993091:2,254.46772047996551:1,127.233860239982720

0.1493

1:563.61693011999137地图等配置信息{"level":"resolution":"scale":},{"level":"resolution":0.3515625,"scale":147748796.52937502{"level":"resolution":0.17578125,"scale":73874398.264687508{"level":"resolution":0.087890625,"scale":36937199.132343754{"level":"resolution":0.0439453125,"scale":18468599.566171877{"level":"resolution":0.02197265625,"scale":9234299.7830859385{"level":"resolution":0.010986328125,"scale":4617149.8915429693{"level":"resolution":0.0054931640625,"scale":2308574.9457714846{"level":"resolution":0.00274658203125,"scale":1154287.4728857423{"level":"resolution":0.001373291015625,"scale":577143.73644287116{"level":"resolution":0.0006866455078125,"scale":288571.86822143558{"level":"resolution":0.00034332275390625,"scale":144285.93411071779{"level":"resolution":0.000171661376953125,"scale":72142.967055358895{"level":"resolution":8.58306884765625E-5,"scale":36071.483527679447},{"level":"resolution":4.2915344238281264E-5,"scale":18035.741763839724},{"level":"resolution":2.14576721191406E-05,"scale":9017.8708819198619},{"level":"resolution":1.0728836059570316e-005,"scale":4508.9354409599309{"level":"resolution":5.3644180297851579e-006,"scale":2254.4677204799655{"level":"resolution":2.682209014892579e-006,"scale":1127.2338602399827{"level":"resolution":1.3411045074462895e-006,"scale":563.616930119991372.3坐系GCS_China_Geodetic_Coordinate_System_20002.4瓦片小256像素*256像素；2.5屏幕辨率96DPI；2.6切图点瓦片切图的起始点为（-180，90向东向南行列递增；2.7瓦片储格式PNG格式。网络地图瓦片服务接口（服务）目前平台与应用单位对接时，应用最广的是网络瓦片地图服务接口WMTS平台提供的矢量电子地图以及影像电子地图都属于此类型服务此将详细介绍此服务类型的调用参数及实现方法。3.1服描述WebMapTileService（网络地图瓦片服务称WMTS，由开放地理信息联盟（GeoSpatialConsortium）指定，采协议，通过指定的参数返回相应的地图瓦片，该瓦片通常已在服务端预先按照规定格式生成。3.2服操作WMTS服务支持访问，其接口包括、GetTile和GetFeatureInfo3个操作，这些操作允许用户访问切片地图。操GetCapabilitiesGetTileGetFeatureInfo

操强制实现强制实现选择实现

描获取的力文档（即元数文档），里面包含服务的所有信息获取地图瓦片。该操作根据客户端发出的请求参数在服务端进行检索，服务器端返回地图瓦片图像。通过在WMTS图上指定一定的条件指定的地图瓦片内容对应的要素信息3.3GetCapabilities操作操作简介本操作返回描述服务所关联的数据集的基本描述信息数据集类型围、瓦片分块基本规则等。参数说明参名serviceacceptVersionsupdateSequence

参个1个必选)1个必选)0或1个可选0或1个可选0或1个可选0或1个可选

参类和字符类型，服务类型值为“”字符类型，请求的操作名称，值“GetCapabilities”字符类型，值为请求的WMTS的本号字符类型元数据文档0或个节的名称，多个名称之间用开不按顺序排列值为空默认返回整个元数据文档字符类型，值为，空时默认返回最新的元数据文档MIME类，值为服务元数据的输出格式调用示例返回结果示例返回结果为对服务基本能力的描述的XML3.4GetTile操作操作简介本操作返回一张图片地理空间参考和大小等参数是由用户请求明确定义的。参数说明参名serviceversionformattileMatrixtileCol

参个1个必选)1个必选)1个必选)1个必选)1个必选)1个必选)1个必选)1个必选)1个必选)1个必选)

参类和字符类型，服务类型标识值为“”字符类型，请求的操作值“GetTile”字符类型，值为请求的WMTS的本号字符类型，值为请求的图层名称字符类型，值为请求图层的渲染样式字符类型，值为瓦片地图的输出格式字符类型，瓦片矩阵数据集，其值在服务的元数据文档中指定字符类型，瓦片矩阵，其值在服务的元数据文档中指定整型类型，值为大于0的数，表示瓦片矩阵的行号整型类型，值为大于0的数，表示瓦片矩阵的列号sampleons调用示例

0或1个(可选

字符类型，其他允许的参数返回结果示例3.5示代码平台调用例（JavaScript<!DOCTYPEPUBLIC"-//W3C//DTDXHTMLTransitional//EN"<htmlxmlns="/1999/xhtml"><metacontent="text/html;charset=utf-8"/>地展示<styletype="text/css">{500px;width:border:solidtext-align:}<bodyclass="content"></div>src="/CDMapJS/DCIMapAPI.ashx"></script>type="text/javascript">functionvar=DCIMapConfig.mapInitParams);创一个地图实//载地图var=TileLayer("/ServiceAdapter/Map/CDJC_Map_2000_WMTS",{tokens:});创建一个地图图层0);将图层赋给地图var=newesri.geometry.Extent(108.82329953710938,wkid:}));map.setExtent(newExtent);}</script></html>ESRIArcGISJavascipt调用例<!DOCTYPEhtmlPUBLIC"-//W3C//DTDHTML4.01//EN""/TR/html4/strict.dtd"><html<head>content="text/html;http-equiv="X-UA-Compatible"content="IE=7,IE=9"<!--Theviewportmetatagimprovepresentationandbehaviorofsamplesdevices-->name="viewport"maximum-scale=1,user-scalable=no"/><title>WMTS</title><scriptsrc="/CDMapJS/ArcGisAPI.ashx?v=3.4&style=claro"></script>{width:100%;margin:0;}.esriScalebar{padding:#map{padding:0;}#citationInfo{position:absolute;color:black;font-weight:bold;font-size:12pt;left:10px;bottom:10px;z-Index:999;}<scriptdjConfig={parseOnLoad:<scripttype="text/javascript">dojo.require("esri.map");dojo.require("dijit.layout.BorderContainer");{initLayer();varnewesri.geometry.Extent(108.5417866410281,114.5140605129184,30.58389737413586,esri.SpatialReference({wkid:4490}));var={extent});var'onLoad',{dojo.connect(dijit.byId('map'),'resize',});ogc.WMTSLayer());}initLayer(){dojo.declare("ogc.WMTSLayer",esri.layers.TiledMapServiceLayer,{function(){=newesri.SpatialReference({wkid:4490});this.initialExtent=newesri.geometry.Extent(108.5417866410281,27.79023703627188,30.58389737413586,this.fullExtent=esri.geometry.Extent(108.5417866410281,27.79023703627188,114.5140605129184,30.58389737413586,this.tileInfo=newesri.layers.TileInfo({"96","format":"image/png",{"wkid":"4490"},"rows":"cols":256,{"x":-180,"y":},"lods":[{"level":0,"resolution":},295829355.44999999,"resolution":},{"level":147914677.72999999,"resolution":},{"level":73957338.859999999,"resolution":},{"level":"resolution":},{"level":18489334.719999999,"resolution":},{"level":9244667.3599999994,"resolution":},{"level":4622333.6799999997,"resolution":},{"level":2311166.8399999999,"resolution":},{"level":1155583.4199999999,"resolution":},{"level":577791.70999999996,"resolution":},{"level":288895.84999999998,"resolution":},{"level":144447.92999999999,"resolution":},{"level":72223.960000000006,"resolution":},{"level":36111.980000000003,"resolution":8.5927048253322974e-005},{"level":18055.990000000002,"resolution":4.2963524126661487e-005},{"level":9028,"resolution":},{"level":4514,"resolution":},{"level":2257,"resolution":},{"level":"resolution":2.6852217450794713e-006},{"level":"resolution":1.3426108725397357e-006}]});this.onLoad(this);},getTileUrl:function(level,row,{"/ServiceAdapter/Map/CDJC_Map_2000_WMTS/c50b915b07288dbbe50f1b65f8e38723"+"?SERVICE=WMTS&VERSION=1.0.0&REQUEST=GetTile"++"&STYLE=default""&FORMAT=image/png"+"&TILEMATRIXSET=sss"+"&TILEMATRIX="++row++col;}});}dojo.addOnLoad(init);</script><bodyclass="claro"><divdesign="headline"gutters="false"style="width:100%;height:margin:0;"><divid="map"></div></div></html>C#-AE版///<summary>///添WMTS服///</summary>///<param服voidAddWmtsLayer(stringurl){IPropertySet=newPropertySet();url);IWMTSConnectionNamepWmsConnectionName=newWMTSConnectionName();pWmtsConnectionName.ConnectionProperties=ILayerFactorypLayerFactory=newEngineWMTSMapLayerFactory();pWmtsMapLayerasIDataLayer;IWMTSServiceDescription=for(inti=0;i<i++){=pWmtsServiceDesc.get_LayerDescription(i);=null;if(pWmtsLayerDesc.LayerDescriptionCount0){IWMTSLayer=pWmtsLayeras}{pWmtsMapLayer.CreateWMTSGroupLayers(pWmtsLayerDesc);for(intj=0;j<pWmtsGroupLayer.Count;j++){layer=pWmtsGroupLayer.