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 资源描述 用户输入合法的
26、服务网址和参数，获取瓦片地图服务的标准OGC WMS服务。 6.5.2 网址格式 WMS服务请求网址应按以下格式： http:/host:port/WMS?Token=×tamp= DB51/T 19352014 10 6.5.3 输入参数 WMS服务请求输入参数按OGC 03-109r1执行，自定义输入参数说明： a) serverName:serverName:服务的虚拟目录名称，可为多级目录； b) token:token:用户生成的加密字符串,访问加密服务时必选该参数； c) timeStamp:timeStamp:历史服务时间点（如果服务支持历史查询），可选参数，默认为当前
27、最新的数据。标准输入法为：年-月-日 小时:分:秒(如 2011-12-24 13:34:45 或 2012/10/12 8:00:00),如果有不符合规定的时间格式，系统应自动报错。 6.5.4 输出结果 输出结果按OGC 03-109r1执行。 6.6 WMTS 接口 6.6.1 资源描述 用户输入合法的服务网址和参数，获取瓦片地图服务的标准OGC WMTS服务。 6.6.2 网址格式 WMTS服务请求网址应按以下格式： http:/host:port/WMTS?Token=& timestamp= 6.6.3 输入参数 WMTS服务请求输入参数按OGC 07-057r7执行，自定义输入参
28、数说明： a) serverName:serverName:服务的虚拟目录名称，可为多级目录； b) token:token:用户生成的加密字符串,访问加密服务时必选该参数； c) timeStamp:timeStamp:历史服务时间点（如果服务支持历史查询），可选参数，默认为当前最新的数据。标准输入法为：年-月-日 小时:分:秒(如 2011-12-24 13:34:45 或 2012/10/12 8:00:00)，如果有不符合规定的时间格式，系统应自动报错； 6.6.4 输出结果 输出结果按OGC 07-057r7执行。 7 地名搜索服务接口 7.1 总体描述 地名搜索服务是以标准的地名数
29、据为基础的地理信息服务，其接口内容包括：元数据接口、关键词搜索接口、周边搜索（缓冲区搜索）接口、WFS-G接口等。用户通过访问该类型的服务可研发地名地址快速搜索与展示、快速定位、分类搜索、周边缓冲搜索等功能模块。 7.2 元数据接口 7.2.1 资源描述 用户输入合法的服务网址和参数，获取地名搜索服务的元数据描述信息。 DB51/T 19352014 11 7.2.2 网址格式 元数据访问请求网址应按以下格式： http:/host:port/dataServer?f=&callback=&pretty=&Token= 7.2.3 输入参数 元数据访问接口输入参数内容与说明： a) serve
30、rName:serverName:服务的虚拟目录名称，可为多级目录； b) f:f:表示返回参数的格式，必选参数。如 f=JSON； c) pretty:pretty:表示是否使用格式化方式显示返回数据，可选参数； d) token:token:用户生成的加密字符串，访问加密服务时必选该参数； e) callback:callback:客户端要求返回的 JSONP 函数，可选参数，未输入则为 JSON 格式，反之则为 JSONP格式。 7.2.4 输出结果 元数据访问接口返回地名搜索服务元数据描述信息，输出结果与说明见表5。 表5 地名搜索服务元数据访问接口输出结果与说明 JSON 格式定义
31、说 明 ( success:, version:, description:, message: name:, description:, fullExtent: xmin:,ymin:, xmax:,ymax: , diQuName: pac:, name: , pac:, name: , nameType: type:, description: 如返回 JSONP,则有和括号 表示访问是否成功 表示软件版本 服务的描述信息 结果对象：返回数据集合对象或错误信息 地名搜索服务的名称 地名搜索服务的描述 该用户所能访问的地名搜索范围 范围的四至点值 四川省 21 个地市州行政区划代码和名称集
32、合 地区行政区划代码，四位：如 5101 地区名称 区县行政区划代码，六位：如 510104 区县名称 地名分类编码和描述信息集合(名称大类编码) 地名分类编码 地名分类的描述信息 DB51/T 19352014 12 , type:, description: ) 地名分类编码 地名分类的描述信息 7.3 关键词搜索接口 7.3.1 个数统计接口 7.3.1.1 资源描述 用户输入合法的服务网址和参数， 获取关键词搜索的个数统计信息， 用于分页显示时的总页数的控制。 7.3.1.2 网址格式 个数统计请求网址应按以下格式： http:/host:port/SearchCount?keynam
33、e=&DiQuKey=&QuXianKey=&typeCode=&SearchEnvelope=&Token=&pretty=&callback= 7.3.1.3 输入参数 个数统计接口输入参数内容与说明： a) serverName:serverName:服务的虚拟目录名称，可为多级目录； b) keyName:keyName:输入的模糊查询关键词，必选参数（与 typeCode 必选其一）。输入为 URL 编码的字符串,如%u516C%（公司的编码）； c) diQuKey:diQuKey:输入限定查询地区的编码，可选参数。如 5101 代表“成都”；不输入表示在用户可访问的范围内搜索；
34、d) quXianKey:quXianKey:输入限定查询地区的编码，可选参数。如 510101 代表“金牛区”；不输入表示在用户可访问的范围内搜索； e) searchEnvelope:searchEnvelope:搜索限定的范围框，可选参数。为 JSON 格式的 BoundingBox 几何对象，如xmin:96.80,ymin:25.680,xmax:109.12522,ymax:34.75； f) typeCode:typeCode:搜索的地名类型，可选参数。在地名搜索的元数据中有详细的类型描述(nameType对象中描述)，如 zf 表示“政府机构”； g) pretty:prett
35、y:表示是否使用格式化方式显示返回数据，可选参数； h) token:token:用户生成的加密字符串，访问加密服务时必选该参数； i) callback:callback:客户端要求返回的 JSONP 函数，可选参数，未输入则为 JSON 格式，反之则为 JSONP格式。 7.3.1.4 输出结果 个数统计接口返回搜索结果个数信息，输出结果与说明见表。 DB51/T 19352014 13 表6 地名搜索关键词搜索个数统计接口输出结果与说明 JSON 格式定义 说 明 ( success:, version:, description:, message: count:, 如返回 JSONP
36、,则有和括号 表示访问是否成功 表示软件版本 服务的描述信息 结果对象：返回数据集合对象或错误信息 统计个数 maxCount: ) 最大能输出结果的个数 注：统计个数为服务能查询的个数，对于搜索结果应有一个最大限值，当统计个数小于该限值时，Count和maxCount一样，反之，Count就大于maxCount，用于分页输出搜索结果时，程序只返回maxCount个结果 7.3.2 返回搜索结果接口 7.3.2.1 资源描述 用户输入合法的服务网址和参数，获取地名搜索服务关键词搜索结果。 7.3.2.2 网址格式 返回搜索结果请求网址应按以下格式： http:/host:port/Search
37、?keyname=&DiQuKey=&QuXianKey=&isOnlyName=&SearchEnvelope=&typeCode=&StartIndex=&StopIndex= 7.3.2.3 输入参数 返回搜索结果接口输入参数内容与说明： a) serverName:serverName:服务的虚拟目录名称。可为多级目录； b) keyName:keyName:输入的模糊查询关键词，必选参数（与 typeCode 必选其一）。输入为 URL 编码的字符串，如%u516C%（公司的编码）； c) diQuKey:diQuKey:输入限定查询地区的编码，可选参数。如 5101 代表“成都”；
38、不输入表示在用户可访问的范围内搜索； d) quXianKey:quXianKey:输入限定查询地区的编码，可选参数。如 510101 代表“金牛区”；不输入表示在用户可访问的范围内搜索； e) searchEnvelope:searchEnvelope:搜索限定的范围框，可选参数。为 JSON 格式的 BoundingBox 几何对象，如xmin:96.80,ymin:25.680,xmax:109.12522,ymax:34.75； f) isOnlyName:isOnlyName:是否只返回名称字段，True 表示只要求返回名称字段，False 表示要求返回所有属性字段。可选参数； g)
39、 typeCode:typeCode:搜索的地名类型，可选参数。在地名搜索的元数据中有详细的类型描述(nameType对象中描述)，如 zf 表示”政府机构”； h) startIndex:startIndex:该次返回搜索结果的起始记录 Index，可选参数。默认从 0 开始； DB51/T 19352014 14 i) stopIndex:stopIndex:该次返回搜索结果的终止记录 Index，可选参数。默认以最大搜索的个数结束（maxCount）； j) pretty:pretty:表示是否使用格式化方式显示返回数据，可选参数； k) token:token:用户生成的加密字符串，访
40、问加密服务时必选该参数； l) callback:callback:客户端要求返回的 JSONP 函数，可选参数，未输入则为 JSON 格式，反之则为 JSONP格式。 7.3.2.4 输出结果 搜索结果接口返回地名搜索服务关键词搜索结果信息，输出结果与说明见表7。 表7 地名搜索关键词搜索返回结果接口输出结果与说明 JSON 格式定义 说 明 ( success:, version:, description:, message: columns: columnName:, dataType:, caption: , . columnName:, dataType:, caption: ,
41、features: attributes: , , attributes: , 如返回 JSONP，则有和括号 表示访问是否成功 表示软件版本 服务的描述信息 结果对象：返回数据集合对象或错误信息 表示返回的字段集合表 字段名称 数据类型 字段别名 字段名称 数据类型 字段别名 表示返回数据要素的集合表 属性数据集合，其数据字段对应 columns 字段集合表一一对应 第一行，第一列的值 第一行，第 n 列的值 属性数据集合，其数据字段对应 columns 字段集合表一一对应 第 n 行，第一列的值 第 n 行，第 n 列的值 DB51/T 19352014 15 ) 7.4 周边搜索（缓冲区
42、搜索）接口 7.4.1 个数统计接口 7.4.1.1 资源描述 用户输入合法的服务网址和参数， 获取周边搜索(缓冲区搜索)的个数统计信息， 用于分页显示时的总页数的控制。 7.4.1.2 网址格式 个数统计请求网址应按以下格式： http:/host:port/BufferSearchCount?centerX=¢erY=&radius=&typeCode=&keyName=&pretty=&callback=&Token= 7.4.1.3 输入参数 个数统计接口输入参数内容与说明： a) serverName:serverName:服务的虚拟目录名称，可为多级目录； b) cente
43、rX:centerX:周边搜索中心点的 X 值，必选参数。单位为度，如 104.094； c) centerY:centerY:周边搜索中心点的 Y 值，必选参数。单位为度，如 30.691； d) radius:radius:搜索半径。单位为米，必选参数。单位为米，如 1000 米； e) typeCode:typeCode:搜索的地名类型，必选参数（与 keyname 必选其一）。在地名搜索的元数据中有详细的类型描述(nameType 对象中描述)，如 zf 表示”政府机构”； f) keyName:keyName:输入的模糊查询关键词，必选参数（与 typeCode 必选其一）。输入为
44、URL 编码的字符串，如%u516C%（公司的编码）； g) pretty:pretty:表示是否使用格式化方式显示返回数据，可选参数； h) token:token:用户生成的加密字符串，访问加密服务时必选该参数； i) callback:callback:客户端要求返回的 JSONP 函数，可选参数，未输入则为 JSON 格式，反之则为 JSONP格式。 7.4.1.4 输出结果 个数统计接口返回地名搜索服务周边搜索结果个数信息，输出结果与说明见表8。 表8 地名搜索服务周边搜索个数统计接口输出结果与说明 JSON 格式定义 说 明 ( success:, version:, descri
45、ption:, message: 如返回 JSONP，则有和括号 表示访问是否成功 表示软件版本 服务的描述信息 结果对象：返回数据集合对象或错误信息 DB51/T 19352014 16 count: maxCount: ) 统计个数 最大能输出结果的个数 注：统计个数为数据库能查询的个数，对于搜索结果应有一个最大限值，当统计个数小于该限值时，Count和maxCount一样，反之，Count就大于maxCount，用于分页输出搜索结果时，程序只返回maxCount个结果 7.4.2 返回搜索结果接口 7.4.2.1 资源描述 用户输入合法的服务网址和参数，获取地名搜索服务的周边搜索结果。
46、7.4.2.2 网址格式 返回搜索结果请求网址应按以下格式： http:/host:port/BufferSearch?centerX=¢erY=&radius=&typeCode=&keyName=&StartIndex=&StopIndex=&callback=&pretty=&Token= 7.4.2.3 输入参数 返回搜索结果接口输入参数内容与说明： a) serverName:serverName:服务的虚拟目录名称，可为多级目录； b) centerX:centerX:周边搜索中心点的 X 值，必选参数。单位为度，如 104.094； c) centerY:centerY:
47、周边搜索中心点的 Y 值，必选参数。单位为度，如 30.691； d) radius:radius:搜索半径。单位为米，必选参数。单位为米，如 1000 米； e) typeCode:typeCode:搜索的地名类型，必选参数（与 keyname 必选其一）。在地名搜索的元数据中有详细的类型描述(nameType 对象中描述)，如 zf 表示“政府机构”； f) keyName:keyName:输入的模糊查询关键词，必选参数（与 typeCode 必选其一）。输入为 URL 编码的字符串，如%u516C%（公司的编码）； g) startIndex:startIndex:该次返回搜索结果的起始
48、记录 Index，可选参数。默认从 0 开始； h) stopIndex:stopIndex:该次返回搜索结果的终止记录 Index，可选参数。默认以最大搜索的个数结束（maxCount）； i) token:token:用户生成的加密字符串，访问加密服务时必选该参数； j) pretty:pretty:表示是否使用格式化方式显示返回数据，可选参数； k) callback:callback:客户端要求返回的 JSONP 函数，可选参数，未输入则为 JSON 格式，反之则为 JSONP格式。 7.4.2.4 输出结果 搜索结果接口返回地名搜索服务周边搜索结果信息，输出结果与说明见表9。 DB5
49、1/T 19352014 17 表9 地名搜索服务周边搜索返回结果接口输出结果与说明 JSON 格式定义 说 明 ( success:, version:, description:, message: columns: columnName:, dataType:, 如返回 JSONP，则有和括号 表示访问是否成功 表示软件版本 服务的描述信息 结果对象：返回数据集合对象或错误信息 表示返回的字段集合表 字段名称 数据类型 caption: , columnName:, dataType:, caption: , features: attributes: , , attributes: ,
50、 ) 字段别名 字段名称 数据类型 字段别名 表示返回数据要素的集合表 属性数据集合，是一个数组，其数据字段对应 columns 字段集合表一一对应 第一行，第一列的值 第一行，第 n 列的值 属性数据集合，是一个数组，其数据字段对应 columns 字段集合表一一对应 第 n 行，第一列的值 第 n 行，第 n 列的值 7.5 WFS-G 接口 7.5.1 资源描述 用户输入合法的服务网址和参数，获取与地名搜索服务相关的OGC WFS-G服务。 7.5.2 网址格式 DB51/T 19352014 18 WFS-G服务请求网址应按以下格式： http:/host:port/WFSG?Toke
