DB37/T 2761.3-2016 地理信息公共服务平台技术规范 第3部分：服务接口

ICS03.080.01

A00

DB37

山东省地方标准

DB37/T2761.3—2016

地理信息公共服务平台技术规范

第3部分：服务接口

2016-04-29发布2016-05-29实施

山东省质量技术监督局发布

DB37/T2761.3—2016

目次

前言II

1范围1

2规范性引用文件1

3术语和定义1

4地理信息服务访问方法描述3

5瓦片地图服务接口5

6动态地图服务接口8

7地名搜索服务接口9

8路径分析服务接口14

9空间查询服务接口16

10逆地理编码服务接口18

附录A（资料性附录）服务接口实例20

I

DB37/T2761.3—2016

前言

DB37/T2761《地理信息公共服务平台技术规范》分为3个部分：

——第1部分：线划电子地图；

——第2部分：框架数据；

——第3部分：服务接口。

本部分为DB37/T2761的第3部分。

本标准按照GB/T1.1—2009给出的规则起草。

本标准由山东省国土资源厅提出。

本标准由山东省信息标准化技术委员会归口。

本标准起草单位：山东省国土测绘院、山东省标准化研究院。

本标准主要起草人：相恒茂、高浠舰、孙久虎、张伟、李飞、李浩、韩海丰、梁玉才、叶梓、杨浚、

孟静涛、张存业、隗玉凯、张欣、张红卫。

II

DB37/T2761.3—2016

地理信息公共服务平台技术规范第3部分：服务接口

1范围

本标准规定了山东省地理信息公共服务平台发布的瓦片地图服务、动态地图服务、地名搜索服务、

路径分析服务、空间查询服务、逆地理编码服务等地理信息服务接口。

本标准适用于本省地理信息公共服务平台的研发、维护和应用。

2规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文

件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。

GB/T17694地理信息术语

GB/T30320地理空间数据库访问接口

CH/T9004地理信息公共平台基本规定

CH/Z9010地理信息公共服务平台地理实体与地名地址数据规范

CH/Z9011地理信息公共服务平台电子地图数据规范

3术语和定义

下列术语和定义适用于本文件，并参照GB/T17694。

3.1

地理信息数据

反映和描述自然地理要素或者地表人工设施的形状、大小、空间位置及其属性等信息的数据。

3.2

地理信息公共服务平台

实现在线地理信息服务所需的信息数据、服务功能及其运行支撑的总称。

3.3

Web服务

Internet分布式计算环境中提供基础功能的软件系统。

3.4

地理信息服务

面向空间信息处理的Web服务，主要功能包括空间信息的管理、查询、空间分析等。

1

DB37/T2761.3—2016

3.5

客户端IP地址

访问服务的用户计算机的IP地址。

3.6

可扩展标记语言

标准通用标记语言的子集，一种用于标记电子文件使其具有结构性的标记语言。

3.7

瓦片地图金字塔模型

一种多分辨率层次模型，从金字塔的底层到顶层，分辨率依次递减，但表示的地理范围不变。

3.8

瓦片地图

按照某种瓦片地图金字塔模型，预先生成的栅格图像集合。

3.9

动态地图

后台服务器利用矢量地理信息数据动态实时渲染而产生的地图。

3.10

轻量级的数据交换格式

一种轻量级的基于文本、易读的表示简单数据结构和关联数组的数据交换格式。

3.11

便携式网络图像格式

一种用于网络传输的无损数据压缩图像格式。

3.12

网络要素服务

一种互联网要素服务标准。

3.13

网络地图服务

一种互联网地图服务标准。

3.14

网络地图图块服务

2

DB37/T2761.3—2016

一种互联网地图图块服务标准。

3.15

网络切片地图服务

一种互联网地图瓦片服务标准。

3.16

地名地址要素服务

OGC一种互联网地名检索服务标准。

3.17

兴趣点

每个POI包含名称、类别、经度、维度四方面信息。

3.18

文本标记语言

开发地理空间联盟（OGC）制定的一种文本标记语言，用于表示矢量几何对象、空间参照系统及空

间参照系统间的转换。

4地理信息服务访问方法描述

4.1总体描述

4.1.1地理信息服务都被抽象为资源；每个地理信息服务对应一个唯一的资源标识符（URL网址）；

通过URL接口对地理信息服务进行访问。

4.1.2本标准规定了六大类地理信息服务，分别是瓦片地图服务、动态地图服务、地名搜索服务、路

径分析服务、空间查询服务、逆地理编码服务。服务分类参照CH/T9004。

4.1.3本标准中服务所涉及空间数据均采用2000国家大地坐标系（CGCS2000）。

4.2返回XML格式定义

4.2.1返回信息的通用XML格式定义

