DB51∕T 1935-2014 地理信息公共服务平台 服务接口规范(四川省).pdf
《DB51∕T 1935-2014 地理信息公共服务平台 服务接口规范(四川省).pdf》由会员分享,可在线阅读,更多相关《DB51∕T 1935-2014 地理信息公共服务平台 服务接口规范(四川省).pdf(68页珍藏版)》请在文库网上搜索。
1、 ICS 07.040 A 75 DB51 四川省地方标准 DB51/T 19352014 地理信息公共服务平台 服务接口规范 2014 - 12 - 22 发布 2015 - 04 - 01 实施四川省质量技术监督局 发 布 DB51/T 19352014 I 目 次 前 言 . II 引 言 . III 1 范围 . 1 2 规范性引用文件 . 1 3 术语和定义 . 1 4 地理信息服务访问方法描述 . 2 5 用户认证服务接口 . 4 6 瓦片地图服务接口 . 5 7 地名搜索服务接口 . 10 8 路径分析服务接口 . 18 9 数据查询服务接口 . 21 10 动态地图服务接口 .
2、 32 附录 A(资料性附录) 服务接口示例. 40 参考文献 . 59 DB51/T 19352014 II 前 言 本标准由四川省测绘地理信息局提出并归口。 本标准由四川省质量技术监督局发布。 本标准起草单位:四川省基础地理信息中心。 本标准主要起草人:刘建川、张玲、谭明建、杨军、任春雷、张尧、佟杰、徐娅莉、颜清梅。 DB51/T 19352014 III 引 言 四川省地理信息公共服务平台作为国家地理信息公共服务平台的重要组成部分, 是国民经济和社会信息的空间化载体,也是实现地理信息资源“一站式”网络服务的技术实体,主要包括分布式的公共地理信息数据库系统、网络化的地理信息服务系统和以电子
3、政务内、外网为依托的网络系统。 为规范本省地理信息公共服务平台的地理信息服务接口描述, 方便软件开发人员调用平台的地理信息服务,特制定本标准。 DB51/T 19352014 1 地理信息公共服务平台 服务接口规范 1 范围 本标准规定了四川省地理信息公共服务平台发布的用户认证服务、瓦片地图服务、地名搜索服务、路径分析服务、数据查询服务、动态地图服务等地理信息服务接口。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。 凡是注日期的引用文件, 仅所注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。 GB/T 17694 地理信息 术语 GB
4、/T 30320 地理空间数据库访问接口 CH/T 9004 地理信息公共平台基本规定 CH/Z 9010 地理信息公共服务平台地理实体与地名地址数据规范 CH/Z 9011 地理信息公共服务平台电子地图数据规范 3 术语和定义 下列术语和定义适用于本文件。 3.1 地理信息数据 geographic information data 反映和描述自然地理要素或者地表人工设施的形状、大小、空间位置及其属性等信息的数据。 3.2 地理信息公共服务平台 platform for geoinformation common services 实现在线地理信息服务所需的信息数据、服务功能及其运行支撑的总
5、称。3.3 Web服务 Web service Internet分布式计算环境中提供基础功能的软件系统。 3.4 地理信息服务 GIS service 面向空间信息处理的Web服务,主要功能包括空间信息的管理、查询、空间分析等。 3.5 客户端IP地址 IP address of client DB51/T 19352014 2 访问服务的用户计算机的IP地址。 3.6 服务访问令牌 token of service 访问平台的地理信息服务的加密字符串。 3.7 瓦片地图金字塔模型 pyramid model of tile map 一种多分辨率层次模型,从金字塔的底层到顶层,分辨率依次递减,
6、但表示的地理范围不变。 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) 一种互
7、联网要素服务标准。 3.13 网络地图服务 Web Map Service(WMS) 一种互联网地图服务标准。 3.14 网络地图图块服务 Web Map Tile Service(WMTS) 一种互联网地图图块服务标准。 4 地理信息服务访问方法描述 4.1 总体描述 DB51/T 19352014 3 地理信息服务都被抽象为资源;每个地理信息服务对应一个唯一的资源标识符(URL网址);通过URL接口对地理信息服务进行访问。 本标准规定了六大类地理信息服务,分别是用户认证服务、瓦片地图服务、地名搜索服务、路径分析服务、数据查询服务、动态地图服务;服务接口示例参见附录A。 4.2 返回 JSO
8、N 格式定义 4.2.1 返回信息的通用 JSON 格式定义 表1 返回信息的通用 JSON 格式描述 JSON 格式定义 说明 success:, version:, description:, 表示访问是否成功 表示软件版本 服务的描述信息 message: 结果对象:返回数据集合对象或错误信息 4.2.2 基本几何对象的 JSON 格式定义 a) Point: 格式x:,y: 如x:104.299,y:30.63799 b) Line: 格式vertices:, 如vertices:12,45,23,34,23,44 c) Polyline: 格式paths:, , 如paths:12,
9、32,23,34,12,35,34,56 d) LinearRing: 格式vertices:, 如vertices:12,45,23,34,23,44,12,45 e) Polygon: 格式rings:, 如rings:12,32,23,34,34,34,12,32,12,32,23,34,34,34,12,32 f) MultiPoint: 格式points:, 如points:12,45,23,34,23,44 g) MultiPolygon: 格式polygons:, , 如polgyons:12,32,23,34,34,34,12,32,12,32, DB51/T 19352014
10、 4 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:,yMin:,xMax:,yMax: 如xMin:12,yMin:23,xMax:34,yMax:45 4.3 地理信息服务的访问步骤 4.3.1 加密地理信息服务访问步骤 对于加密的地理信息服务(即需要用户认证的服务),访问步骤如下: a) 获取加密令牌(token):通过服务访问令牌服务接口获取合法的 token(加密字符串); b) 获取服务资源地址:通过平台获取地理信息服务资源访问地址; c) 构建加密
11、服务资源的访问地址: 在地理信息服务资源访问地址上加入 token 输入参数, 形式为“&token=”,生成新的服务网址; d) 服务资源访问:通过加密的服务资源地址访问地理信息服务,取得返回结果。 4.3.2 非加密地理信息服务访问步骤 a) 获取服务资源地址:通过平台获取地理信息服务资源访问地址; b) 服务资源访问:通过地理信息服务资源地址访问地理信息服务,取得返回结果。 5 用户认证服务接口 5.1 总体描述 用户认证服务是检查平台用户的合法身份和取得地理信息服务访问权限的认证服务。 合法用户通过服务获取访问地理信息服务的权限(加密的令牌(Token)。 5.2 获取令牌接口 5.2
12、.1 资源描述 用户输入合法的用户名、密码、客户端IP地址、持续访问时间,服务器返回用户访问令牌(Token)。 5.2.2 网址格式 获取令牌(Token)服务请求网址应按以下格式: http:/host:port/getToken?userName=&password=&IpAddress=&HttpReferer=&TimeSpan=&callback= 5.2.3 输入参数 获取令牌服务接口输入参数与说明: a) serverName:serverName:服务的虚拟目录名称,可为多级目录; b) username:username:用户名,必选参数; c) password:pass
13、word:用户密码,必选参数; d) ipAddress:ipAddress:该用户允许访问的主机的 IP 地址可选参数。若未输入则为缺省访问的客户端 IP地址。适用于短期项目开发和测试时使用,其生成 Token 的使用应受到系统的限制; DB51/T 19352014 5 e) httpReferer:httpReferer:允许使用该 Token 访问服务的网站域名或 IP 地址参考,可选参数。适用于项目部署和实际运行使用(即应用程序有一个固定的 IP 地址或域名),它与 IpAddress 参数二选一;当 IpAddress 和 HttpReferer 冲突时,系统应直接使用 IpAdd
14、ress 进行 Token 的生成; f) timeSpan:timeSpan:Token 允许访问的持续时间间隔,必选参数。如 2D 为两天,2H 为两小时,2M 为两分钟; g) callback:callback:客户端要求返回的 JSONP 函数,可选参数; 5.2.4 输出结果 获取令牌服务接口返回token加密字符串,输出结果与说明见表2。 表2 获取访问令牌服务接口输出结果与说明 JSON格式定义 说 明 ( success:, version:, description:, message: token: tokenExpiration: ) 如返回JSONP,则有和括号 表示
15、访问是否成功 表示软件版本 服务的描述信息 结果对象:返回数据集合对象或错误信息 返回token加密字符串 返回token的失效日期 6 瓦片地图服务接口 6.1 总体描述 瓦片地图服务是以瓦片地图形式存储的电子地图为数据基础的地理信息服务, 其接口内容包括: 元数据接口、历史版本元数据接口、瓦片数据接口、WMS接口、WMTS接口等。用户通过访问该类型的服务接口研发在线电子地图浏览、历史地图数据查询、历史电子地图浏览等功能。 6.2 元数据接口 6.2.1 资源描述 用户输入合法的服务网址和参数,获取瓦片地图服务的元数据描述信息。 6.2.2 网址格式 元数据请求网址应按以下格式: http:
16、/host:port/mapServer?f=&Token=&pretty=&callback= 6.2.3 输入参数 元数据接口输入参数内容与说明: DB51/T 19352014 6 a) serverName:serverName:服务的虚拟目录名称,可为多级目录; b) f:f:表示返回参数的格式,必选参数。如 f=JSON(返回 JSON 格式的数据); c) pretty:pretty:表示是否使用格式化方式显示返回数据,可选参数; d) token:token:用户生成的加密字符串,访问加密服务时必选该参数; e) callback:callback:客户端要求返回的 JSONP
17、 函数,可选参数,未输入则为 JSON 格式,反之则为 JSONP格式。 6.2.4 输出结果 元数据接口返回瓦片地图服务描述信息,输出结果与说明见表3。 表3 瓦片地图服务元数据接口输出结果与说明 JSON 格式定义 说 明 ( success:, version:, description:, message: MapName:, Description:, mapUnits:, fullExtent: xmin:,ymin:, xmax:,ymax: , tileMapCacheInfo: tileOrigin: x:, y: , tileRows:, tileCols:, tileFo
18、rmat:, dpi:, LODInfos: level:, scale:, resolution: , 如返回 JSONP,则有和括号 表示访问是否成功 表示软件版本 服务的描述信息 结果对象:返回数据集合对象或错误信息 地图服务的名称 地图服务的描述 地图的单位,取值为 DegreesMetersOthers;Degrees 表示以度为单位的经纬度坐标;Meters 表示以米为单位的投影坐标 该用户所能访问的地图范围 地图范围的四至点值 地图的瓦片信息集合对象 瓦片的起始坐标(左上角坐标) 瓦片的高度(单位:像素) 瓦片的宽度(单位:像素) 瓦片的保存格式(image/jpeg,image
19、/png 等) 瓦片的分辨率,通常为 96 瓦片的分级信息集合对象 级别 比例尺 该级别的地面分辨率(表示一个像素代表的地面宽度) DB51/T 19352014 7 level:, scale:, resolution: supportVersion: ) 级别 比例尺 该级别的地面分辨率(表示一个像素代表的地面宽度) 是否支持历史版本 6.3 历史版本元数据接口 6.3.1 资源描述 该接口为扩展服务接口,如果服务支持历史版本元数据接口,用户输入合法的服务网址和参数,获取瓦片地图历史版本的元数据描述信息。 6.3.2 网址格式 历史版本元数据访问请求网址应按以下格式: http:/host
20、:port/getVersions?f=&Token=&startTime=&stopTime=&pretty=& callback= 6.3.3 输入参数 历史版本元数据访问接口输入参数内容与说明: a) serverName:serverName:服务的虚拟目录名称,可为多级目录; b) f:f:表示返回参数的格式,必选参数。如 f=JSON; c) pretty:pretty:表示是否使用格式化方式显示返回数据,可选参数; d) token:token:用户生成的加密字符串,访问加密服务时必选该参数; e) callback:callback:客户端要求返回的 JSONP 函数,可选参数
21、,未输入则为 JSON 格式,反之则为 JSONP格式; f) startTime:startTime:用户需要访问的历史地图的起点日期,可选参数,默认为最初的历史日期。标准输入法为:年-月-日 小时:分:秒(如 2011-12-24 13:34:45),如果有不符合规定的时间格式,系统应自动报错; g) stopTime:stopTime:用户需要访问的历史地图的终止日期,可选参数,默认为最后的历史日期。标准输入法为:年-月-日 小时:分:秒(如 2011-12-24 13:34:45),如果有不符合规定的时间格式,系统应自动报错。 6.3.4 输出结果 历史版本元数据访问接口返回指定时期历
22、史版本元数据描述信息,输出结果与说明见表4。 DB51/T 19352014 8 表4 瓦片地图服务历史版本元数据访问接口输出结果与说明 JSON格式定义 说 明 ( success:, version:, description:, message: tileMapVersionsInfo: name:, timeStamp:, description:, 如返回JSONP,则有和括号 表示访问是否成功 表示软件版本 服务的描述信息 结果对象:返回数据集合对象或错误信息 地图版本信息描述 版本名称 版本更新时间点,历史版本的重要标志 版本的详细描述信息 extents: subName:,
23、extent: xmin:,ymin:, xmax:,ymax: . subName:, extent: xmin:,ymin:, xmax:,ymax: , name:, timeStamp:, description:, extents: subName:, extent: xmin:,ymin:, xmax:,ymax: . 更新范围集合,方便用户对更新地区进行定位查看 子范围的名称 子范围的四至点值 子范围的名称 子范围的四至点值 版本名称 版本更新时间点,历史版本的重要标志 版本的详细描述信息 更新范围集合 子范围的名称 子范围的四至点值 DB51/T 19352014 9 subN
24、ame:, extent: xmin:,ymin:, xmax:,ymax: ) 子范围的名称 子范围的四至点值 6.4 瓦片数据接口 6.4.1 资源描述 用户输入合法的服务网址和参数,获取瓦片地图服务的特定地图瓦片。 6.4.2 网址格式 瓦片数据访问请求网址应按以下格式: http:/host:port/tile/?Token=×tamp= 6.4.3 输入参数 瓦片数据访问接口输入参数内容与说明: a) serverName:serverName:服务的虚拟目录名称,可为多级目录; b) level:level:提取瓦片的级别,必选参数。如 3; c) row:row:提取瓦
25、片的行号,必选参数。如 84; d) col:col:提取瓦片的列号,必选参数。如 400; e) token:token:用户生成的加密字符串,访问加密服务时必选该参数; f) timeStamp:timeStamp:历史服务时间点(如果服务支持历史查询),可选参数,默认为当前最新的数据。标准输入法为:年-月-日 小时:分:秒(如 2011-12-24 13:34:45 或 2012/10/12 8:00:00),如果有不符合规定的时间格式,系统应自动报错。 6.4.4 输出结果 如果参数正确,则返回所访问的瓦片,否则返回错误信息。 6.5 WMS 接口 6.5.1 资源描述 用户输入合法的
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB51T 1935-2014 地理信息公共服务平台 服务接口规范四川省 DB51 1935 2014 地理信息 公共 服务 平台 接口 规范 四川省