DB51/T 1935-2014 地理信息公共服务平台 服务接口规范

ICS07.040

A75

DB51

四川省地方标准

DB51/T1935—2014

地理信息公共服务平台服务接口规范

2014-12-22发布2015-04-01实施

四川省质量技术监督局发布

DB51/T1935—2014

目次

前言...............................................................................II

引言..............................................................................III

1范围..............................................................................1

2规范性引用文件....................................................................1

3术语和定义........................................................................1

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

5用户认证服务接口..................................................................4

6瓦片地图服务接口..................................................................5

7地名搜索服务接口.................................................................10

8路径分析服务接口.................................................................18

9数据查询服务接口.................................................................21

10动态地图服务接口................................................................32

附录A（资料性附录）服务接口示例...................................................40

参考文献............................................................................59

I

DB51/T1935—2014

前言

本标准由四川省测绘地理信息局提出并归口。

本标准由四川省质量技术监督局发布。

本标准起草单位：四川省基础地理信息中心。

本标准主要起草人：刘建川、张玲、谭明建、杨军、任春雷、张尧、佟杰、徐娅莉、颜清梅。

II

DB51/T1935—2014

引言

四川省地理信息公共服务平台作为国家地理信息公共服务平台的重要组成部分，是国民经济和社会

信息的空间化载体，也是实现地理信息资源“一站式”网络服务的技术实体，主要包括分布式的公共地

理信息数据库系统、网络化的地理信息服务系统和以电子政务内、外网为依托的网络系统。

为规范本省地理信息公共服务平台的地理信息服务接口描述，方便软件开发人员调用平台的地理信

息服务，特制定本标准。

III

DB51/T1935—2014

地理信息公共服务平台服务接口规范

1范围

本标准规定了四川省地理信息公共服务平台发布的用户认证服务、瓦片地图服务、地名搜索服务、

路径分析服务、数据查询服务、动态地图服务等地理信息服务接口。

2规范性引用文件

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

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

GB/T17694地理信息术语

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

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

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

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

3术语和定义

下列术语和定义适用于本文件。

3.1

地理信息数据geographicinformationdata

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

3.2

地理信息公共服务平台platformforgeoinformationcommonservices

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

3.3

Web服务Webservice

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

3.4

地理信息服务GISservice

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

3.5

客户端IP地址IPaddressofclient

1

DB51/T1935—2014

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

3.6

服务访问令牌tokenofservice

访问平台的地理信息服务的加密字符串。

3.7

瓦片地图金字塔模型pyramidmodeloftilemap

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

3.8

瓦片地图tilemap

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

3.9

动态地图dynamicmap

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

3.10

轻量级的数据交换格式JavaScriptObjectNotation(JSON）

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

3.11

便携式网络图像格式PortableNetworkGraphics（PNG）

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

3.12

网络要素服务WebFeatureService（WFS）

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

3.13

网络地图服务WebMapService（WMS）

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

3.14

网络地图图块服务WebMapTileService（WMTS）

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

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

4.1总体描述

2

DB51/T1935—2014

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

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

本标准规定了六大类地理信息服务，分别是用户认证服务、瓦片地图服务、地名搜索服务、路径分

析服务、数据查询服务、动态地图服务；服务接口示例参见附录A。

4.2返回JSON格式定义

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

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

JSON格式定义说明

{

"success":"<true|false>",表示访问是否成功

"version":"<versionNumber>",表示软件版本

"description":"<description>",服务的描述信息

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

…

}

}

4.2.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]]]}

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],

3

DB51/T1935—2014

[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.3地理信息服务的访问步骤

4.3.1加密地理信息服务访问步骤

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

a)获取加密令牌（token）：通过服务访问令牌服务接口获取合法的token(加密字符串)；

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

c)构建加密服务资源的访问地址：在地理信息服务资源访问地址上加入token输入参数，形式为

“&token=<token>”，生成新的服务网址；

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

4.3.2非加密地理信息服务访问步骤

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

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

5用户认证服务接口

