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

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

目录

1 2

天地图·XX市 ........................................................................................................................... 3 瓦片地图切图参数 .................................................................................................................... 3 2.1 2.2 2.3 2.4 2.5 2.6 2.7 3

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

网络地图瓦片服务接口（WMTS服务） .................................................................................. 7 3.1 3.2 3.3

服务描述 ................................................................................................................................. 7 服务操作 ................................................................................................................................. 7 GETCAPABILITIES操作 .................................................................................................................. 8

操作简介 ......................................................................................................................... 8

3.3.2 参数说明 ......................................................................................................................... 8 3.3.3 调用示例 ......................................................................................................................... 8 3.3.4 返回结果示例 ................................................................................................................. 8 3.4 GETTILE操作 ............................................................................................................................. 9 3.4.1 操作简介 ......................................................................................................................... 9 3.4.2 参数说明 ......................................................................................................................... 9 3.4.3 调用示例 ....................................................................................................................... 10 3.4.4 返回结果示例 ............................................................................................................... 10 3.5 示例代码 ................................................................................................................................. 1 3.5.1 平台API调用例子（JavaScript） .................................................................................. 1 3.5.2 ESRI ArcGIS Javascipt API调用例 ........................................................................................ 1 3.5.3 C#-AE版 ............................................................................................................................. 1

4 5

用户信息 ................................................................................................................................... 1 用户服务信息 ............................................................................................................................ 1 5.1 5.2 6

XX市市矢量电子地图 ............................................................................................................ 1 XX市市影像电子地图 ............................................................................................................ 2

3.3.1

技术对接联系人 ........................................................................................................................ 2

1 天地图·XX市

面向公众的“XX市之窗”是“天地图”市级节点，依据XX市市最新最权威的基础地理信息构建统一的在线地图服务平台，提供电子地图浏览、信息点分类搜索定位、XX市景点查看、距离和面积量算、兴趣点标注、公交路线规划等功能，主要包括电子地图、新闻公告、资源中心、我的空间、典型应用、标准规范、开发中心7个模块，以门户网站和服务接口两种形式提供24小时不间断的“一站式”地图服务，满足公众对位置查询等方面的需求，满足企业和专业用户基于地图服务和二次开发接口开展专业应用的需求。

天地图·XX市地址：http://XXmap.gov.cn

平台用户可登录天地图·XX市，浏览电子地图模块，同时可在资源中心查看已有的服务资源，用户如有需要相关的服务，可在线进行申请，管理员审批同意后，即可获得服务资源地址。根据实际情况，在客户端进行调用访问。

平台应用单位一般情况下，初次使用都由平台运维队伍进行用户注册、服务申请等操作。后续服务平台应用单位可自行登录天地图进行服务申请。

2 瓦片地图切图参数

2.1 数据范围

资源名称 矢量电子地图 数据范围及显示级别 全市域显示（1-16级显示） 623平方公里（17-20级显示） 影像电子地图 全市域显示（1-17级显示） 623平方公里（18-20级显示） 对应数据 1：50000DLG、1：10000数据 1：10000DLG数据 1：10000DOM数据 1：5000DOM数据

图 2-1矢量电子地图17-20级数据范围

图 2-2影像电子地图17-20级数据范围

2.2 电子地图分级

天地图XX市电子地图级别：1-20级。

第8级比例尺下全图范围（显示全XX市市），以下是全图范围的坐标值：

xmin : 108.5417866410281,

ymin : 27.79023703627188, xmax : 114.5140605129184, ymax : 30.58389737413586

表格 1 天地图电子地图显示级别与显示比例对照表 级别 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 地面分辨率（米/像素） 地面分辨率（度/像素） 78,271.5170 39,135.7585 19,567.8792 9,783.9396 4,891.9698 2,445.9849 1,222.9925 611.4962 305.7481 152.8741 76.4370 38.2185 19.1093 9.5546 4.7773 2.3887 1.1943 0.5972 0.2986 0.703125 0.3515625 0.17578125 0.087890625 0.0439453125 0.02197265625 0.010986328125 0.0054931640625 0.00274658203125 0.001373291015625 0.0006866455078125 0.00034332275390625 0.000171661376953125 8.58306884765625E-5 4.2915344238281264E-5 2.14576721191406E-05 1.0728836059570316e-005 5.3644180297851579e-006 2.682209014892579e-006 显示比例 1:295,497,593.05875003 1:147,748,796.52937502 1:73,874,398.264687508 1:36,937,199.132343754 1:18,468,599.566171877 1:9,234,299.7830859385 1:4,617,149.8915429693 1:2,308,574.9457714846 1:1,15,4287.4728857423 1:577,143.73644287116 1:288,571.86822143558 1:144,285.93411071779 1:72,142.967055358895 1:36,071.483527679447 1:18,035.741763839724 1:9,017.8708819198619 1:4,508.9354409599309 1:2,254.4677204799655 1:1,127.2338602399827

