DB37/T 2984-2017 海洋与渔业数据服务接口规范

ICS35.240.99

L67

DB37

山东省地方标准

DB37/T2984—2017

海洋与渔业数据服务接口规范

2017-08-18发布2017-09-18实施

山东省质量技术监督局发布

DB37/T2984—2017

目次

前言...............................................................................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

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/T2984—2017

前言

本标准按照GB/T1.1—2009给出的规则起草。

本标准由山东省海洋与渔业厅提出。

本标准由山东省信息标准化技术委员会归口。

本标准起草单位：山东省海洋与渔业信息宣传中心、山东省国土测绘院、山东省标准化研究院。

本标准主要起草人：徐国强、张伟、孟静涛、张欣、孙振喜、李飞、韩海丰、高浠舰、路洪贵、丁

志习、隗玉凯、张媛、刘博、李晓璇、史富涛。

II

DB37/T2984—2017

海洋与渔业数据服务接口规范

1范围

本标准规定了山东省海洋与渔业数据服务请求响应规则、服务接口和参数命名规则、基础地理数据

服务接口、数据目录服务接口、数据访问服务接口、数据维护服务接口等内容。

本标准适用于海洋与渔业数据服务的访问、维护和相关应用系统的建设与管理。

2规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文

件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。

ISO19119:TBD,Geographicinformation-Services

ISO19105:2000,Geographicinformation-ConformanceandTesting

ISO19115:2003,Geographicinformation–Metadata

GB/T17694地理信息术语

OGCWMSWeb地图服务接口规范（OpenGISWebMapServiceImplementationSpecification，

WMS，V1.3.0）

OGCWCSCoverage服务规范(OpenGISWebCoverageServiceImplementationSpecification，

WCS，V1.1.2)

OGCWFS要素服务规范(OpenGISWebFeatureServiceImplementationSpecification，WFS，

V1.1.0)

OGCCSW基于Web的目录服务规范（OpenGISCatalogueServiceImplementationSpecification，

CSW，V2.0.2）

OGCWPSWeb空间处理分析服务规范(OpenGISWebProcessingService，WPS，V1.0.0)

OGC切片地图服务规范（WebMapTileService）

W3CWebServicesDescriptionLanguage(WSDL)1.1,W3CNote15March2001

3术语和定义

3.1

操作

使得一个对象被调用执行的转换或查询的定义[ISO19119]。

3.2

接口

由体现一个实体行为特征的操作组成的具有给定名称的集合[ISO19119]。

3.3

1

DB37/T2984—2017

服务

由实体通过接口提供的明确的功能[ISO19119]。

3.4

功能XML

描述一个服务实例可用的操作和内容的服务级元数据。

3.5

元数据

描述数据及其环境的数据，包括描述要素、数据集或数据集系列的内容、覆盖范围、质量、管理方

式、数据的所有者、数据的提供方式等有关的信息。

3.6

服务元数据

描述一个服务的操作和地理信息变量的元数据。

3.7

URI

统一资源标识符（UniformResourceIdentifier)是一个用于标识某一互联网资源名称的字符串。

该种标识允许用户对任何（包括本地和互联网）的资源通过特定的协议进行交互操作。

4服务请求响应规则

4.1服务请求规则

4.1.1概述

服务接口一律支持通用的HTTP请求规则，包括常用的两个请求方法：GET和POST。两种方法中的任

一种方法都可以用来描述特定的服务类型，并且由服务实例提供，服务接口可以选择实现其中一种，或

者二者全部定义和实现。

4.1.2HTTPGET

用于HTTPGET请求的在线资源URL事实上仅仅是一个URL前缀，为了建立一个有效的操作请求，在其

后还添加了另外的参数。URL前缀被定义为一个不透明的字符串，它包括协议、主机名、端口号（可选）、

路径、和一个问号“？”，还可以包括一个或几个用于具体服务器的参数并以“&”结束。该前缀唯一