5.1总体描述

用户认证服务是检查平台用户的合法身份和取得地理信息服务访问权限的认证服务。合法用户通过

服务获取访问地理信息服务的权限（加密的令牌（Token））。

5.2获取令牌接口

5.2.1资源描述

用户输入合法的用户名、密码、客户端IP地址、持续访问时间，服务器返回用户访问令牌(Token)。

5.2.2网址格式

获取令牌(Token)服务请求网址应按以下格式：

http://host:port/<ServerName>/getToken?userName=<userName>&password=<password>&IpAddr

ess=<IpAddress>&HttpReferer=<HttpReferer>&TimeSpan=<TimeSpan>&callback=<callbackFunction>

5.2.3输入参数

获取令牌服务接口输入参数与说明：

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

b)username:用户名，必选参数；

c)password:用户密码，必选参数；

d)ipAddress:该用户允许访问的主机的IP地址可选参数。若未输入则为缺省访问的客户端IP

地址。适用于短期项目开发和测试时使用，其生成Token的使用应受到系统的限制；

4

DB51/T1935—2014

e)httpReferer:允许使用该Token访问服务的网站域名或IP地址参考，可选参数。适用于项目

部署和实际运行使用（即应用程序有一个固定的IP地址或域名），它与IpAddress参数二选

一；当IpAddress和HttpReferer冲突时，系统应直接使用IpAddress进行Token的生成；

f)timeSpan:Token允许访问的持续时间间隔，必选参数。如2D为两天，2H为两小时，2M为两

分钟；

g)callback:客户端要求返回的JSONP函数，可选参数；

5.2.4输出结果

获取令牌服务接口返回token加密字符串，输出结果与说明见表2。

表2获取访问令牌服务接口输出结果与说明

JSON格式定义说明

<callbackFunction>({如返回JSONP，则有<callbackFunction>和括号

"success":"<true|false>",表示访问是否成功

"version":"<versionNumber>",表示软件版本

"description":"<description>",服务的描述信息

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

"token":"<token>"返回token加密字符串

"tokenExpiration":"<expiration>"返回token的失效日期

}

})

6瓦片地图服务接口

6.1总体描述

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

数据接口、历史版本元数据接口、瓦片数据接口、WMS接口、WMTS接口等。用户通过访问该类型的服务

接口研发在线电子地图浏览、历史地图数据查询、历史电子地图浏览等功能。

6.2元数据接口

6.2.1资源描述

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

6.2.2网址格式

元数据请求网址应按以下格式：

http://host:port/<ServerName>/mapServer?f=<JSON>&Token=<用户生成的Token加密字符串

>&pretty=<pretty>&callback=<callbackFunction>

6.2.3输入参数

元数据接口输入参数内容与说明：

5

DB51/T1935—2014

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

b)f:表示返回参数的格式，必选参数。如f=JSON（返回JSON格式的数据）；

c)pretty:表示是否使用格式化方式显示返回数据，可选参数；

d)token:用户生成的加密字符串，访问加密服务时必选该参数；

e)callback:客户端要求返回的JSONP函数，可选参数，未输入则为JSON格式，反之则为JSONP

格式。

6.2.4输出结果

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

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

JSON格式定义说明

