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 数据
2、查询 服务接口 . . 21 10 动态地 图服务接口 . . 32 附录 A（资料 性附录） 服务接口示例 . 40 参考文献 . . 59 DB51/T 19352014 II 前 言 本标准由四川省测绘地理信息局提出并归口。 本标准由四川省质量技术监督局发布。 本标准起草单位：四川省基础地理信息中心。 本标准主要起草人：刘建川、张玲、谭明建、杨军、任春雷、张尧、佟杰、徐娅莉、颜清梅。 DB51/T 19352014 III 引 言 四川省地理信息公共服务平台作为国家地理信息公共服务平台的重要组成部分， 是国民经济和社会 信息的空间化载体，也是实现地理信息资源“一站式”网络服务的技术实体，
3、主要包括分布式的公共地 理信息数据库系统、网络化的地理信息服务系统和以电子政务内、外网为依托的网络系统。 为规范本省地理信息公共服务平台的地理信息服务接口描述， 方便软件开发人员调用平台的地理信 息服务，特制定本标准。 DB51/T 19352014 1 地理信息公共服务平台 服务接口规范 1 范围 本标准规定了四川省地理信息公共服务平台发布的用户认证服务、瓦片地图服务、地名搜索服务、 路径分析服务、数据查询服务、动态地图服务等地理信息服务接口。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（
4、包括所有的修改单）适用于本文件。 GB/T 17694 地理信息 术语 GB/T 30320 地理空间数据库访问接口 CH/T 9004 地理信息公共平台基本规定 CH/Z 9010 地理信息公共服务平台地理实体与地名地址数据规范 CH/Z 9011 地理信息公共服务平台电子地图数据规范 3 术语和定义 下列术语和定义适用于本文件。 3.1 地理信息数据 geographic inf ormation data 反映和描述自然地理要素或者地表人工设施的形状、大小、空间位置及其属性等信息的数据。 3.2 地理信息公共服务平台 platform for geoinfor mation common
5、 services 实现在线地理信息服务所需的信息数据、服务功能及其运行支撑的总称。 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 o
6、f tile map 一种多分辨率层次模型，从金字塔的底层到顶层，分辨率依次递减，但表示的地理范围不变。 3.8 瓦片地图 tile map 按照某种瓦片地图金字塔模型，预先生成的栅格图像集合。 3.9 动态地图 dynamic map 后台服务器利用矢量地理信息数据动态实时渲染而产生的地图。 3.10 轻量级的数据交换格式 JavaScript Objec t Notation (JSON） 一种轻量级的基于文本、易读的表示简单数据结构和关联数组的数据交换格式。 3.11 便携式网络图像格式 Portable Networ k Graphics（PNG） 一种用于网络传输的无损数据压缩图像格
7、式。 3.12 网络要素服务 Web Feature Service（WFS） 一种互联网要素服务标准。 3.13 网络地图服务 Web Map Service（WMS） 一种互联网地图服务标准。 3.14 网络地图图块服务 Web Map Tile Service（WMTS） 一种互联网地图图块服务标准。 4 地理信息服务访问方法描述 4.1 总体描述 DB51/T 19352014 3 地理信息服务都被抽象为资源；每个地理信息服务对应一 个唯一的资源标识符（URL网址）；通过 URL接口对地理信息服务进行访问。 本标准规定了六大类地理信息服务，分别是用户认证服务、瓦片地图服务、地名搜索服务
8、、路径分 析服务、数据查询服务、动态地图服务；服务接口示例参见附录A。 4.2 返回 JSON 格式定义 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,
9、23,34,23,44 c) Polyline: 格式paths:, , , 如paths:12,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:, ,
10、, 如polgyons:12,32,23,34,34,34,12,32,12,32, DB51/T 19352014 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）：通过服务访问令牌服务接口获
11、取合法的 token(加密字符串)； b) 获取服务资源地址：通过平台获取地理信息服务资源访问地址； c) 构建加密服务资源的访问地址：在地理信息服务资源访问地址上加入 token 输入参数，形式为 “/()( RLtileColstxxINTcol = );*/()( RLtileRowsytyINTRow = 如：求坐标点（102.17,30.86）所在 的级别为 3的图片的行列号（400,84）。 c) 输出结果示例 DB51/T 19352014 43 无 A.2.4 WMS接口 a) 服务网址示例 *(用户生成的 To ken) ×tamp=2012-12-20 b) 输出
12、结果示例 输出结果见 OGC 03-109r1。 A.2.5 WMTS接口 a) 服务网址示例 *(用户生成的 Token) & timestamp=2012-12-20 b) 输出结果示例 输出结果见 OGC 07-057r7。 A.3 地名搜索服务接口 A.3.1 元数据接口 a) 服务网址示例 ver?f=JSON&pretty=true&Token=*(用户生成的 Token) b) 输出结果示例 JSON 格式的地名搜索服务元数据信息，结果示例如下： success:true, version:3.0.0.0, description:null, message: name:地名搜索
13、, description:地名搜索, fullExtent: xmin:102.87029,ymin:30.072557, xmax:105.066031,ymax:31.527297 , diQuName: pac:5104,name:攀枝花市 , pac:5105,name:泸州市 , DB51/T 19352014 44 pac:5107,name:绵阳市 , quXianName: pac:510105,name:青羊区 , pac:510104,name:锦江区 , pac:510904,name:市中区 , nameType: type:zf,description:政府机构 ,
14、 type:yl,description:医疗卫生 , type:zj,description:宗教设施 , type:yz,description:邮政 A.3.2 关键词搜索接口 A.3.2.1 个数统计接口 a) 服务网址示例 ount?keyname=%u516C%u53F8&DiQuKey=5101&QuXianKey=510101&isOnlyName=false&SearchEn velope=xmin:96.8064823674966,ymin:25.6809610658065,xmax:109.125227982208, ymax:34.7521540875866&Token
15、=*(用户生成的 Token)&pretty=true b) 输出结果示例 返回 JSON 格式的关键词搜索的个数统计信息，结果示例如下： success:true, version:3.0.0.0, description:null, message: count:200, maxCount:100 DB51/T 19352014 45 A.3.2.2 返回搜索结果接口 a) 服务网址示例 keyname=%u516C%u53F8&DiQuKey=5101&QuXianKey=510101&isOnlyName=false&SearchEnvelop e=xmin:96.8064823674
16、966,ymin:25.6809610658065,xmax:109.125227982208,ymax :34.7521540875866&Token=*(用户生成的 Token)&pretty=true b) 输出结果示例 返回 JSON 格式的关键词搜索结果信息，结果示例如下： success:true, version:3.0.0.0, description:null, message: columns: columnName:ID, dataType:Integer, caption:ID , columnName:X, dataType:Double, caption:X , c
17、olumnName:Y, dataType:Double, caption:Y , columnName:名称, dataType:String, caption:名称 , columnName:类别, dataType:String, caption:类别 , columnName:地区, dataType:String, caption:地区 , columnName:区县, dataType:String, caption:区县 DB51/T 19352014 46 , features: attributes: 0, 103.84326779400004, 30.08880458700
18、0084, 眉山市建辉农化有限公司, 企事业单位, 眉山市, 东坡区 , attributes: 1, 103.84888445900003, 30.081410367000046, 眉山市东坡区双成塑料化工有限公司, 企事业单位, 眉山市, 东坡区 , attributes: 30, 103.98681435200007, 30.609030073000042, 西南航空房地产开发公司, 企事业单位, 成都市, 双流县 A.3.3 周边搜索（缓冲区搜索）接口 A.3.3.1 个数统计接口 a) 服务网址示例 earchCount?centerX=104.094¢erY=30.691&
19、radius=10000&typeCode=zf&Token=* *(用户生成的 Token)&pretty=true b) 输出结果示例 DB51/T 19352014 47 返回 JSON 格式的周边搜索个数统计信息，结果示例见 A.3.2。 A.3.3.2 返回搜索结果接口 a) 服务网址示例 h/BufferSearch?centerX=104.094¢erY=30.691&radius=10000&typeCode=zf&Token=* *(用 户生成的 Token)&p retty=true b) 输出结果示例 返回 JSON 格式的周边搜索结果信息，结果示例见 A.3.2
20、。 A.3.4 WFS-G 接口 a) 服务网址示例 ken=* (用户生成的To ken) ×tamp=2012-12-20 b) 输出结果示例 输出结果见 OGC 04-094。 A.4 路径分析服务接口 A.4.1 元数据接口 a) 服务网址示例 Server?f=JSON&pretty=true&Token=* (用户生成的 Token) b) 输出结果示例 返回 JSON 格式的路径分析元数据信息，结果示例如下： success:true, version:3.0.0.0, description:null, message: name:最短路径分析, descriptio
21、n:最短路径分析, fullExtent: xmin:96.8064823674966,ymin:25.6809610658065, xmax:109.125227982208,ymax:34.7521540875866 , powerColumnNames: columnName:power, description:走高速路 , columnName:length, description:路径最短 DB51/T 19352014 48 A.4.2 最优路径分析接口 a) 服务网址示例 h?StartX=103.717&starty=30.97&stopx=104.299&stopy=30
22、.638&powerColumnName=power&re turnDirection=true&VIAPoints=points:104.093,30.701&BarriesLocation=poin ts:104.111,30.821&Token=*(用户生成的 Token) b) 输出结果示例 返回 JSON 格式的最优路径分析结果信息，结果示例如下： success:true, version:3.0.0.0, description:null, message: route: paths:103.716960405,30.969958598999998, 103.716901922,
23、30.970014532, 103.716843985,30.970076701, 103.716778103,30.970135018, 104.298614272,30.634594141999997, 104.298725703,30.634585191 , directions: decription:Start at start, length:0, cumulativeLength:0, dircetionLocation: x:103.717,y:30.97 , decription:Go northwest on 祥园路 toward 聚源-土桥, length:0.85566
24、737576366192, cumulativeLength:0, dircetionLocation: x:103.71696040461099,y:30.969958599415076 , decription:Turn right on 聚源-土桥, length:0.46734542204966129, DB51/T 19352014 49 cumulativeLength:0.85566737576366192, dircetionLocation: x:103.712504532,y:30.975406668999998 , decription:Turn left on 成灌高速
25、公路, length:9.2089344577372216, cumulativeLength:4.6917953309938421, dircetionLocation: x:103.757649256,y:30.947809996 A.5 数据查询服务接口 A.5.1 元数据接口 a) 服务网址示例 r?f=JSON&pretty=true&Token=*(用户生成的Token) b) 输出结果示例 返回 JSON 格式的数据查询元数据信息，结果示例如下： success:true, version:3.0.0.0, description:null, message: mapName:动
26、态地图服务, description:动态地图服务, mapUnits:Degrees, fullExtent: xmin:96.8064823,ymin:25.68096106, xmax:109.1252279,ymax:34.75215408 , geometryType: name:point, description:单点对象 , name:line, description:单线对象 DB51/T 19352014 50 , name:polyline, description:多段线对象 , name:polygon, description:单面对象 , spatialRel:
27、 name:SPATIALRELINTERSECTS, description:交叉查询方式 , name:SPATIALRELCONTAINS, description:被包含查询方式 , name:SPATIALRELOVERLAPS, description:重叠查询方式 , name:SPATIALRELWITHIN, description:包含查询方式 , featureLayerInfos : 0: layerId:0, layerName:YiDong2, layerType:FeatureLayer, visibled:true, maxVisible:1.797693134
28、8623157E+308, minVisible:0, parentLayerId:-1, subLayerIds:, srid:-1, fullExtent: xmin:101.54538211178738,ymin:26.495325705326252, xmax:107.50446521799881,ymax:32.448951277984293 , geometryType:Point, fieldsInfo: columnName:CODE, dataType:Object, caption:CODE , DB51/T 19352014 51 columnName:borough,
29、dataType:String, caption:borough , 2: layerId:2, layerName:成都道路, layerType:FeatureLayer, visibled:false, maxVisible:1.7976931348623157E+308, minVisible:0, parentLayerId:-1, subLayerIds:, srid:-1, fullExtent: xmin:104.01192319600006,ymin:30.627271483000072, xmax:104.19449304700004,ymax:30.76405550400
30、0055 , geometryType:Polyline, fieldsInfo: columnName:OBJECTID, dataType:Object, caption:OBJECTID , columnName:名称, dataType:String, caption:名称 supportVersion:false A.5.2 历史版本元数据接口 a) 服务网址示例 ns?Token=*(用户生成的Tok en)&startTime=2012-01-20&stopTime=2012- 03-20&layerid=0 DB51/T 19352014 52 b) 输出结果示例 返回 JSO
31、N 格式的数据查询服务历史版本描述信息，结果示例如下： success:true, version:3.0.0.0, description:null, message: layerVersionsInfo: layerid:0, verionsInfo: name:历史雨量1, timeStamp:2012/10/12 8:00:00, description:历史雨量 1, extents: subName:11, extent: xmin:97,ymin:25.5,xmax:109,ymax:35 , subName:22, extent: xmin:97,ymin:25.5,xmax:
32、109,ymax:35 , name:历史雨量2, timeStamp:2012/10/12 9:00:00, description:历史雨量 2, extents: subName:11, extent: xmin:97,ymin:25.5,xmax:109,ymax:35 , subName:22, extent: xmin:97,ymin:25.5,xmax:109,ymax:35 , layerid:2, verionsInfo: name:历史雨量1, timeStamp:2012/10/12 8:00:00, description:历史雨量 1, extents: subNam
33、e:11, DB51/T 19352014 53 extent: xmin:97,ymin:25.5,xmax:109,ymax:35 , subName:22, extent: xmin:97,ymin:25.5,xmax:109,ymax:35 , name:历史雨量2, timeStamp:2012/10/12 9:00:00, description:历史雨量 2, extents: subName:11, extent: xmin:97,ymin:25.5,xmax:109,ymax:35 , subName:22, extent: xmin:97,ymin:25.5,xmax:10
34、9,ymax:35 A.5.3 数据搜索接口 a) 服务网址示例 a?layerID=0&geometryType=Polygon&geometry=rings:105.15,28.84,105.15,28.82 ,105.18,28.82,105.18,28.84,105.15,28.84&spatialRel=spatialRelIntersects &whereClause=&returnGeometry=true&outFields=name,pac&Token=*(用户生成的 Token)×tamp=2012-12-20 b) 输出结果示例 1) 返回查询格式统计示例 当
35、onlyReturnFe atureCount为 true 时，返回 JSON格式的查询统计结果如下： success:true, version:3.0.0.0, description:null, message: columns: columnName:FeatureCount, dataType:Integer, caption:FeatureCount , columnName:MaxFeatureCount, dataType:Integer, DB51/T 19352014 54 caption:MaxFeatureCount , features: rowId:1, attri
36、butes: 18503, 500 2) 返回查询结果示例 当 onlyReturnFeat ureCount为 false时，返回 JSON 格式的查询结果如下： success:true, version:3.0.0.0, description:null, message: bufferGeometry: returnData: columns: columnName:OBJECTID, dataType:Integer, caption:OBJECTID , columnName:DIANHUA, dataType:String, caption:电话 , features: rowI
37、d:18503, geometryType:Point, geometry: x:105.17509179800004, y:28.820039084000086 , attributes: 18503, BA, DB51/T 19352014 55 0, 红花田, 红花田, , 511523, , null, , A.5.4 数据缓冲区查询接口 a) 服务网址示例 rch?layerID=0&geometryType=Polygon&geometry=rings:105.15,28.84,105.15,28. 82,105.18,28.82,105.18,28.84,105.15,28.84
38、&radius=1000&spatialRel=spatia lRelIntersects&whereClause=&returnGeometry=true&outFields=name,pac&Token=* *(用户生成的 Token) ×tamp=2012-12-20 b) 输出结果示例 1) 返回查询格式统计示例 当 onlyReturnFe atureCount为 true 时 ，返回 JSON格式的查询统计结果见 A.5.3。 2) 返回查询结果示例 当 onlyReturnFe atureCount为 false时，返回 JSON 格式的查询结果见 A.5.3。 A.5
39、.5 WFS接口 a) 服务网址示例 =*(用户生成的 Token) ×tamp=2012-12-20 b) 输出结果示例 输出结果见 OGC 04-094。 A.6 动态地图服务接口 A.6.1 元数据接口 a) 服务网址示例 ?f=JSON&Token=*(用户生成的 Token)&p retty=true b) 输出结果示例 返回 JSON 格式的动态地图服务元数据信息，结果示例如下： DB51/T 19352014 56 success:true, version:3.0.0.0, description:null, message: mapName:动态地图服务, desc
40、ription:动态地图服务, canIdentifyMap:true, canSearchData:true, mapUnits:Degrees, supportFormat: image/jpeg, image/png , fullExtent: xmin:96.8064823,ymin:25.68096106, xmax:109.1252279,ymax:34.75215408 , layerInfos: 0: layerId:0, layerName:YiDong2, layerType:FeatureLayer, visibled:true, maxVisible:1.7976931
41、348623157E+308, minVisible:0, parentLayerId:-1, subLayerIds:, srid:-1, fullExtent: xmin:101.54538211178738,ymin:26.495325705326252, xmax:107.50446521799881,ymax:32.448951277984293 , geometryType:Point, fieldsInfo: columnName:CODE, dataType:Object, caption:CODE , columnName:borough, dataType:String,
42、caption:borough DB51/T 19352014 57 , 2: layerId:2, layerName:成都道路, layerType:FeatureLayer, visibled:false, maxVisible:1.7976931348623157E+308, minVisible:0, parentLayerId:-1, subLayerIds:, srid:-1, fullExtent: xmin:104.01192319600006,ymin:30.627271483000072, xmax:104.19449304700004,ymax:30.764055504000055 , geometryType:Polyline, fieldsInfo: columnName:OBJECTID, dataType:Object, caption:OBJECTID , columnName:名称, dataType:String, caption:名称 supportVersion: false A.6.2 动态地图接口 a) 服务网址示例 yers=0,1,2&bbox=xmin:104.0119,ymin:30.6272,xmax:104.19449,ymax:30.764055 &width=500&height=500&format=
