1、ICS 35.240.99 L 67 DB37 山东省地方标准 DB37/T 29842017 海洋与渔业数据服务接口规范 2017-08-18发布 2017-09-18实施 山东省质量技术监督局 发布 DB37/T 29842017 目 次 前言 . III 1 范围 . 1 2 规范性引用文件 . 1 3 术语和定义 . 1 4 服务请求响应规则 . 2 4.1 服务请求规则 . 2 4.2 服务响应规则 . 3 5 服务接口和参数命名规则 . 3 5.1 命名原则 . 3 5.2 参数顺序和大小写 . 3 5.3 参数列表 . 3 5.4 服务异常 . 4 6 数据目录服务接口 . 4
2、6.1 概述 . 4 6.2 服务接口的操作 . 4 6.3 服务请求与响 应 . 4 7 基础地理数据服务接口 . 7 7.1 概述 . 7 7.2 服务接口的操作 . 7 7.3 服务请求与响应 . 7 8 数据访问服务接口 . 9 8.1 概述 . 9 8.2 空间数据访问服务规范 . 9 8.3 非空间数据访问服务规范 . 11 9 数据维护服务接口 . 12 9.1 概述 . 12 9.2 空间数据操作服务规范 . 13 9.3 非空间数据维护服务规范 . 15 参考文献 . 18 I DB37/T 29842017 前 言 本标准按照 GB/T 1.12009给出的规则起草。 本标
3、准由山东省海洋与渔业厅提出。 本标准由山东省信息标准化技术委员会归口。 本标准起草单位：山东省海洋与渔业信息宣传中心、山东省国土测绘院、山东省标准化研究院。 本标准主要起草人：徐国强、张伟、孟静涛、张欣、孙振喜、李飞、韩海丰、高浠舰、路洪贵、丁 志习、隗玉凯、张媛、刘博、李晓璇、史富涛。 II DB37/T 29842017 海洋与渔业数据服务接口规范 1 范围 本标准规定了山东省海洋与渔业数据服务请求响应规则、服务接口和参数命名规则、基础地理数据 服务接口、数据目录服务接口、数据访问服务接口、数据维护服务接口等内容。 本标准适用于海洋与渔业数据服务的访问、维护和相关应用系统的建设与管理。 2
4、 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 ISO 19119:TBD, Geographic information - Services ISO 19105:2000, Geographic information - Conformance and Testing ISO 19115:2003, Geographic information Metadata GB/T 17694 地理信息 术语 OGC WMS Web地图服务接口规范（OpenGIS W
5、eb Map Service Implementation Specification ， WMS，V1.3.0） OGC WCS Coverage服务规范 (OpenGIS Web Coverage Service Implementation Specification， WCS，V1. 1.2) OGC WFS 要素服务规范 (OpenGIS Web Feature Service Implementation Specification，WFS ， V1.1.0) OGC CSW 基于 Web的目录服务规范（ OpenGIS Catalogue Service Implementati
6、on Specification， CSW，V2.0.2） OGC WPS Web空间处理分析服务规范 (OpenGIS Web Processing Service， WPS， V1.0.0) OGC切片地图服务规范（ Web Map Tile Service） W3C Web Services Description Language (WSDL) 1.1, W3C Note 15 March 2001 3 术语和定义 3.1 操作 使得一个对象被调用执行的转换或查询的定义 ISO19119。 3.2 接口 由体现一个实体行为特征的操作组成的具有给定名称的集合ISO19119 。 3.3
7、1 DB37/T 29842017 服务 由实体通过接口提供的明确的功能ISO19119 。 3.4 功能XML 描述一个服务实例可用的操作和内容的服务级元数据。 3.5 元数据 描述数据及其环境的 数据，包括 描述要素、数据集或数据集系列的内容、覆盖范围、质量、管理方 式、数据的所有者、数据的提供方式等有关的信息。 3.6 服务元数据 描述一个服务的操作和地理信息变量的元数据。 3.7 URI 统一资源标识符（Uniform Resource Identifier)是一个用于标识某一互联网资源名称的字符串。 该种标识允许用户对任何（包括本地和互联网）的资源通过特定的协议进行交互操作。 4 服
8、务请求响应规则 4.1 服务请求规则 4.1.1 概述 服务接口一律支持通用的 HTTP请求规则，包括常用的两个请求方法：GET 和POST 。两种方法中的任 一种方法都可以用来描述特定的服务类型，并且由服务实例提供，服务接口可以选择实现其中一种，或 者二者全部定义和实现。 4.1.2 HTTP GET 用于HTTP GET请求的在线资源 URL事实上仅仅是一个URL前缀，为了建立一个有效的操作请求，在其 后还添加了另外的参数。 URL前缀被定义为一个不透明的字符串，它包括协议、主机名、端口号（可选）、 路径、和一个问号“？”，还可以包括一个或几个用于具体服务器的参数并以“ 表示出 现 0 次
9、或任意次 . 前缀完全由服务提供者控制。 name=valueversion=3.1 8 数据访问服务接口 8.1 概述 数据访问接口用于海洋与渔业 用户 对平台整合的各类数据服务的浏览、查询、访问。 其中空间数据访问服务接口基于标准的 WMS服务，支持空间数据服务的访问、查询、展示。 非空间数据访问服务基于标准的 WebService服务，按照服务接口指定的查 询条件，返回特定信息。 8.2 空间数据访问服务规范 空间数据访问规范 ， 定义了 Web客户端从网络地图服务器获取地图的接口标准。该规范应符合OGC WMS Web地图服务接口规范的规定，可以动态地生成具有地理参考数据的地图，这些地
10、图通常用GIF 、 JPEG或 PNG等图像格式，或者 SVG、 KML、 VML和WebCGM 等矢量图形格式来表现。使用者通过指定的参数获 取相应的地图图片。 8.2.1 服务接口的操作 空间数据访问服务由三个基础性操作协议 (GetCapabilities，GetMap 和GetFeatureInfo)组成，这 些协议 实现了对 不同来源的远程异构地图服务的展示和访问 。服务操作列表如表 11所示。 表11 空间数据访问服务操作列表 序号 操作 实现要求 描述 1 GetCapabilities 强制实现 获取 WMS 的能力文档（即元数据文档），里面包含服务的所有信息 2 GetMap
11、 强制实现 获取地图图片。该操作根据客户端发出的请求参数在服务端进行检索，服务 器端返回一个地图图像，其地理空间参数和大小参数是已经明确定义的，返 回的地图图像可以是 GIF、JPEG 、PNG 或 SVG 格式。 3 GetFeatureInfo 选择实现 该操作根据用户所请求的 X、 Y 坐标或感兴趣的图层，返回地图上某些特殊要 素的信息，信息以 HTML， GML 或 ASCII 的格式表示。 8.2.2 服务请求与响应 8.2.2.1 GetCapabilities操作 空间数据访问服务的 GetCapabilities操作的请求参数如表 12所示。 表12 空间数据访问服务GetCa
12、pabilities操作的请求参数 序号 参数名称 参数个数 参数类型和值 1 service 1 个( 必选 ) 字符类型，服务类型值为“WMS” 2 request 1 个( 必选 ) 字符类型，请求的操作名称，值为“GetCapabilities” 9 DB37/T 29842017 表12 空间数据访问服务GetCapabilities操作的请求参数（续） 序号 参数名称 参数个数 参数类型和值 3 version 0 或 1 个( 可选 ) 字符类型，值为请求的 WMS 的版本号，本平台为 1.3.0 4 format 0 或 1 个( 可选 ) MIME 类型，值为服务元数据的输出
13、格式 5 updateSequence 0 或 1 个( 可选 ) 字符类型，可取的值有 none、 any、 equal、 lower、 higher，用来表示缓 存数据更新的方式 空间数据访问服务GetCapabiliti es操作的请求 URL如下所示，该操作返回 XML格式的服务元数据文 档，通过该文档用户能够了解： 该地图服务器支持的所有操作接口列表； GetMap 操作返回的地图格式； 可用的坐标参照系统列表； 操作异常信息的列表； 该地图服务提供方的信息； 该地图服务的可用图层以及可选样式的列表； 该地图服务是否支持可选的 GetFeaturelnfo 操作等。 服务请求示例如下
14、： http:/*.*.*.*/serviceaccess/wms/hyyt?request=GetCapabilities&service=WMS&version=1.3 .0 8.2.2.2 GetMap操作 空间数据访问服务的 GetMap操作中强制实现的参数及其具体含义如表 13所示。 表13 空间数据访问服务GetMap操作的请求参数 序号 参数名称 参数个数 参数类型和值 1 service 1 个( 必选 ) 字符类型，服务类型标识值为“WMS” 2 request 1 个( 必选 ) 字符类型，值为“GetMap” 3 version 1 个( 必选 ) 字符类型，值为请求的
15、WMS 的版本号，本平台为 1.1.1 4 layers 1 个( 必选 ) 字符类型，值为一个或多个地图图层列表，多个图层之间用”,”隔开 5 styles 1 个( 必选 ) 字符类型，值为请求图层的地图渲染样式 6 CRS 1 个( 必选 ) 字符类型，值为坐标参照系统 7 BBOX 1 个( 必选 ) 字符类型，值为某个 CRS 下的地图边界范围的坐标序列 8 width 1 个( 必选 ) 整型类型，值为地图图片的像素宽度 9 height 1 个( 必选 ) 整型类型，值为地图图片的像素高度 10 format 1 个( 必选 ) 字符类型，值为地图的输出格式 11 transpa
16、rent 0 或 1 个 (可选 ) 字符类型，值为 true 或者 false，用来表示地图图层是否透明( 默认情况下是 不透明的) 12 bgcolor 0 或 1 个 (可选 ) 值为十六进制的 RGB 值，表示地图的背景颜色 13 exceptions 0 或 1 个 (可选 ) 值为 WMS 的异常信息报告的格式( 默认情况下是 XML 格式 ) 14 time 0 或 1 个 (可选 ) 时间类型，值为时间值，表示需要在图层中有时间信息 15 elevation 0 或 1 个 (可选 ) 数字类型，值为高程值，表示需要在图层中有高程信息 10 DB37/T 29842017 每一
17、个 GetMap请求返回的是对应地图的一个图层或多个图层融合图层，对相 同坐标参照系统下同一 区域内的不同地图进行多次GetMap请求可以得到多个图层，通过 TRANSPARENT参数设置获得图层的透明 效果，从而实现多个要素层的叠加。对一个空间数据访问服务的 GetMap操作的请求 URL如下所示，其中 6 表示请求的是第 6个图层，使用的地图渲染样式是 default， EPSG:4610代表 XIAN80坐标系。 服务请求示例如下： http:/*.*.*.*/serviceaccess/wms/road?version=1.1.1&request=GetMap&service=WMS&
18、srs=EP SG:4610&bbox=105.912744307755,22.87157813349547,132.66149210966523,27.82097636986866&laye rs=6&styles=default&format=image/png&width=1216&height=225&bgcolor=ffffff&transparent=tru e&exceptions=applicatio/vnd.ogc.se_xml 8.2.2.3 GetFeatureInfo操作 GetFeatureInfo操作的 请求参数及其具体含义如表 14所示。 表14 空间数据访问服务
19、GetFeatureInfo操作的请求参数 序号 参数名称 参数个数 参数类型和值 1 service 1 个( 必选 ) 字符类型，服务类型标识值为“WMS” 2 request 1 个( 必选 ) 字符类型，值为“GetFeatureInfo” 3 version 1 个( 必选 ) 字符类型，值为请求的 WMS 的版本号 4 map request part 1 个( 必选 ) 字符类型，值为获得地图的部分操作参数 5 query_layers 1 个( 必选 ) 字符类型，值为查询的一个或多个地图图层列表，多个图层之间用 “,” 隔开 6 info_format 1 个( 必选 ) M
20、IME 类型，值为请求信息的返回类型 7 I 1 个( 必选 ) 整型类型，值为待查询点的在地图图片上的像素列号 8 J 1 个( 必选 ) 整型类型，值为待查询点的在地图图片上的像素行号 9 feature_count 0 或 1 个 (可选 ) 整型类型，值为返回信息中的要素的个数( 默认是 1) 10 exceptions 0 或 1 个 (可选 ) 值为 WMS 的异常信息报告的格式( 默认情况下是 XML 格式 ) 服务请求示例如 下： http:/*.*.*.*/serviceaccess/wms?version=1.3.0&request=getfeatureinfo&layer
21、s=topp:sta tes&styles=population&SRS=EPSG:4326&bbox=-125,24,-67,50&width=400&height=200&format=text/ html&I=100&J=100&query_layers=topp:states 8.3 非空间数据访问服务规范 非空间数据访问服务基于标准的WebService 服 务规范，用于实现对海洋与渔业业务中非空间数据 的访问。 8.3.1 数据访问机制 各业务数据在数据库中按逻辑分别存储，针对各访问需求，建立数据视图，在数据视图的基础 上，基于标准WebService 服务提供数据访问接口，通过中
22、间数据视图的形式实现数据访问。如图 1。 11 DB37/T 29842017 图1 数据访问机制 8.3.2 服务请求与响应 8.3.2.1 通讯方式 数据 访问 接口采用http 通讯协议进行同步通讯。 接口服务程序部署于 web服务器上，通过 Intranet/Internet/专线对外围系统提供查询服务 。 8.3.2.2 服务请求规则 支持SOAP、POST、 GET中至少一项请求方式，请求参数按照各业务数据访问接口需求进行设定。请 求报文以XML 标签形式进行封装， XML中各节点元素按照参数进行命名。如请求2013年海洋渔业年收入的 示例： WebService地址： http:
23、/*.*.*.*/hyjj/GetList_yy? 报文范例： 20139 其中year元素代表请求参数年份， type元素代表请求参数海洋渔业年收入。 8.3.2.3 服务响应规则 服务请求响应后返回XML 格式的报文，报文格式类似请求报文，这里不再赘述。其中各字段若无特 别说明均为 char型，日期字段默认格式为 “yyyyMMdd”，例 2013-04-15，报文内容为 20130415。时间字段 默认格式为 “HHmmss”，例如 16:25:16，报文内容为 162516。 9 数据维护服务接口 9.1 概述 12 DB37/T 29842017 数据维护服务接口用于海洋与渔业 用户
24、 对已注册的各类数据的增删改等维护操作。 其中空间数据维护服务接口应符合 OGC WFS要素服务规范和 OGC WPS Web空间处理分析服务规范的规 定，支持空间数据的增删改操作。 非空间数据维护服务接口应符合 W3C Web Services Description Language (WSDL) 1.1的规定，支 持海洋与渔业业务属性数据的维护操作。 9.2 空间数据操作服务规范 空间数据操作服务规范应符合 OGC WFS要素服务规范的规定，主要对简单要素的数据编辑操作进行 规范，从而使服务器端和客户端能够在要素层面进行“ 通讯” 。其返回结果的是XML格式的服务元数据文 档，通过该文档
25、用户能够了解：服务器支持的所有操作操作列表，GetFeature 操作返回的数据格式， 可用的坐标参照系统列表，操作异常信息的列表，服务提供方的相关信息，服务器的可用要素类列表 等。 9.2.1 服务接口的操作 空间数据操作 服务接口规范定义了GetCapabilities ， DescribeFeatureType、 GetFeature、 Transaction 、 GetGmlObject 和 LockFeature 一共 6 种操作。其中，前三个 GetCapabilities ， DescribeFeatureType和GetFeature为必须实现的操作。 服务 的 详细 操作如表
26、 15所示。 表15 空间数据操作服务的接口列表 序号 操作 实现要求 描述 1 GetCapabilities 强制实现 获取能力文档（即元数据文档），它是对服务信息内容和请求参数的一种 描述，使用 XML 形式表示 2 DescribeFeatureType 强制实现 获取指定 FeatureType 元数据的描述信息，以 schema 形式返回 3 GetFeature 强制实现 获取指定参数要求（图层命名空间及名称、过滤条件、返回字段）的要素 数据，以 GML 形式返回 4 Transaction 选择实现 允许 Transaction 操作，使客户端可对服务器端所提供的地图要素类执行
27、 插入，更新，删除等命令 5 GetGmlObject 选择实现 通过 XLink 获取 GML 对象 6 LockFeature 选择实现 在事务过程中锁定要素 9.2.2 服务请求与响应 各操作都要求实现KVP （keyword- value pair，键值对）编码和 XML编码。前者对应 HTTP GET请求方 式，后者使用HTTP POST 请求方式。 9.2.2.1 GetCapabilities操作 该操作的请求参数，与数据访问服务GetCapabilities的请求参数相似，所示为KVP和 XML两种编码 方式的 GetCapabilities操作请求示例。 GetCapabil
28、ities操作的返回结果的是XML 格式的服务元数据文档，通过该文档用户能够了解：服务 器支持的所有操作接口列表， GetFeature操作返回的数据格式，可用的坐标参照系统列表，操作异常信 息的列表，服务提供方的相关信息，服务器的可用要素类列表，该服务是否支持WFS -T操作等。 13 DB37/T 29842017 表16 GetCapabilities操作请求参数 序号 参数名称 参数个数 参数类型和值 1 service 1 个( 必选 ) 字符类型，服务类型值为“WFS” 2 request 1 个( 必选 ) 字符类型，请求的操作名称，值为“GetCapabilities” 3 v
29、ersions 0 或 1 个( 可选 ) 字符类型，值为请求的 WFS 的版本号 表17 KVP和XML两种编码方式的GetCapabilities操作请求示例 序号 编码方式 GetCapabilities 操作请求示例 1 KVP http:/*/wfs.cgi?VERSION=1.1.0&SERVICE=WFS&REQUEST=GetCapabilities 2 XML 9.2.2.2 DescribeFeatureType操作 在DescribeFeatureType 操作中，需要考虑输出文档的 编码格式，必须实现 GML编码格式，其他的输 出格式为可选实现，同时也要在Capabil
30、ities文档中给予说明。DescribeFeatureType操作的请求参数 及编码如表 18所示。 表18 DescribeFeatureType操作请求参数 序号 参数名称 参数个数 参数类型和值 1 service 1 个( 必选 ) 字符类型，服务类型值为“WFS” 2 request 1 个( 必选 ) 字符类型，请求的操作名称，值为“DescribeFeatureType” 3 typeName 0 或 1 个 (可选 ) 字符类型，值为要素类型的列表，多个值之间用“，”隔开，默认解析包 括的全部要素类型 4 outputFormat 0 或 1 个 (可选 ) MIME 类型，
31、值为输出格式 下表是 KVP和XML 两种编码方式的 DescribeFeatureType操作请求示例，返回的结果是以XML 形式的要 素类的元数据描述文档，包括该要素类的名称空间、属性名称及数据类型、要素的几何类型等信息。 表19 DescribeFeatureType操作请求示例 序号 编码方式 DescribeFeatureType 操作请求示例 1 KVP http:/*.*.*.*/wfs.cgi?SERVICE=WFS&VERSION=1.1.0&REQUEST=DescribeFeatureType&TYPENAM E=TreesA_1M 2 XML topp:states 1
32、4 DB37/T 29842017 9.2.2.3 GetFeature操作 GetFeature操作的请求参数以及每个参数的默认类型和含义描述如表20 所示。 表20 GetFeature操作请求参数 序号 参数名称 参数个数 参数类型和值 1 service 1 个( 必选 ) 字符类型，服务类型标识值为“WFS” 2 request 1 个( 必选 ) 字符类型，请求的操作值为“GetFeature” 3 typeName 1 个( 必选 ) 字符类型，值为请求的要素类型的名称，多个名称之间用“，”隔开 4 version 0 或 1 个( 可选 ) 字符类型，值为请求的 WFS 的版本
33、号 5 outputFormat 0 或 1 个( 可选 ) MIME 类型，值为输出格式 6 resultType 0 或 1 个( 可选 ) 字符类型，值为请求的结果类型 7 propertyName 0 或 1 个( 可选 ) 字符类型，值为请求要素的属性名，多个值之间用“，”隔开 8 featureVersion 0 或 1 个( 可选 ) 字符类型，值为要素的版本，值为 ALL 返回请求的要素的所有版本，没有 值默认为返回请求要素的最新版本 9 maxFeature 0 或 1 个( 可选 ) 整型类型，值为请求要素的最大数，默认值为满足查询的所有结果集 10 expiry 0 或
34、1 个( 可选 ) 数字类型，要素被锁定的时间 11 SRSName 0 或 1 个( 可选 ) 字符类型，值为坐标系统名 12 featureID 0 或 1 个( 可选 ) 字符类型，值为要素的 ID，多个 ID 之间用“，”隔开 13 filter 0 或 1 个( 可选 ) 请求要素的过滤条件 14 bBox 0 或 1 个( 可选 ) 字符类型，请求指定要素查询范围，可以替代 featureId 和 filter 参数 15 sortby 0 或 1 个( 可选 ) 字符类型，查询结果属性值的排序依据 表21是KVP 和XML 两种编码方式的GetFeature操作请求示例，返回的结
35、果是GML形式的要素类文档， 包括该要素类中各符合查询条件要素的属性数据、定位数据等信息，要素类的结构在 GML规范中的有详 细介绍。 表21 GetFeature操作请求示例 序号 编码方式 GetFeature 操作请求示例 1 KVP http:/*.*.*.*/wfs.cgi&SERVICE=WFS&VERSION=1.1.0&REQUEST=GetFeature&PROPERTYNAME=InWa terA_1M/wkbGeom， InWaterA_1M/tileId&TYPENAME=InWaterA_1M 2 XML 9.3 非空间数据维护服务规范 15 DB37/T 29842
36、017 非空间数据维护服务应符合W3C Web Services Description Language (WSDL) 1.1的规定，用于实 现对海洋与渔业业务中非空间数 据的增删改等维护操作。 9.3.1 数据维护机制 非空间数据维护接口提供增加，删除，修改等维护功能，各功能对应于数据库中 insert,delete,update等操作，数据库中以时间戳及历史库的形式保存修改历史，保证数据的可追溯 性。如图 2。 图2 数据维护机制 9.3.2 服务请求与响应 9.3.2.1 通讯方式 数据 访问 接口采用http 通讯协议进行同步通讯。 接口服务程序部署于 web服务器上，通过 Intr
37、anet/Internet/专线对外围系统提供查询服务 。 9.3.2.2 服务请求规则 请求报文以 XML标签形式进行封装， XML中至少要包括操作类型（增加/删除 /修改），以及其对应操 作的请求参数。如更新2015 年海洋渔业从业人数为1000 的示例： WebService地址： http:/*.*.*.*/hyjj/Modify_yy? 报文范例： update2015191000 其中op 代表维护操作为更新，year代表请求参数年份，type代表更新类型为海洋渔业从业人数， count代表更新数值。 9.3.2.3 服务响应规则 服务请求响应后返回 XML格式的报文，报文中至少要
38、有操作结果。例如 返回报文范例： 16 DB37/T 29842017 true10删除成功 代表对数据的删除操作成功，涉及条目10 条。 17 DB37/T 29842017 参 考 文 献 OGC 06-121r3, OpenGIS Web Services Common Specification OGC 03-105r1, OpenGIS Geography Markup Language (GML) Implementation Specification, Version 3.1, February 2004 OGC 04-092r4, OpenGIS Geography Mark
39、up Language (GML) Implementation Specification Schemas, Version 3.1.1 IETF RFC 2396 (August 1998), Uniform Resource Identifiers (URI): Generic Syntax, Berners-Lee, T., Fielding, N., and Masinter, L., eds., IETF RFC 2616 (June 1999), Hypertext Transfer Protocol HTTP/1.1, Gettys, J., Mogul, J., Frysty
40、k, H., Masinter, L., Leach, P., and Berners-Lee, T., eds., W3C Recommendation January 1999, Namespaces In XML, http:/www.w3.org/TR/2000/REC-xml-names. W3C Recommendation 04 February 2004, Extensible Markup Language (XML) 1.0 (Third Edition), http:/www.w3.org/TR/REC-xml W3C Recommendation 2 May 2001:
41、 XML Schema Part 0: Primer, http:/www.w3.org/TR/2001/REC-xmlschema-0-20010502/ W3C Recommendation 2 May 2001: XML Schema Part 1: Structures, http:/www.w3.org/TR/2001/REC-xmlschema-1-20010502/ W3C Recommendation 2 May 2001: XML Schema Part 2: Datatypes, http:/www.w3.org/TR/2001/REC-xmlschema-2-20010502/ W3C SOAP Version 1.2 Part 1: Messaging Framework, W3C Recommendation 24 June 2003 W3C SOAP 1.2 Attachment Feature, W3C Working Group Note 8 June 2004, _ 18