<callbackFunction>({如返回JSONP,则有<callbackFunction>和括号

"success":"<true|false>",表示访问是否成功

"version":"<versionNumber>",表示软件版本

"description":"<description>",服务的描述信息

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

"MapName":"<MapName>",地图服务的名称

"Description":"<Description>",地图服务的描述

"mapUnits":"<mapUnits>",地图的单位，取值为Degrees\Meters\Others；Degrees表

示以度为单位的经纬度坐标；Meters表示以米为单位的投

影坐标

"fullExtent":{该用户所能访问的地图范围

"xmin":<xmin>,"ymin":<ymin>,地图范围的四至点值

"xmax":<xmax>,"ymax":<ymax>

},

"tileMapCacheInfo":{地图的瓦片信息集合对象

"tileOrigin":{瓦片的起始坐标(左上角坐标)

"x":<x>,

"y":<y>

},

"tileRows":<tileRows>,瓦片的高度(单位：像素)

"tileCols":<tileCols>,瓦片的宽度(单位：像素)

"tileFormat":<tileFormat>,瓦片的保存格式(image/jpeg,image/png等)

"dpi":<dpi>,瓦片的分辨率,通常为96

"LODInfos":[{瓦片的分级信息集合对象

"level":<level_0>,级别

"scale":<scale_0>,比例尺

"resolution":<resolution_0>该级别的地面分辨率(表示一个像素代表的地面宽度)

},

…………

{

6

DB51/T1935—2014

"level":<level_n>,级别

"scale":<scale_n>,比例尺

"resolution":<resolution_0>该级别的地面分辨率(表示一个像素代表的地面宽度)

}]

}

supportVersion:<true|false>是否支持历史版本

}

})

6.3历史版本元数据接口

6.3.1资源描述

该接口为扩展服务接口，如果服务支持历史版本元数据接口，用户输入合法的服务网址和参数，获

取瓦片地图历史版本的元数据描述信息。

6.3.2网址格式

历史版本元数据访问请求网址应按以下格式：

http://host:port/<ServerName>/getVersions?f=<JSON>&Token=<用户生成的Token加密字符串>

&startTime=<查询日期>&stopTime=<查询日期>&pretty=<pretty>&callback=<callbackFunction>

6.3.3输入参数

历史版本元数据访问接口输入参数内容与说明：

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

b)f:表示返回参数的格式，必选参数。如f=JSON；

c)pretty:表示是否使用格式化方式显示返回数据，可选参数；

d)token:用户生成的加密字符串，访问加密服务时必选该参数；

e)callback:客户端要求返回的JSONP函数，可选参数，未输入则为JSON格式，反之则为JSONP

格式；

f)startTime:用户需要访问的历史地图的起点日期，可选参数，默认为最初的历史日期。标准输

入法为：年-月-日小时:分:秒(如2011-12-2413:34:45)，如果有不符合规定的时间格式，

系统应自动报错；

g)stopTime:用户需要访问的历史地图的终止日期，可选参数，默认为最后的历史日期。标准输

入法为：年-月-日小时:分:秒(如2011-12-2413:34:45)，如果有不符合规定的时间格式，

系统应自动报错。

6.3.4输出结果

历史版本元数据访问接口返回指定时期历史版本元数据描述信息，输出结果与说明见表4。

7

DB51/T1935—2014

表4瓦片地图服务历史版本元数据访问接口输出结果与说明

JSON格式定义说明

<callbackFunction>({如返回JSONP,则有<callbackFunction>和括号

"success":"<true|false>",表示访问是否成功

"version":"<versionNumber>",表示软件版本

"description":"<description>",服务的描述信息

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

"tileMapVersionsInfo":[{地图版本信息描述

"name":"<name_0>",版本名称

"timeStamp":"<timeStamp_0>",版本更新时间点，历史版本的重要标志

"description":"<description_0>",版本的详细描述信息

"extents":[{更新范围集合，方便用户对更新地区进行定位查看

"subName":"<subname_0>",子范围的名称

"extent":{子范围的四至点值

"xmin":<xmin>,"ymin":<ymin>,

"xmax":<xmax>,"ymax":<ymax>

}

}

.........

{

"subName":"<subname_n>",子范围的名称

"extent":{子范围的四至点值

"xmin":<xmin>,"ymin":<ymin>,

"xmax":<xmax>,"ymax":<ymax>

}

},

…………

{

"name":"<name_n>",版本名称

"timeStamp":"<timeStamp_n>",版本更新时间点，历史版本的重要标志

"description":"<description_n>"，版本的详细描述信息

"extents":[{更新范围集合

"subName":"<subname_0>",子范围的名称

"extent":{子范围的四至点值

"xmin":<xmin>,"ymin":<ymin>,

"xmax":<xmax>,"ymax":<ymax>

}

}

.........

8

DB51/T1935—2014

{

"subName":"<subname_n>",子范围的名称

"extent":{子范围的四至点值

"xmin":<xmin>,"ymin":<ymin>,

"xmax":<xmax>,"ymax":<ymax>

}

}]

}]

}

})

6.4瓦片数据接口

6.4.1资源描述

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

6.4.2网址格式

瓦片数据访问请求网址应按以下格式：

http://host:port/<ServerName>/tile/<level>/<row>/<col>?Token=<用户生成的Token加密字

符串>×tamp=<查询历史日期>

6.4.3输入参数

瓦片数据访问接口输入参数内容与说明：

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

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

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

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

e)token:用户生成的加密字符串，访问加密服务时必选该参数；

