1、ICS 35.240.99L 67DB 37山 东 省 地 方 标 准DB37/T XXXXXXXXX海洋与渔业数据服务接口规范XXXX-XX-XX 发布 XXXX-XX-XX 实施山 东 省 质 量 技 术 监 督 局 发 布DB37/T XXXXXXXXXI目 次前言 .III1 范围 12 规范性引用文件 13 术语和定义 14 服务请求响应规则 24.1 服务请求规则 24.2 服务响应规则 35 服务接口和参数命名规则 35.1 命名原则 35.2 参数顺序和大小写 35.3 参数列表 35.4 服务异常 46 数据目录服务接口 46.1 概述 46.2 服务接口的操作 46.3 服
2、务请求与响应 47 基础地理数据服务接口 77.1 概述 77.2 服务接口的操作 77.3 服务请求与响应 78 数据访问服务接口 98.1 概述 98.2 空间数据访问服务规范 98.3 非空间数据访问服务规范 .119 数据维护服务接口 .129.1 概述 .129.2 空间数据操作服务规范 .139.3 非空间数据维护服务规范 .15参考文献 18DB37/T XXXXXXXXXII前 言本标准按照GB/T 1.12009给出的规则起草。本标准由山东省海洋与渔业厅提出。本标准由山东省信息标准化技术委员会归口。本标准起草单位：山东省海洋与渔业信息宣传中心、山东省国土测绘院、山东省标准化研
3、究院。本标准主要起草人：徐国强、张伟、孟静涛、张欣、孙振喜、李飞、韩海丰、高浠舰、路洪贵、丁志习、隗玉凯、张媛、刘博、李晓璇、史富涛。DB37/T XXXXXXXXX1海洋与渔业数据服务接口规范1 范围本标准规定了山东省海洋与渔业数据服务请求响应规则、服务接口和参数命名规则、基础地理数据服务接口、数据目录服务接口、数据访问服务接口、数据维护服务接口等内容。本标准适用于海洋与渔业数据服务的访问、维护和相关应用系统的建设与管理。2 规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文
4、件。ISO 19119:TBD, Geographic information - ServicesISO 19105:2000, Geographic information - Conformance and TestingISO 19115:2003, Geographic information MetadataGB/T 17694 地理信息 术语OGC WMS Web地图服务接口规范（OpenGIS Web Map Service Implementation Specification，WMS，V1.3.0）OGC WCS Coverage服务规范 (OpenGIS Web Cov
5、erage 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 Implementation Specification，CSW，V2.0.2）OGC WPS Web空间处理分析服务规范(OpenGIS Web Processing Service，WPS，V1.0.0)OGC切片地图服务规范
6、（Web Map Tile Service）W3C Web Services Description Language (WSDL) 1.1, W3C Note 15 March 20013 术语和定义3.1 操作使得一个对象被调用执行的转换或查询的定义ISO19119。3.2 接口由体现一个实体行为特征的操作组成的具有给定名称的集合ISO19119。3.3 DB37/T XXXXXXXXX2服务由实体通过接口提供的明确的功能ISO19119。3.4 功能XML描述一个服务实例可用的操作和内容的服务级元数据。3.5 元数据描述数据及其环境的数据，包括描述要素、数据集或数据集系列的内容、覆盖范围
7、、质量、管理方式、数据的所有者、数据的提供方式等有关的信息。3.6 服务元数据描述一个服务的操作和地理信息变量的元数据。3.7 URI统一资源标识符（Uniform Resource Identifier)是一个用于标识某一互联网资源名称的字符串。该种标识允许用户对任何（包括本地和互联网）的资源通过特定的协议进行交互操作。4 服务请求响应规则4.1 服务请求规则4.1.1 概述服务接口一律支持通用的HTTP请求规则，包括常用的两个请求方法：GET和POST。两种方法中的任一种方法都可以用来描述特定的服务类型，并且由服务实例提供，服务接口可以选择实现其中一种，或者二者全部定义和实现。4.1.2
8、HTTP GET用于HTTP GET请求的在线资源URL事实上仅仅是一个URL前缀，为了建立一个有效的操作请求，在其后还添加了另外的参数。URL前缀被定义为一个不透明的字符串，它包括协议、主机名、端口号（可选）、路径、和一个问号“？”，还可以包括一个或几个用于具体服务器的参数并以“ 表示出现 0 次或任意次. 前缀完全由服务提供者控制。name=valueversion=3.18 数据访问服务接口8.1 概述数据访问接口用于海洋与渔业用户对平台整合的各类数据服务的浏览、查询、访问。其中空间数据访问服务接口基于标准的WMS服务，支持空间数据服务的访问、查询、展示。非空间数据访问服务基于标准的We
9、bService服务，按照服务接口指定的查询条件，返回特定信息。8.2 空间数据访问服务规范空间数据访问规范，定义了Web客户端从网络地图服务器获取地图的接口标准。该规范应符合OGC WMS Web地图服务接口规范的规定，可以动态地生成具有地理参考数据的地图，这些地图通常用GIF、JPEG或PNG等图像格式，或者SVG、KML、VML和WebCGM等矢量图形格式来表现。使用者通过指定的参数获取相应的地图图片。DB37/T XXXXXXXXX108.2.1 服务接口的操作空间数据访问服务由三个基础性操作协议(GetCapabilities，GetMap和GetFeatureInfo)组成，这些协
10、议实现了对不同来源的远程异构地图服务的展示和访问。服务操作列表如表11所示。表 11 空间数据访问服务操作列表序号 操作 实现要求 描述1 GetCapabilities 强制实现 获取 WMS 的能力文档（即元数据文档） ，里面包含服务的所有信息2 GetMap 强制实现获取地图图片。该操作根据客户端发出的请求参数在服务端进行检索，服务器端返回一个地图图像，其地理空间参数和大小参数是已经明确定义的，返回的地图图像可以是 GIF、JPEG、PNG 或 SVG 格式。3 GetFeatureInfo 选择实现该操作根据用户所请求的 X、Y 坐标或感兴趣的图层，返回地图上某些特殊要素的信息，信息以
11、 HTML，GML 或 ASCII 的格式表示。8.2.2 服务请求与响应8.2.2.1 GetCapabilities 操作空间数据访问服务的GetCapabilities操作的请求参数如表12所示。表 12 空间数据访问服务 GetCapabilities 操作的请求参数序号 参数名称 参数个数 参数类型和值1 service 1 个(必选) 字符类型，服务类型值为“WMS”2 request 1 个(必选) 字符类型，请求的操作名称，值为“GetCapabilities”表12 空间数据访问服务 GetCapabilities 操作的请求参数（续）序号 参数名称 参数个数 参数类型和值3
12、 version0 或 1 个(可选) 字符类型，值为请求的 WMS 的版本号，本平台为 1.3.04 format0 或 1 个(可选) MIME 类型，值为服务元数据的输出格式5 updateSequence0 或 1 个(可选) 字符类型，可取的值有 none、any、equal、lower、higher，用来表示缓存数据更新的方式空间数据访问服务GetCapabilities操作的请求URL如下所示，该操作返回XML格式的服务元数据文档，通过该文档用户能够了解：该地图服务器支持的所有操作接口列表；GetMap 操作返回的地图格式；可用的坐标参照系统列表；操作异常信息的列表；该地图服务提
13、供方的信息；该地图服务的可用图层以及可选样式的列表；该地图服务是否支持可选的 GetFeaturelnfo 操作等。服务请求示例如下：DB37/T XXXXXXXXX11http:/*.*.*.*/serviceaccess/wms/hyyt?request=GetCapabilities&service=WMS&version=1.3.08.2.2.2 GetMap 操作空间数据访问服务的GetMap操作中强制实现的参数及其具体含义如表13所示。表 13 空间数据访问服务 GetMap 操作的请求参数序号 参数名称 参数个数 参数类型和值1 service 1 个(必选) 字符类型，服务类型
14、标识值为“WMS”2 request 1 个(必选) 字符类型，值为“GetMap”3 version 1 个(必选) 字符类型，值为请求的 WMS 的版本号，本平台为 1.1.14 layers 1 个(必选) 字符类型，值为一个或多个地图图层列表，多个图层之间用”,”隔开5 styles 1 个(必选) 字符类型，值为请求图层的地图渲染样式6 CRS 1 个(必选) 字符类型，值为坐标参照系统7 BBOX 1 个(必选) 字符类型，值为某个 CRS 下的地图边界范围的坐标序列8 width 1 个(必选) 整型类型，值为地图图片的像素宽度9 height 1 个(必选) 整型类型，值为地图
15、图片的像素高度10 format 1 个(必选) 字符类型，值为地图的输出格式11 transparent0 或 1 个(可选) 字符类型，值为 true 或者 false，用来表示地图图层是否透明(默认情况下是不透明的)12 bgcolor0 或 1 个(可选) 值为十六进制的 RGB 值，表示地图的背景颜色13 exceptions0 或 1 个(可选) 值为 WMS 的异常信息报告的格式(默认情况下是 XML 格式)14 time0 或 1 个(可选) 时间类型，值为时间值，表示需要在图层中有时间信息15 elevation0 或 1 个(可选) 数字类型，值为高程值，表示需要在图层中有
16、高程信息每一个GetMap请求返回的是对应地图的一个图层或多个图层融合图层，对相同坐标参照系统下同一区域内的不同地图进行多次GetMap请求可以得到多个图层，通过TRANSPARENT参数设置获得图层的透明效果，从而实现多个要素层的叠加。对一个空间数据访问服务的GetMap操作的请求URL如下所示，其中6表示请求的是第6个图层，使用的地图渲染样式是default，EPSG:4610代表XIAN80坐标系。服务请求示例如下：http:/*.*.*.*/serviceaccess/wms/road?version=1.1.1&request=GetMap&service=WMS&srs=EPSG:
17、4610&bbox=105.912744307755,22.87157813349547,132.66149210966523,27.82097636986866&layers=6&styles=default&format=image/png&width=1216&height=225&bgcolor=ffffff&transparent=true&exceptions=applicatio/vnd.ogc.se_xml8.2.2.3 GetFeatureInfo 操作GetFeatureInfo操作的请求参数及其具体含义如表14所示。表 14 空间数据访问服务 GetFeatureInfo
18、 操作的请求参数DB37/T XXXXXXXXX12序号 参数名称 参数个数 参数类型和值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 个(必选) MIME 类型，值为请求信息的返回类
19、型7 I 1 个(必选) 整型类型，值为待查询点的在地图图片上的像素列号8 J 1 个(必选) 整型类型，值为待查询点的在地图图片上的像素行号9 feature_count0 或 1 个(可选) 整型类型，值为返回信息中的要素的个数(默认是 1)10 exceptions0 或 1 个(可选) 值为 WMS 的异常信息报告的格式(默认情况下是 XML 格式)服务请求示例如下：http:/*.*.*.*/serviceaccess/wms?version=1.3.0&request=getfeatureinfo&layers=topp:states&styles=population&SRS=E
20、PSG:4326&bbox=-125,24,-67,50&width=400&height=200&format=text/html&I=100&J=100&query_layers=topp:states8.3 非空间数据访问服务规范非空间数据访问服务基于标准的WebService服务规范，用于实现对海洋与渔业业务中非空间数据的访问。8.3.1 数据访问机制各业务数据在数据库中按逻辑分别存储，针对各访问需求，建立数据视图，在数据视图的基础上，基于标准WebService服务提供数据访问接口，通过中间数据视图的形式实现数据访问。如图1。渔业专题渔业专题 海域专题 环保专题 数据视图数据访问服务
21、接口各业务应用系统数据传输交换中心数 据 访 问 者数据服务中心DB37/T XXXXXXXXX13图 1 数据访问机制8.3.2 服务请求与响应8.3.2.1 通讯方式数据访问接口采用http通讯协议进行同步通讯。接口服务程序部署于web服务器上，通过Intranet/Internet/专线对外围系统提供查询服务。8.3.2.2 服务请求规则支持SOAP、POST、GET中至少一项请求方式，请求参数按照各业务数据访问接口需求进行设定。请求报文以XML标签形式进行封装，XML中各节点元素按照参数进行命名。如请求2013年海洋渔业年收入的示例：WebService地址：http:/*.*.*.*
22、/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 概述数据维护服务接口用于海洋与渔业用户对已注册的各类数据的增删改等维护操作。其中空间数据维护服务接口应符合OGC WFS要素服务
23、规范和OGC WPS Web空间处理分析服务规范的规定，支持空间数据的增删改操作。非空间数据维护服务接口应符合W3C Web Services Description Language (WSDL) 1.1的规定，支持海洋与渔业业务属性数据的维护操作。9.2 空间数据操作服务规范空间数据操作服务规范应符合OGC WFS要素服务规范的规定，主要对简单要素的数据编辑操作进行规范，从而使服务器端和客户端能够在要素层面进行“通讯”。其返回结果的是XML格式的服务元数据文档，通过该文档用户能够了解：服务器支持的所有操作操作列表，GetFeature操作返回的数据格式，可用的坐标参照系统列表，操作异常信息
24、的列表，服务提供方的相关信息，服务器的可用要素类列表等。9.2.1 服务接口的操作空间数据操作服务接口规范定义了GetCapabilities，DescribeFeatureType、GetFeature、Transaction、GetGmlObject和LockFeatureDB37/T XXXXXXXXX14一共6种操作。其中，前三个GetCapabilities，DescribeFeatureType和GetFeature为必须实现的操作。服务的详细操作如表15所示。表 15 空间数据操作服务的接口列表序号 操作 实现要求 描述1 GetCapabilities 强制实现获取能力文档（即
25、元数据文档） ，它是对服务信息内容和请求参数的一种描述，使用 XML 形式表示2 DescribeFeatureType 强制实现 获取指定 FeatureType 元数据的描述信息，以 schema 形式返回3 GetFeature 强制实现获取指定参数要求（图层命名空间及名称、过滤条件、返回字段）的要素数据，以 GML 形式返回4 Transaction 选择实现允许 Transaction 操作，使客户端可对服务器端所提供的地图要素类执行插入，更新，删除等命令5 GetGmlObject 选择实现 通过 XLink 获取 GML 对象6 LockFeature 选择实现 在事务过程中锁定
26、要素9.2.2 服务请求与响应各操作都要求实现KVP（keyword-value pair，键值对）编码和XML编码。前者对应HTTP GET请求方式，后者使用HTTP POST请求方式。9.2.2.1 GetCapabilities 操作该操作的请求参数，与数据访问服务GetCapabilities的请求参数相似，所示为KVP和XML两种编码方式的GetCapabilities操作请求示例。GetCapabilities操作的返回结果的是XML格式的服务元数据文档，通过该文档用户能够了解：服务器支持的所有操作接口列表，GetFeature操作返回的数据格式，可用的坐标参照系统列表，操作异常信
27、息的列表，服务提供方的相关信息，服务器的可用要素类列表，该服务是否支持WFS-T操作等。表 16 GetCapabilities 操作请求参数序号 参数名称 参数个数 参数类型和值1 service 1 个(必选) 字符类型，服务类型值为“WFS”2 request 1 个(必选) 字符类型，请求的操作名称，值为“GetCapabilities”3 versions 0 或 1 个(可选) 字符类型，值为请求的 WFS 的版本号表 17 KVP 和 XML 两种编码方式的 GetCapabilities 操作请求示例序号 编码方式 GetCapabilities 操作请求示例1 KVP htt
28、p:/*/wfs.cgi?VERSION=1.1.0&SERVICE=WFS&REQUEST=GetCapabilities2 XMLDB37/T XXXXXXXXX159.2.2.2 DescribeFeatureType 操作在DescribeFeatureType操作中，需要考虑输出文档的编码格式，必须实现GML编码格式，其他的输出格式为可选实现，同时也要在Capabilities文档中给予说明。DescribeFeatureType操作的请求参数及编码如表18所示。表 18 DescribeFeatureType 操作请求参数序号 参数名称 参数个数 参数类型和值1 service 1
29、 个(必选) 字符类型，服务类型值为“WFS”2 request 1 个(必选) 字符类型，请求的操作名称，值为“DescribeFeatureType”3 typeName0 或 1 个(可选) 字符类型，值为要素类型的列表，多个值之间用“， ”隔开，默认解析包括的全部要素类型4 outputFormat0 或 1 个(可选) MIME 类型，值为输出格式下表是KVP和XML两种编码方式的DescribeFeatureType操作请求示例，返回的结果是以XML形式的要素类的元数据描述文档，包括该要素类的名称空间、属性名称及数据类型、要素的几何类型等信息。表 19 DescribeFeatur
30、eType 操作请求示例序号 编码方式 DescribeFeatureType 操作请求示例1 KVP http:/*.*.*.*/wfs.cgi?SERVICE=WFS&VERSION=1.1.0&REQUEST=DescribeFeatureType&TYPENAME=TreesA_1M2 XMLtopp:states9.2.2.3 GetFeature 操作GetFeature操作的请求参数以及每个参数的默认类型和含义描述如表20所示。表 20 GetFeature 操作请求参数序号 参数名称 参数个数 参数类型和值1 service 1 个(必选) 字符类型，服务类型标识值为“WFS”
31、2 request 1 个(必选) 字符类型，请求的操作值为“GetFeature”3 typeName 1 个(必选) 字符类型，值为请求的要素类型的名称，多个名称之间用“， ”隔开4 version0 或 1 个(可选) 字符类型，值为请求的 WFS 的版本号5 outputFormat0 或 1 个(可选) MIME 类型，值为输出格式DB37/T XXXXXXXXX166 resultType0 或 1 个(可选) 字符类型，值为请求的结果类型7 propertyName0 或 1 个(可选) 字符类型，值为请求要素的属性名，多个值之间用“， ”隔开8 featureVersion0
32、或 1 个(可选) 字符类型，值为要素的版本，值为 ALL 返回请求的要素的所有版本，没有值默认为返回请求要素的最新版本9 maxFeature0 或 1 个(可选) 整型类型，值为请求要素的最大数，默认值为满足查询的所有结果集10 expiry0 或 1 个(可选) 数字类型，要素被锁定的时间11 SRSName0 或 1 个(可选) 字符类型，值为坐标系统名12 featureID0 或 1 个(可选) 字符类型，值为要素的 ID，多个 ID 之间用“， ”隔开13 filter0 或 1 个(可选) 请求要素的过滤条件14 bBox0 或 1 个(可选) 字符类型，请求指定要素查询范围，
33、可以替代 featureId 和 filter 参数15 sortby0 或 1 个(可选) 字符类型，查询结果属性值的排序依据表21是KVP和XML两种编码方式的GetFeature操作请求示例，返回的结果是GML形式的要素类文档，包括该要素类中各符合查询条件要素的属性数据、定位数据等信息，要素类的结构在GML规范中的有详细介绍。表 21 GetFeature 操作请求示例序号 编码方式 GetFeature 操作请求示例1 KVP http:/*.*.*.*/wfs.cgi&SERVICE=WFS&VERSION=1.1.0&REQUEST=GetFeature&PROPERTYNAME=
34、InWaterA_1M/wkbGeom，InWaterA_1M/tileId&TYPENAME=InWaterA_1M2 XML9.3 非空间数据维护服务规范非空间数据维护服务应符合W3C Web Services Description Language (WSDL) 1.1的规定，用于实现对海洋与渔业业务中非空间数据的增删改等维护操作。DB37/T XXXXXXXXX179.3.1 数据维护机制非空间数据维护接口提供增加，删除，修改等维护功能，各功能对应于数据库中insert,delete,update等操作，数据库中以时间戳及历史库的形式保存修改历史，保证数据的可追溯性。如图2。源数据库
35、源数据库 历史库增加修改数 据 维 护 服 务 接 口删除时间戳I n s e r t , u p d a t e , d e l e t e 等数据库操作图 2 数据维护机制9.3.2 服务请求与响应9.3.2.1 通讯方式数据访问接口采用http通讯协议进行同步通讯。接口服务程序部署于web服务器上，通过Intranet/Internet/专线对外围系统提供查询服务。9.3.2.2 服务请求规则请求报文以XML标签形式进行封装，XML中至少要包括操作类型（增加/删除/修改），以及其对应操作的请求参数。如更新2015年海洋渔业从业人数为1000的示例：WebService地址：http:/*
36、.*.*.*/hyjj/Modify_yy?报文范例：update2015191000其中op代表维护操作为更新，year代表请求参数年份，type代表更新类型为海洋渔业从业人数，count代表更新数值。9.3.2.3 服务响应规则服务请求响应后返回XML格式的报文，报文中至少要有操作结果。例如返回报文范例：true10删除成功DB37/T XXXXXXXXX18代表对数据的删除操作成功，涉及条目10条。DB37/T XXXXXXXXX19参 考 文 献OGC 06-121r3, OpenGIS Web Services Common SpecificationOGC 03-105r1, Op
37、enGIS Geography Markup Language (GML) Implementation Specification, Version 3.1, February 2004OGC 04-092r4, OpenGIS Geography Markup Language (GML) Implementation Specification Schemas, Version 3.1.1IETF RFC 2396 (August 1998), Uniform Resource Identifiers (URI): Generic Syntax, Berners-Lee, T., Fie
38、lding, N., and Masinter, L., eds., IETF RFC 2616 (June 1999), Hypertext Transfer Protocol HTTP/1.1, Gettys, J., Mogul, J., Frystyk, 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
39、 February 2004, Extensible Markup Language (XML) 1.0 (Third Edition), http:/www.w3.org/TR/REC-xmlW3C Recommendation 2 May 2001: 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 2003W3C SOAP 1.2 Attachment Feature, W3C Working Group Note 8 June 2004,_
