ICS 07.040 A 75 DB51 四 川 省 地 方 标 准 DB51/T 1935—2014 地理信息公共服务平台 服务接口规范 2014 - 12 - 22 发布 四川省质量技术监督局 2015 - 04 - 01 实施 发 布 DB51/T 1935—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/T 1935—2014 前 言 本标准由四川省测绘地理信息局提出并归口。 本标准由四川省质量技术监督局发布。 本标准起草单位：四川省基础地理信息中心。 本标准主要起草人：刘建川、张玲、谭明建、杨军、任春雷、张尧、佟杰、徐娅莉、颜清梅。 II DB51/T 1935—2014 引 言 四川省地理信息公共服务平台作为国家地理信息公共服务平台的重要组成部分，是国民经济和社会 信息的空间化载体，也是实现地理信息资源“一站式”网络服务的技术实体，主要包括分布式的公共地 理信息数据库系统、网络化的地理信息服务系统和以电子政务内、外网为依托的网络系统。 为规范本省地理信息公共服务平台的地理信息服务接口描述，方便软件开发人员调用平台的地理信 息服务，特制定本标准。 III DB51/T 1935—2014 地理信息公共服务平台 服务接口规范 1 范围 本标准规定了四川省地理信息公共服务平台发布的用户认证服务、瓦片地图服务、地名搜索服务、 路径分析服务、数据查询服务、动态地图服务等地理信息服务接口。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T 17694 地理信息 术语 GB/T 30320 地理空间数据库访问接口 CH/T 9004 地理信息公共平台基本规定 CH/Z 9010 地理信息公共服务平台地理实体与地名地址数据规范 CH/Z 9011 地理信息公共服务平台电子地图数据规范 3 术语和定义 下列术语和定义适用于本文件。 3.1 地理信息数据 geographic information data 反映和描述自然地理要素或者地表人工设施的形状、大小、空间位置及其属性等信息的数据。 3.2 地理信息公共服务平台 platform for geoinformation common services 实现在线地理信息服务所需的信息数据、服务功能及其运行支撑的总称。  3.3 Web服务 Web service Internet分布式计算环境中提供基础功能的软件系统。 3.4 地理信息服务 GIS service 面向空间信息处理的Web服务，主要功能包括空间信息的管理、查询、空间分析等。 3.5 客户端IP地址 IP address of client 1 DB51/T 1935—2014 访问服务的用户计算机的IP地址。 3.6 服务访问令牌 token of service 访问平台的地理信息服务的加密字符串。 3.7 瓦片地图金字塔模型 pyramid model of tile map 一种多分辨率层次模型，从金字塔的底层到顶层，分辨率依次递减，但表示的地理范围不变。 3.8 瓦片地图 tile map 按照某种瓦片地图金字塔模型，预先生成的栅格图像集合。 3.9 动态地图 dynamic map 后台服务器利用矢量地理信息数据动态实时渲染而产生的地图。 3.10 轻量级的数据交换格式 JavaScript Object Notation (JSON） 一种轻量级的基于文本、易读的表示简单数据结构和关联数组的数据交换格式。 3.11 便携式网络图像格式 Portable Network Graphics（PNG） 一种用于网络传输的无损数据压缩图像格式。 3.12 网络要素服务 Web Feature Service（WFS） 一种互联网要素服务标准。 3.13 网络地图服务 Web Map Service（WMS） 一种互联网地图服务标准。 3.14 网络地图图块服务 Web Map Tile Service（WMTS） 一种互联网地图图块服务标准。 4 地理信息服务访问方法描述 4.1 2 总体描述 DB51/T 1935—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 a) b) c) d) e) f) g) 基本几何对象的 JSON 格式定义 Point: 格式{"x":<x>,"y":<y>} 如{"x":104.299,"y":30.63799} Line: 格式{"vertices":[[<x>,<y>],……,[<x>,<y>]]} 如{"vertices":[[12,45],[23,34],[23,44]]} Polyline: 格式{"paths":[[[<x>,<y>],……, [<x>,<y>]],……,[[<x>,<y>],……,[<x>,<y>]]]} 如{"paths":[[[12,32],[23,34]],[[12,35],[34,56]]]} LinearRing: 格式{"vertices":[[<x>,<y>],……,[<x>,<y>]]} 如{"vertices":[[12,45],[23,34],[23,44],[12,45]]} 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]]]} MultiPoint: 格式{"points":[[<x>,<y>],……,[<x>,<y>]]} 如{"points":[[12,45],[23,34],[23,44]]} 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/T 1935—2014 h) 4.3 [23,34],[34,34],[12,32]]],[[[12,32],[23,34],[34,34],[12,32]], [[12,32],[23,34],[34,34],[12,32]]]]} BoundingBox: 格式{"xMin":<xMin>,"yMin":<yMin>,"xMax":<xMax>,"yMax":<yMax>} 如{"xMin":12,"yMin":23,"xMax":34,"yMax":45} 地理信息服务的访问步骤 4.3.1 加