表1返回信息的通用XML格式描述

XML格式定义说明

<?xmlversion="1.0"encoding="UTF-8"?>表示文件版本及编码

<NewDataSetrecordCount="……"结果对象：表示返回数据集合结果数量

pageIndex="……"pageSize="……">返回数据集合是否分页及页面大小

<ShareServiceResult>返回数据集合对象元素

…

<ShareServiceResult>

</NewDataSet>

3

DB37/T2761.3—2016

4.2.2基本几何对象的定义

a)Point:

格式{POINTPOINT（<x><y>）}

如{POINT(117.2536.298)}

b)Line：

格式{LINESTING(<x><y>,……,<x><y>,……,<x><y>)}

如{LINESTING(117.136.33,117.836.55,117.22336.8)}

c)Polygon:

格式{POLYGON((<x><y>,……,<x><y>,……,<x><y>),(<x><y>,……,<x><y>,……,<x><

y>),……)}

如{POLYGON((117.136.33,117.836.55,117.22336.8))}

d)MultiPoint:

格式{MULTIPOINT(<x><y>,……,<x><y>,……,<x><y>)}

如{MULTIPOINT(117.136.33,117.836.55,117.22336.8)}

e)MultiPolygon:

格式{MULTIPOLYGON(((<x><y>,……,<x><y>,……,<x><y>),(<x><y>,……,<x><y>,……,<x><

y>)),((<x><y>,……,<x><y>,……,<x><y>)),……)}

如{MULTIPOLYGON(((11,51,55,15,11),(22,23,33,32,22)),((63,92,94,63)))

}

4.3返回JSON格式定义

4.3.1返回信息的通用JSON格式定义

表2返回信息的通用JSON格式描述

JSON格式定义说明

{

"status":"<ok|error>",表示访问是否成功

"rusult":{结果对象：返回数据集合对象或错误信息

…

}

}

4.3.2基本几何对象的JSON格式定义

a)Point:

格式{"x":<x>,"y":<y>}

如{"x":104.299,"y":30.63799}

b)Line:

格式{"vertices":[[<x>,<y>],……,[<x>,<y>]]}

如{"vertices":[[12,45],[23,34],[23,44]]}

c)Polyline:

格式{"paths":[[[<x>,<y>],……,[<x>,<y>]],……,[[<x>,<y>],……,[<x>,<y>]]]}

如{"paths":[[[12,32],[23,34]],[[12,35],[34,56]]]}

4

DB37/T2761.3—2016

d)LinearRing:

格式{"vertices":[[<x>,<y>],……,[<x>,<y>]]}

如{"vertices":[[12,45],[23,34],[23,44],[12,45]]}

e)Polygon:

格式{"rings":[[[<x>,<y>],……,[<x>,<y>]],……,[[<x>,<y>],……,[<x>,<y>]]]}

如{"rings":[[[12,32],[23,34],[34,34],[12,32]],

[[12,32],[23,34],[34,34],[12,32]]]}

f)MultiPoint:

格式{"points":[[<x>,<y>],……,[<x>,<y>]]}

如{"points":[[12,45],[23,34],[23,44]]}

g)MultiPolygon:

格式{"polygons":[[[[<x>,<y>],……,[<x>,<y>]],……,[[<x>,<y>],……,[<x>,<y>]]],…

…,[[[<x>,<y>],……,[<x>,<y>]],……,[[<x>,<y>],……,[<x>,<y>]]]]}

如{"polgyons":[[[[12,32],[23,34],[34,34],[12,32]],[[12,32],[23,34],[34,34],[12,32]

]],[[[12,32],[23,34],[34,34],[12,32]],[[12,32],[23,34],[34,34],[12,32]]]]}

h)BoundingBox:

格式:{"xMin":<xMin>,"yMin":<yMin>,"xMax":<xMax>,"yMax":<yMax>}

如{"xMin":12,"yMin":23,"xMax":34,"yMax":45}

4.4地理信息服务的访问步骤

4.4.1需授权地理信息服务访问步骤

对于需授权的地理信息服务(即需要用户认证的服务)，访问步骤如下：

a)身份认证并获取授权：通过平台注册用户申请相关服务资源，经审核通过后获取合法授权（用

户名密码或IP认证）

b)获取服务资源地址：通过平台获取地理信息服务资源访问地址；

c)构建加密服务资源的访问地址：在地理信息服务资源访问地址上加入username和password

输入参数，形式为“&username=<username>&password=password”，生成新的服务网址（经过

IP认证的用户可以直接访问）；

d)服务资源访问：通过加密的服务资源地址访问地理信息服务，取得返回结果。

4.4.2不需授权地理信息服务访问步骤