f)timeStamp:历史服务时间点（如果服务支持历史查询），可选参数，默认为当前最新的数据。

标准输入法为：年-月-日小时:分:秒(如2011-12-2413:34:45或2012/10/128:00:00)，如

果有不符合规定的时间格式，系统应自动报错。

6.4.4输出结果

如果参数正确，则返回所访问的瓦片，否则返回错误信息。

6.5WMS接口

6.5.1资源描述

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

6.5.2网址格式

WMS服务请求网址应按以下格式：

http://host:port/<ServerName>/WMS?Token=<用户生成的Token加密字符串>×tamp=<查询

历史日期>

9

DB51/T1935—2014

6.5.3输入参数

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

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

b)token:用户生成的加密字符串,访问加密服务时必选该参数；

c)timeStamp:历史服务时间点（如果服务支持历史查询），可选参数，默认为当前最新的数据。

标准输入法为：年-月-日小时:分:秒(如2011-12-2413:34:45或2012/10/128:00:00),如

果有不符合规定的时间格式，系统应自动报错。

6.5.4输出结果

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

6.6WMTS接口

6.6.1资源描述

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

6.6.2网址格式

WMTS服务请求网址应按以下格式：

http://host:port/<ServerName>/WMTS?Token=<用户生成的Token加密字符串>&

timestamp=<查询历史日期>

6.6.3输入参数

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

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

b)token:用户生成的加密字符串,访问加密服务时必选该参数；

c)timeStamp:历史服务时间点（如果服务支持历史查询），可选参数，默认为当前最新的数据。

标准输入法为：年-月-日小时:分:秒(如2011-12-2413:34:45或2012/10/128:00:00)，如

果有不符合规定的时间格式，系统应自动报错；

6.6.4输出结果

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

7地名搜索服务接口

7.1总体描述

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

搜索接口、周边搜索（缓冲区搜索）接口、WFS-G接口等。用户通过访问该类型的服务可研发地名地址

快速搜索与展示、快速定位、分类搜索、周边缓冲搜索等功能模块。

7.2元数据接口

7.2.1资源描述

用户输入合法的服务网址和参数，获取地名搜索服务的元数据描述信息。

10

DB51/T1935—2014

7.2.2网址格式

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

http://host:port/<ServerName>/dataServer?f=<JSON>&callback=<callbackFunction>&pretty=

<pretty>&Token=<用户生成的Token加密字符串>

7.2.3输入参数

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

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

b)f:表示返回参数的格式，必选参数。如f=JSON；

c)pretty:表示是否使用格式化方式显示返回数据，可选参数；

d)token:用户生成的加密字符串，访问加密服务时必选该参数；

e)callback:客户端要求返回的JSONP函数，可选参数，未输入则为JSON格式，反之则为JSONP

格式。

7.2.4输出结果

元数据访问接口返回地名搜索服务元数据描述信息，输出结果与说明见表5。

表5地名搜索服务元数据访问接口输出结果与说明

JSON格式定义说明

<callbackFunction>({如返回JSONP,则有<callbackFunction>和括号

"success":"<true|false>",表示访问是否成功

"version":"<versionNumber>",表示软件版本

"description":"<description>",服务的描述信息

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

"name":"<name>",地名搜索服务的名称

"description