20

0.1493 1.3411045074462895e-006, 1:563.61693011999137 地图等级配置信息

{\{ \{ \{ \{ \{ \{ \{ \{ \{ \{ \{ \{ \{ \{ \{ \{ \{ \{ \{ \

2.3 坐标系

GCS_China_Geodetic_Coordinate_System_2000； 2.4 瓦片大小

256像素*256像素； 2.5 屏幕分辨率

96DPI； 2.6 切图原点

瓦片切图的起始点为（-180，90），向东向南行列递增；

2.7 瓦片存储格式

PNG格式。

3 网络地图瓦片服务接口（WMTS服务）

目前平台与应用单位对接时，应用最广的是网络瓦片地图服务接口（WMTS）。平台提供的矢量电子地图以及影像电子地图都属于此类型服务，因此将详细介绍此服务类型的调用参数及实现方法。

3.1 服务描述

Web Map Tile Service（网络地图瓦片服务），简称WMTS，由开放地理信息联盟（Open GeoSpatial Consortium，OGC）指定，采用HTTP协议，通过指定的参数返回相应的地图瓦片，该瓦片通常已在服务端预先按照规定格式生成。

3.2 服务操作

WMTS服务支持RESTful访问，其接口包括GetCapabilities、GetTile和GetFeatureInfo3个操作，这些操作允许用户访问切片地图。

操作 GetCapabilities 操作 强制实现 描述 获取WMTS的能力文档（即元数据文档），里面包含服务的所有信息 获取地图瓦片。该操作根据客户端发出的请求参数在服务端进行检索，服务器端返回地图瓦片图像。 通过在WMTS图层上指定一定的条件，返回指定的地图瓦片内容对应的要素信息 GetTile 强制实现 GetFeatureInfo 选择实现 3.3 GetCapabilities操作 3.3.1 操作简介

本操作返回描述服务所关联的数据集的基本描述信息，如数据集类型、范围、瓦片分块基本规则等。

3.3.2 参数说明

参数名称 service request acceptVersions 参数个数 1个(必选) 1个(必选) 0或1个(可选) 参数类型和值 字符类型，服务类型值为“WMTS” 字符类型，请求的操作名称，值为“GetCapabilities” 字符类型，值为请求的WMTS的版本号 字符类型，请求元数据文档0或多个节的名称，多个名称之间用“，”隔开，不须按顺序排列。值为空默认返回整个元数据文档 字符类型，值为increased，为空时默认返回最新的元数据文档 MIME类型，值为服务元数据的输出格式 sections 0或1个(可选) updateSequence acceptFormat

0或1个(可选) 0或1个(可选) 3.3.3 调用示例

http://XXmap.gov.cn/ServiceAdapter/Map/CDJC_Map_2000_WMTS/c50b915b07288dbbe50f1b65f8e38723?service=WMTS&request=getcapabilities

3.3.4 返回结果示例

返回结果为对服务基本能力的描述的XML。

3.4 GetTile操作 3.4.1 操作简介

本操作返回一张图片，其地理空间参考和大小等参数是由用户请求明确定义的。

3.4.2 参数说明

参数名称 service request version layer style format tileMatrixSet 参数个数 1个(必选) 1个(必选) 1个(必选) 1个(必选) 1个(必选) 1个(必选) 1个(必选) 参数类型和值 字符类型，服务类型标识值为“WMTS” 字符类型，请求的操作值为“GetTile” 字符类型，值为请求的WMTS的版本号 字符类型，值为请求的图层名称 字符类型，值为请求图层的渲染样式 字符类型，值为瓦片地图的输出格式 字符类型，瓦片矩阵数据集，其值在服务的元数据文档中指定 字符类型，瓦片矩阵，其值在服务的元数据文档中指定 整型类型，值为大于0的整数，表示瓦片矩阵的行号 整型类型，值为大于0的整数，表示瓦片矩阵的列号 tileMatrix 1个(必选) tileRow 1个(必选) tileCol 1个(必选)

本文来源：https://www.bwwdw.com/article/gost.html