对于不需授权的地理信息服务，访问步骤如下：

a)获取服务资源地址：通过平台获取地理信息服务资源访问地址；

b)服务资源访问：通过地理信息服务资源地址访问地理信息服务，取得返回结果。

5瓦片地图服务接口

5.1总体描述

瓦片地图服务是以瓦片地图形式存储的电子地图为数据基础的地理信息服务，其接口内容包括：元

数据接口、WMTS接口、WMS-C接口、IIS瓦片地图服务接口等。用户通过访问该类型的服务接口研发在

线电子地图浏览、影像地图元数据查询等功能。地图瓦片规格定义参照CH/Z9011。瓦片地图服务接口

实例详见附录A。

5

DB37/T2761.3—2016

5.2元数据接口

5.2.1资源描述

用户输入合法的服务网址和参数，获取瓦片地图服务的元数据描述信息。元数据访问对象定义参照

GB/T30320。

5.2.2网址格式

元数据接口访问请求网址应按以下格式：

http://host:port/<ServerName>/imgmetaservice.asmx?op=<用户操作类型>&wktpoint=<瓦片坐

标>&level=<地图显示级别>&username=<用户名>&password=<密码>

5.2.3输入参数

元数据接口访问请求输入参数内容与说明：

a)serverName:服务的虚拟目录名称，可为多级目录；

b)op:表示用户操作类型，必选参数。如f=QueryMeta（影像元数据查询）；

c)wktpoint:表示所查询瓦片的坐标值，必选参数。如wktpoint=POINT(118.535.2)；

d)level:所查询瓦片地图服务的显示级别，可选参数；

e)username:用户名，访问需授权地理信息服务时必选该参数；

f)password:密码，访问需授权地理信息服务时必选该参数；

5.2.4输出结果

元数据接口访问请求返回瓦片地图服务描述信息，输出结果与说明见表3。

表3瓦片地图服务元数据接口输出结果与说明

XML格式定义说明

<?xmlversion="1.0"encoding="utf-8"?>如返回xml,则有

<ShareServiceResult><ShareServiceResult>

<QueryMetaResponsexmlns="/"><QueryMetaResponse>表示访问结

<QueryMetaResult>果是否成功

[{"type":"<MapType>"表示影像数据类型（卫片|航片）；

"st":"<StartTime>",表示影像数据获取的起止时间，标

"et":"<EndTime>",准格式为：年月(如201402)；

"sl":<StartLevel>,表示该时像数据瓦片服务的起止

"el":<EndLevel>,显示级别；

"reso":<Resolution>,表示该影像的地面分辨率，地图的

单位为米；

"cam":"<Sensor>",表示该影像传感器名称；

"name":"<MapName>",表示该瓦片服务名称；

"lid":"<id>"},表示该瓦片服务的序列号；

…………其他级别瓦片数据元数据描述；

]

</QueryMetaResult>

</QueryMetaResponse>

</ShareServiceResult>

6

DB37/T2761.3—2016

5.3WMTS接口

5.3.1资源描述

用户输入合法的服务网址和参数，获取瓦片地图服务的标准OGCWMTS服务。

5.3.2网址格式

WMTS服务接口访问请求网址应按以下格式：

http://host:port/tileservice/<ServiceName>?service=<服务类型默认为WMTS>&request=<请

求名称默认为GetTile>&version=<版本>&layer=<图层名>&style=<类型>&tileMatrixSet=<图层对应

金字塔名称>&tileMatrix=<瓦片层号>&tileRow=<瓦片行号>&tileCol=<瓦片列号>&format=<图片格

式>&userName=<用户名>&password=<密码>

5.3.3输入参数

WMTS服务接口访问请求输入参数按OGC07-057r7执行，自定义输入参数说明：

a)serviceName:服务名称；

b)username:用户名，访问需授权地理信息服务时必选该参数；

c)password:密码，访问需授权地理信息服务时必选该参数；

5.3.4输出结果

输出结果按OGC07-057r7执行。

5.4WMS-C接口

5.4.1资源描述

WMS-C基于缓存的网络地图服务接口，用于实现对地图瓦片的请求与访问，以提高网络地图服务的

并发响应能力。服务预先在服务器端存储瓦片数据，在客户端采用与WMS相同的操作方式调用瓦片数据，

此种方式与WMS服务相比，能够在一定程度上减轻服务器的负载压力。山东省地理信息公开服务平台

WMS-C服务符合WMS服务接口规范。

用户输入合法的服务网址和参数，获取瓦片地图服务的标准OGCWMS服务。

5.4.2网址格式

WMS-C服务接口访问请求网址应按以下格式：

http://host:port/WMS-CService/Service/<ServiceName>?service=<服务类型默认为