地标识了具体的服务实例，客户端在其后添加以名/值对形式出现的必要的请求参数，格式为

“name=value&”。根据HTTP公共网关接口标准，最终的URL必须是有效的。该标准要求符号“？”处于

查询参数序列之前，符号“&”界于参数之间。

URL前缀必须以“？”（在没有附加的适用与具体的服务器的参数的情况下）或者“&”结束。然而，

在实践中，为了建立有效URL请求，客户端应该预备在添加按本规范定义的操作参数之前，增补一个必

要的“？”或“&”。表1总结了操作请求URL的各个构件。

2

DB37/T2984—2017

表1通用的OGCWeb服务请求

URL组成描述

服务操作的URL前缀.[]表示可选部分出现0次或1次;{}表示出

http://host[:port]/path?{name[=value]&}

现0次或任意次.前缀完全由服务提供者控制。

由OGCWeb服务定义的一个或多个标准请求参数名/值对.必须的或可

name=value&

选的参数组成了实际参数列，被相应的OWS规范的每个操作控制。

4.1.3HTTPPOST

用于HTTPPOST请求的在线资源URL是一个完整和有效的URL，客户端在POST请求中向它传输请求参

数。在给操作请求建立一个有效的目标时，不能要求在该URL上添加额外的参数。

4.2服务响应规则

服务在接收到有效请求时，应按照相应规范中的详细规定作出准确的应答。在接到一个无效要求情

况下，服务必须发送一个5.4节里面描述的服务异常。应答对象应伴随一个适当的多用途网络邮件扩充

协议（MIME）类型[IETFRFC2045]。应答对象应该尽可能地伴随一个适当的HTTP实体头。

注：过期（Expire）和最后修改（Last-Modified）的头信息提供了关于存储的重要信息；客户端可以通过内容-长

度（Content-Length）了解数据传输什么时候完成，并为结果有效地分配空间。为了正确地解释结果，内容编

码（Content-Encoding）或内容传输编码（Content-Transfer-Encoding）是必要的。

5服务接口和参数命名规则

5.1命名原则

遵循本标准规范所创建的服务均应使用通用的接口命名及其所包含的所有必选的参数，对于服务扩

展部分或者自定义的服务的接口和参数命名应遵守以下原则：

a)避免使用与常用编程语言的关键字冲突的标识符；

b)不要将缩写或缩略形式用作标识符名称的组成部分；

c)用名词或名词短语或者描述行为的形容词命名接口，使用Pascal大小写形式，即标识符的首

字母和后面连接的每个单词的首字母都大写；

d)参数名称使用描述的名字，它能足够决定变量的意思和类型。参数命名依赖于参数的参数含义，

而不是反映参数类型的名称。参数名称使用Camel大小写形式，即标识符的首字母小写，而每

个后面连接的单词的首字母都大写；

e)在名称中包含强调字符的使用，请选择易读的标识符名称；

f)可读性比简洁性更重要，多用有意义的，描述性的词语。

5.2参数顺序和大小写

参数名字不区分大小写，参数值应区分大小写。

请求中的参数可以按任何顺序指明。如果遇到所请求的服务中未指定的参数，服务将忽视这样的参

数。

5.3参数列表

3

DB37/T2984—2017

由列表组成的参数（例如，在WMSGETMAP里的LAYERS和STYLES）必须用逗号“，”作为列表里各个

项之间分隔符，不可要求另外用空格来分隔各个列表项。如果参数值包含了空格或是逗号，必须使用URL

编码规则[IETFRFC2396]进行换码。

在列表中的单个项可以为空，并用两个连续的逗号来表示（“，，”）。

5.4服务异常

当接收到一个请求，并且依据使用的分布式计算平台（DCP）的规则该请求无效时，服务可以发布

一个在该DCP上有效的异常类型。例如，在HTTPDCP上，如果URL前缀是错误的，将送回一个HTTP404[IETF

RFC2616]状态码。

当接收到一个请求，并且该请求无效时，服务必须发布一个服务异常报告。该报告用于向客户端应