WMS>&request=<请求名称默认为GetMap>&srs=<坐标参照系统>&bbox=<Wkt格式，值为某个CRS下的地

图边界范围的坐标序列>&layers=<值为一个或多个地图图层列表，多个图层之间用”,”隔开>&styles=<

值为请求图层的地图渲染样式>&format=<图片格式>&width=<值为地图图片的像素宽度>&height=<值为

地图图片的像素高度>&bgcolor=<值为十六进制的RGB值，表示地图的背景颜色>&transparent=<值为

true或者false，用来表示地图图层是否透明(默认情况下是不透明的)>&exceptions=<值为WMS的异常

信息报告的格式(默认情况下是XML格式)>&userName=<用户名>&password=<密码>

5.4.3输入参数

WMS-C服务接口访问请求输入参数按OGC03-109r1执行，自定义输入参数说明：

a)serverName:服务的虚拟目录名称，可为多级目录；

7

DB37/T2761.3—2016

b)username:用户名，访问需授权地理信息服务时必选该参数；

c)password:密码，访问需授权地理信息服务时必选该参数；

5.4.4输出结果

输出结果按OGC03-109r1执行。

5.5IIS瓦片地图服务接口

5.5.1资源描述

用户输入合法的服务网址和参数，获取瓦片地图服务的特定地图瓦片。

5.5.2网址格式

瓦片地图服务接口访问请求网址应按以下格式：

http://host:port/<ServerName>/tile/<level>/<row>/<col>?userName=<用户名>&password=<密

码>

5.5.3输入参数

瓦片地图服务接口访问请求输入参数内容与说明：

a)serverName:服务的虚拟目录名称，可为多级目录；

b)level:提取瓦片的级别，必选参数。如3；

c)row:提取瓦片的行号，必选参数。如84；

d)col:提取瓦片的列号，必选参数。如400；

e)username:用户名，访问需授权地理信息服务时必选该参数；

f)password:密码，访问需授权地理信息服务时必选该参数；

5.5.4输出结果

如果参数正确，则返回所访问的瓦片，否则返回错误信息如以下格式：

{“status”:error，“error”:[错误原因]}

6动态地图服务接口

6.1总体描述

动态地图服务是以矢量地理信息数据为基础的地理信息服务，主要特点是地图图片是服务器动态实

时渲染的，其接口内容包括：WMS接口、WFS接口、MapService接口等。用户通过访问该类型的服务接

口可研发动态地图浏览、地图识别查询、要素快速定位、要素属性查询、要素空间查询等功能。动态地

图服务接口实例详见附录A。

6.2WMS接口

WMS与WMS-C服务接口相同，按5.4条对该类服务接口的要求执行。

6.3WFS接口

6.3.1资源描述

8

DB37/T2761.3—2016

WFS返回结果是XML格式的WFS服务元数据文档，通过该文档用户能够了解：WFS服务器支持的所有操

作操作列表，GetFeature操作返回的数据格式，可用的坐标参照系统列表，操作异常信息的列表，WFS

服务提供商的相关信息，WFS服务器的可用要素类列表等。

用户输入合法的服务网址和参数,获取与数据查询服务相关的标准OGC格式的WFS服务。

6.3.2网址格式

WFS服务接口访问请求网址应按以下格式：

http://host:port/<ServerName>/WFSServer?service=<服务类型默认为WFS>&request=<请求名

称默认为GetFeature>&version=<版本>&typename=<请求要素类型的名称，多个名称之间用“,”隔

开>&userName=<用户名>&password=<密码>

6.3.3输入参数

WFS服务接口访问请求描述输入参数按OGC09-025r2执行，自定义输入主要参数说明：

a)serverName:服务的虚拟目录名称。可为多级目录；

b)username:用户名，访问需授权地理信息服务时必选该参数；

c)password:密码，访问需授权地理信息服务时必选该参数；

6.3.4输出结果

输出结果按OGC09-025r2执行。

7地名搜索服务接口

7.1总体描述

地名搜索服务是以标准的地名数据为基础的地理信息服务，其接口内容包括：关键词搜索接口、分

类搜索接口、周边搜索接口、WFS-G接口等。用户通过访问该类型的服务可研发地名地址快速搜索与展

示、快速定位、分类搜索、周边缓冲搜索等功能模块。地名地址规则参照CH/Z9010。地名搜索服务接

口实例详见附录A。

7.2关键词搜索接口

7.2.1资源描述

根据用户输入合法的服务网址和参数，对整个系统平台数据库进行查询，查询结果以XML格式返回，

通过对其解析创建查询所需的全文检索列表展示给用户。

7.2.2网址格式

关键词搜索接口访问请求网址应按以下格式：

http://host:port/<ServerName>/FulltextS