用程序和使用者说明请求无效的原因。

依据本规范的服务异常DTD，服务异常XML必须是有效的。在HTTP环境下，返回的XML的MIME类型必

须为"application/vnd.ogc.se_xml"。包含的具体错误信息可以是纯文本块，也可以被包含在字符数据

(CDATA)块段中，形成类似XML的包含角括弧("<"and">")的文本。除了这些指定的以外，服务程序不

允许使用这些代码规定意义以外的含义。客户端可以使用这些代码去自动响应服务异常。

6数据目录服务接口

6.1概述

数据目录服务接口，应符合OGCCSW基于Web的目录服务规范的规定，用于海洋与渔业用户对海洋与

渔业服务及服务元数据的注册、管理，并对已注册的服务的检索、发现，实现山东省海洋与渔业服务的

注册和查询。

6.2服务接口的操作

数据目录服务接口包括GetCapabilities、DescribeRecord、GetRecords、GetRecordById、

GetDomain、Harvest和Transaction7种操作，其描述如表2所示。

表2数据目录服务操作列表

序号操作实现要求描述

获取CSW的能力文档，它是对服务信息内容和请求参数的一种描述，使用

1GetCapabilities强制实现

XML形式表示

2DescribeRecord强制实现获得某种记录类型的元数据描述结构

3GetRecords强制实现获得记录项

4GetRecordById强制实现通过Id来获取记录

5GetDomain选择实现获得某一变量的值的范围

6Harvest选择实现从指定的来源收割元数据

7Transaction选择实现事务操作，包括记录的插入、更新、删除

6.3服务请求与响应

6.3.1GetCapabilities操作

GetCapabilities操作请求参数如表3所示：

4

DB37/T2984—2017

表3数据目录服务GetCapabilities操作请求参数

序号参数名称参数个数参数类型和值

1service1个(必选)字符类型，服务类型值为“CSW”

2request1个(必选)字符类型，请求的操作名称，值为“GetCapabilities”

3acceptVersions0或1个(可选)字符类型，值为请求的CSW的版本号

字符类型，请求元数据文档0或多个节的名称，多个名称之间用“，”隔

4sections0或1个(可选)

开，不须按顺序排列。值为空默认返回整个元数据文档

5updateSequence0或1个(可选)字符类型，值为increased，为空时默认返回最新的元数据文档

6acceptFormat0或1个(可选)MIME类型，值为服务元数据的输出格式

6.3.2DescribeRecord操作

DescribeRecord操作请求参数如表4所示：

表4数据目录服务DescribeRecord操作请求参数

序号参数名称参数个数参数类型和值

1service1个(必选)字符类型，服务类型标识值为“CSW”

2request1个(必选)字符类型，请求的操作值为“DescribeRecord”

3version1个(必选)字符类型，值为请求的CSW的版本号

4nameSpace1个(可选)字符类型，值为命名空间及其前缀

字符类型，值为类型名称，多个名称之间用“，”隔开，默认返回该服务

5typeName0或1个(可选)

所有的类型名称的描述

6outputFomat0或1个(可选)MIME类型，值为输出格式，默认为xml格式

7schemaLanguage0或1个(可选)字符类型，值为输出服务描述所采用的schema语言，默认值是xmlschema

请求数据目录服务的DescribeRecord操作的URL示例如下，该操作请求描述WMS服务元数据的结构，

其中typeName说明请求的是服务类型为WMS的元数据结构描述。

服务请求示例如下：

http://*.*.*.*/CSWService/service?service=CSW&REQUEST=DescribeRecord&version=2.0.2&ou

tputFormat=application/xml&schemaLanguage=XMLSCHEMA&typeName=csw:WMS

6.3.3GetRecords操作

GetRecords操作请求方法实现参数见表5所示。

表5数据目录服务GetRecords操作请求参数

序号参数名称参数个数参数类型和值

1service1个(必选)字符类型，服务类型值为“C