海洋与渔业数据服务接口规范
海洋与渔业数据服务接口规范
ICS 35.240.99 L 67 DB37 山 东 省 地 方 标 准 DB37/T 2984—2017 海洋与渔业数据服务接口规范 2017-08-18 发布 山东省质量技术监督局 2017-09-18 实施 发 布 DB37/T 2984—2017 目 次 前言 ............................................................................... III 1 范围 .............................................................................. 1 2 规范性引用文件 .................................................................... 1 3 术语和定义 ........................................................................ 1 4 服务请求响应规则 .................................................................. 2 4.1 服务请求规则 .................................................................. 2 4.2 服务响应规则 .................................................................. 3 5 服务接口和参数命名规则 ............................................................ 3 5.1 5.2 5.3 5.4 6 命名原则 ...................................................................... 参数顺序和大小写 .............................................................. 参数列表 ...................................................................... 服务异常 ...................................................................... 3 3 3 4 数据目录服务接口 .................................................................. 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/T 2984—2017 前 言 本标准按照GB/T 1.1—2009给出的规则起草。 本标准由山东省海洋与渔业厅提出。 本标准由山东省信息标准化技术委员会归口。 本标准起草单位：山东省海洋与渔业信息宣传中心、山东省国土测绘院、山东省标准化研究院。 本标准主要起草人：徐国强、张伟、孟静涛、张欣、孙振喜、李飞、韩海丰、高浠舰、路洪贵、丁 志习、隗玉凯、张媛、刘博、李晓璇、史富涛。 II DB37/T 2984—2017 海洋与渔业数据服务接口规范 1 范围 本标准规定了山东省海洋与渔业数据服务请求响应规则、服务接口和参数命名规则、基础地理数据 服务接口、数据目录服务接口、数据访问服务接口、数据维护服务接口等内容。 本标准适用于海洋与渔业数据服务的访问、维护和相关应用系统的建设与管理。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 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 Web 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 Implementation 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 1 DB37/T 2984—2017 服务 由实体通过接口提供的明确的功能[ISO19119]。 3.4 功能XML 描述一个服务实例可用的操作和内容的服务级元数据。 3.5 元数据 描述数据及其环境的数据，包括描述要素、数据集或数据集系列的内容、覆盖范围、质量、管理方 式、数据的所有者、数据的提供方式等有关的信息。 3.6 服务元数据 描述一个服务的操作和地理信息变量的元数据。 3.7 URI 统一资源标识符（Uniform Resource Identifier)是一个用于标识某一互联网资源名称的字符串。 该种标识允许用户对任何（包括本地和互联网）的资源通过特定的协议进行交互操作。 4 服务请求响应规则 4.1 服务请求规则 4.1.1 概述 服务接口一律支持通用的HTTP请求规则，包括常用的两个请求方法：GET和POST。两种方法中的任 一种方法都可以用来描述特定的服务类型，并且由服务实例提供，服务接口可以选择实现其中一种，或 者二者全部定义和实现。 4.1.2 HTTP GET 用于HTTP GET请求的在线资源URL事实上仅仅是一个URL前缀，为了建立一个有效的操作请求，在其 后还添加了另外的参数。URL前缀被定义为一个不透明的字符串，它包括协议、主机名、端口号（可选）、 路径、和一个问号“？”，还可以包括一个或几个用于具体服务器的参数并以“&”结束。该前缀唯一 地 标识了 具体的 服务 实例 ，客户 端在其 后添 加以 名/ 值对形 式出现 的必要 的请求 参数， 格式为 “name=value&”。根据HTTP公共网关接口标准，最终的URL必须是有效的。该标准要求符号“？”处于 查询参数序列之前，符号“&”界于参数之间。 URL前缀必须以“？”（在没有附加的适用与具体的服务器的参数的情况下）或者“&”结束。然而， 在实践中，为了建立有效URL请求，客户端应该预备在添加按本规范定义的操作参数之前，增补一个必 要的“？”或“&”。表1总结了操作请求URL的各个构件。 2 DB37/T 2984—2017 表1 通用的 OGC Web 服务请求 URL 组成 http://host[:port]/path?{name[=value]&} name=value& 描述 服务操作的 URL 前缀. [ ] 表示可选部分出现 0 次或 1 次; {} 表示出 现 0 次或任意次. 前缀完全由服务提供者控制。 由 OGC Web 服务定义的一个或多个标准请求参数名/值对. 必须的或可 选的参数组成了实际参数列，被相应的 OWS 规范的每个操作控制。 4.1.3 HTTP POST 用于HTTP POST请求的在线资源URL是一个完整和有效的URL，客户端在POST请求中向它传输请求参 数。在给操作请求建立一个有效的目标时，不能要求在该URL上添加额外的参数。 4.2 服务响应规则 服务在接收到有效请求时，应按照相应规范中的详细规定作出准确的应答。在接到一个无效要求情 况下，服务必须发送一个5.4节里面描述的服务异常。应答对象应伴随一个适当的多用途网络邮件扩充 协议（MIME）类型[IETF RFC 2045]。应答对象应该尽可能地伴随一个适当的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/T 2984—2017 由列表组成的参数（例如，在WMS GETMAP里的LAYERS和STYLES）必须用逗号“，”作为列表里各个 项之间分隔符，不可要求另外用空格来分隔各个列表项。如果参数值包含了空格或是逗号，必须使用URL 编码规则[IETF RFC 2396]进行换码。 在列表中的单个项可以为空，并用两个连续的逗号来表示（“，，”）。 5.4 服务异常 当接收到一个请求，并且依据使用的分布式计算平台（DCP）的规则该请求无效时，服务可以发布 一个在该DCP上有效的异常类型。例如，在HTTP DCP上，如果URL前缀是错误的，将送回一个HTTP 404 [IETF RFC 2616]状态码。 当接收到一个请求，并且该请求无效时，服务必须发布一个服务异常报告。该报告用于向客户端应 用程序和使用者说明请求无效的原因。 依据本规范的服务异常DTD，服务异常XML必须是有效的。在HTTP环境下，返回的XML的MIME类型必 须为"application/vnd.ogc.se_xml"。包含的具体错误信息可以是纯文本块，也可以被包含在字符数据 (CDATA)块段中，形成类似XML的包含角括弧("<" and ">")的文本。除了这些指定的以外，服务程序不 允许使用这些代码规定意义以外的含义。客户端可以使用这些代码去自动响应服务异常。 6 数据目录服务接口 6.1 概述 数据目录服务接口，应符合OGC CSW基于Web的目录服务规范的规定，用于海洋与渔业用户对海洋与 渔业服务及服务元数据的注册、管理，并对已注册的服务的检索、发现，实现山东省海洋与渔业服务的 注册和查询。 6.2 服务接口的操作 数 据 目 录 服 务 接 口 包 括 GetCapabilities 、 DescribeRecord 、 GetRecords 、 GetRecordById 、 GetDomain、Harvest和Transaction 7种操作，其描述如表2所示。 表2 数据目录服务操作列表 序号 操作 实现要求 描述 1 GetCapabilities 强制实现 2 DescribeRecord 强制实现 获得某种记录类型的元数据描述结构 3 GetRecords 强制实现 获得记录项 4 GetRecordById 强制实现 通过 Id 来获取记录 5 GetDomain 选择实现 获得某一变量的值的范围 6 Harvest 选择实现 从指定的来源收割元数据 7 Transaction 选择实现 事务操作，包括记录的插入、更新、删除 获取 CSW 的能力文档，它是对服务信息内容和请求参数的一种描述，使用 XML 形式表示 6.3 服务请求与响应 6.3.1 GetCapabilities 操作 GetCapabilities操作请求参数如表3所示： 4 DB37/T 2984—2017 表3 数据目录服务 GetCapabilities 操作请求参数 序号 参数名称 参数个数 参数类型和值 1 service 1 个(必选) 字符类型，服务类型值为“CSW” 2 request 1 个(必选) 字符类型，请求的操作名称，值为“GetCapabilities” 3 acceptVersions 0 或 1 个(可选) 字符类型，值为请求的 CSW 的版本号 4 sections 0 或 1 个(可选) 5 updateSequence 0 或 1 个(可选) 字符类型，值为 increased，为空时默认返回最新的元数据文档 6 acceptFormat 0 或 1 个(可选) MIME 类型，值为服务元数据的输出格式 字符类型，请求元数据文档 0 或多个节的名称，多个名称之间用“，”隔 开，不须按顺序排列。值为空默认返回整个元数据文档 6.3.2 DescribeRecord 操作 DescribeRecord操作请求参数如表4所示： 表4 数据目录服务 DescribeRecord 操作请求参数 序号 参数名称 参数个数 参数类型和值 1 service 1 个(必选) 字符类型，服务类型标识值为“CSW” 2 request 1 个(必选) 字符类型，请求的操作值为“DescribeRecord” 3 version 1 个(必选) 字符类型，值为请求的 CSW 的版本号 4 nameSpace 1 个(可选) 字符类型，值为命名空间及其前缀 5 typeName 0 或 1 个(可选) 6 outputFomat 0 或 1 个(可选) MIME 类型，值为输出格式，默认为 xml 格式 7 schemaLanguage 0 或 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.3 GetRecords 操作 GetRecords操作请求方法实现参数见表5所示。 表5 数据目录服务 GetRecords 操作请求参数 序号 参数名称 参数个数 参数类型和值 1 service 1 个(必选) 字符类型，服务类型值为“CSW” 2 request 1 个(必选) 字符类型，请求的操作值为“GetRecords” 3 version 1 个(必选) 字符类型，值为请求的 CSW 的版本号 4 typeName 1 个(必选) 5 Constraint 0 或 1 个(可选) 字符类型，值为查询的对象类型名称，多个名称之间用“，”隔开， 排列无序 字符类型，值为限制条件，由约束语言参数构成的谓语表达式。服务 默认的查询时无约束查询 5 DB37/T 2984—2017 表5 数据目录服务 GetRecords 操作请求参数（续） 序号 参数名称 参数个数 参数类型和值 6 nameSpace 1 个(可选) 字符类型，值为命名空间及其前缀，多个之间用“，”隔开 7 resultType 0 或 1 个(可选) 8 requestId 0 或 1 个(可选) URI，值为请求 ID 9 outputFomat 0 或 1 个(可选) MIME 类型，值为输出格式，默认为 xml 格式 10 outputSchema 0 或 1 个(可选) URI，默认值为 http://www.opengis.net/cat/csw/2.0.2. 11 startPosition 0 或 1 个(可选) 整型类型，值为非 0 正整数，默认值为 1 12 maxRecords 0 或 1 个(可选) 整型类型，最大记录数值为正整数，默认值为 10 13 ElementSetName 0 或 1 个(可选) 字符类型，元素集名称，不与 ElementName 同时使用 14 ElementName 0 或 1 个(可选) 字符类型，元素名称，不与 ElementSetName 同时使用 15 constraitLanguage 0 或 1 个(可选) 字符类型，值 CQL_TEXT 或者 FILTER 16 SortBy 0 或 1 个(可选) 17 DistributedSearch 0 或 1 个(可选) Boolean 类型，值为 true 或者 false，默认为 false 18 hopCount 0 或 1 个(可选) 整型类型，需与 DistributedSearch 同时使用 19 ResponseHandler 0 或 1 个(可选) URI，若不包含此参数，默认为同步请求 字符类型，值为“hits”、“results”或者”validate”，默认值为 “hits” 字符类型，元数据元素名称的排列顺序，默认排列顺序为获取得到的 记录顺序 请求数据目录服务的GetRecords操作的URL示例如下，该操作示例请求标题名称为“FJMAP”的WMS 服务有哪些，返回结果按照outputFormat和outputSchema中的规定返回。 服务请求示例如下： http://*.*.*.*/CSWService/service?service=CSW&request=GetRecords&version=2.0.2&output Format=application/xml&outputSchema=http://www.opengis.net/cat/csw/2.0.2&namespace=csw:ht tp://www.opengis.net/cat/csw/2.0.2&ResponseHandler="mailto:pvretano@cubewerx.com"&typeNam es=csw:WMS&elementSetName=brief&constraintlanguage=CQLTEXT&constraint="csw:TITLE = 'FJMAP'" 6.3.4 GetRecordById 操作 GetRecordById操作请求方法实现参数如表6所示。 表6 数据目录服务 GetRecordById 操作请求参数 序号 参数名称 参数个数 参数类型和值 1 service 1 个(必选) 字符类型，服务类型值为“CSW” 2 request 1 个(必选) 字符类型，请求的操作值为“GetRecordById” 3 id 1 个(必选) URI，值为任意标识符，多个之间用“，”隔开 4 ElementSetName 0 或 1 个(可选) 5 outputFomat 0 或 1 个(可选) MIME 类型，值为输出格式，默认为 xml 格式 6 outputSchema 0 或 1 个(可选) URI，值为输出结果的 Schema MIME 类型，值为“brief”，“summary”或者“full”，默认为 “summary” 请 求 数 据 目 录 服 务 的 GetRecordById 操 作 的 URL 示 例 如 下 ， 该 操 作 示 例 请 求 Id 为 “weoriupo-ewrupo-sdflkjlww”的服务有哪些。 6 DB37/T 2984—2017 服务请求示例如下： http://*.*.*.*/CSWService/service?service=CSW&request=GetRecordById&version=2.0.2&id= weoriupo-ewrupo-sdflkjlww 7 基础地理数据服务接口 7.1 概述 基础地理数据服务接口，应符合OGC切片地图服务规范的规定，用于实现山东省陆地与海域线划地 图、影像地图的一体化请求、访问。本服务接口采用缓存技术，能够缓解WebGIS服务器端数据处理的压 力，提高交互响应速度，大幅改善在线地图应用客户端的用户体验。 7.2 服务接口的操作 基础地理数据服务支持REST访问，其接口包括GetCapabilities、GetTile和GetFeatureInfo这3个 操作，这些操作允许用户访问切片地图。具体服务操作列表如表7所示。 表7 服务操作列表 序号 操作 操作 描述 1 GetCapabilities 强制实现 获取 WMTS 的能力文档（即元数据文档） ，里面包含服务的所有信息 2 GetTile 强制实现 3 GetFeatureInfo 选择实现 获取地图瓦片。该操作根据客户端发出的请求参数在服务端进行检索，服务 器端返回地图瓦片图像 通过在 WMTS 图层上指定一定的条件，返回指定的地图瓦片内容对应的要素信 息 7.3 服务请求与响应 7.3.1 GetCapabilities 操作 GetCapabilities操作的请求参数如表8所示。 表8 服务 GetCapabilities 操作请求参数 序号 参数名称 参数个数 参数类型和值 1 service 1 个(必选) 字符类型，服务类型值为“WMTS” 2 request 1 个(必选) 字符类型，请求的操作名称，值为“GetCapabilities” 3 acceptVersions 0 或 1 个(可选) 字符类型，值为请求的 WMTS 的版本号 4 sections 0 或 1 个(可选) 5 updateSequence 0 或 1 个(可选) 字符类型，值为 increased，为空时默认返回最新的元数据文档 6 acceptFormat 0 或 1 个(可选) MIME 类型，值为服务元数据的输出格式 字符类型，请求元数据文档 0 或多个节的名称，多个名称之间用“，”隔 开，不须按顺序排列。值为空默认返回整个元数据文档 基础地理数据服务的GetCapabilities操作的URL如下所示，该操作返回XML格式的服务元数据文档， 通过该文档用户能够了解： ——该服务支持的所有操作接口列表； ——GetTile 操作返回的地图瓦片格式、行列号； ——操作异常信息的列表； 7 DB37/T 2984—2017 ——该服务提供方的信息； ——该服务的可用图层以及可选样式的列表； ——该服务是否支持可选的 GetFeaturelnfo 操作等。 服务请求示例如下： http:// *.*.*.*/serviceaccess/wmts/hyyt?service=WMTS&request=getCapabilities 7.3.2 GetTile 操作 GetTile操作中强制实现的参数及其具体含义如表9所示。 表9 服务 GetTile 操作的请求参数 序号 参数名称 参数个数 参数类型和值 1 service 1 个(必选) 字符类型，服务类型标识值为“WMTS” 2 request 1 个(必选) 字符类型，请求的操作值为“GetTile” 3 version 1 个(必选) 字符类型，值为请求的 WMTS 的版本号 4 layer 1 个(必选) 字符类型，值为请求的图层名称 5 style 1 个(必选) 字符类型，值为请求图层的渲染样式 6 format 1 个(必选) 字符类型，值为瓦片地图的输出格式 7 tileMatrixSet 1 个(必选) 字符类型，瓦片矩阵数据集，其值在服务的元数据文档中指定 8 tileMatrix 1 个(必选) 字符类型，瓦片矩阵，其值在服务的元数据文档中指定 9 tileRow 1 个(必选) 整型类型，值为大于 0 的整数，表示瓦片矩阵的行号 10 tileCol 1 个(必选) 整型类型，值为大于 0 的整数，表示瓦片矩阵的列号 11 Othersample dimensions 0 或 1 个(可选) 字符类型，其他允许的参数 每一个GetTile请求返回的是对应地图瓦片。请求基础地理数据服务的GetTile操作的URL如下所示， 其中layer=0表示请求的是名称为0的图层，使用的地图渲染样式是default默认样式。 服务请求示例如下： http://*.*.*.*/serviceaccess/wmts/hyyt?service=WMTS&request=GetTile&layer=0&style=def ault&format=image/png&tileMatrixSet=sss&tileMatrix=8&tileRow=12&tileCol=12&version=1.0.0 7.3.3 GetFeatureInfo 操作 GetFeatureInfo操作的请求参数及其具体含义如表10所示。 表10 服务 GetFeatureInfo 操作的请求参数 序号 参数名称 参数个数 参数类型和值 1 service 1 个(必选) 字符类型，服务类型值为“WMTS” 2 request 1 个(必选) 字符类型，请求的操作值为“GetFeatureInfo” 3 version 1 个(必选) 字符类型，值为请求的 WMTS 的版本号 4 j 1 个(必选) 整型类型，值为大于 0 的整数，表示瓦片上一指定像素点的行号 5 i 1 个(必选) 整型类型，值为大于 0 的整数，表示瓦片上一指定像素点的列号 6 info_format 1 个(必选) MIME 类型，值为请求信息的返回类型 7 GetTile 请求参数 多个(必选) 参见 GetTile 中的请求参数说明 GetFeaturelnfo操作的响应支持text/plain，text/html，application/vnd.ogc.gml三种格式，可 以通过INFO_FORMAT参数来指定。采用GML格式，用户可以通过XML解析API来取出查询位置的属性和定位 8 DB37/T 2984—2017 信息。基础地理数据服务的GetFeaturelnfo操作请求的URL如下所示，其中参数I、J，表示待查询点的 在地图瓦片上的像素列号和行号。 服务请求示例如下： http://*.*.*.*/serviceaccess/wmts/SDMap?service=WMTS&request=GetFeatureInfo&version=1 .0.0&layer=0&style=default&format=image/png&TileMatrixSet=FJMap&TileMatrix=10m&TileRow=1& TileCol=3&J=86&I=132&InfoFormat=application/gml+xml;version=3.1 8 数据访问服务接口 8.1 概述 数据访问接口用于海洋与渔业用户对平台整合的各类数据服务的浏览、查询、访问。 其中空间数据访问服务接口基于标准的WMS服务，支持空间数据服务的访问、查询、展示。 非空间数据访问服务基于标准的WebService服务，按照服务接口指定的查询条件，返回特定信息。 8.2 空间数据访问服务规范 空间数据访问规范，定义了Web客户端从网络地图服务器获取地图的接口标准。该规范应符合OGC WMS Web地图服务接口规范的规定，可以动态地生成具有地理参考数据的地图，这些地图通常用GIF、 JPEG或PNG等图像格式，或者SVG、KML、VML和WebCGM等矢量图形格式来表现。使用者通过指定的参数获 取相应的地图图片。 8.2.1 服务接口的操作 空间数据访问服务由三个基础性操作协议(GetCapabilities，GetMap和GetFeatureInfo)组成，这 些协议实现了对不同来源的远程异构地图服务的展示和访问。服务操作列表如表11所示。 表11 空间数据访问服务操作列表 序号 操作 实现要求 描述 1 GetCapabilities 强制实现 获取 WMS 的能力文档（即元数据文档） ，里面包含服务的所有信息 获取地图图片。该操作根据客户端发出的请求参数在服务端进行检索，服务 2 GetMap 强制实现 器端返回一个地图图像，其地理空间参数和大小参数是已经明确定义的，返 回的地图图像可以是 GIF、JPEG、PNG 或 SVG 格式。 3 GetFeatureInfo 选择实现 该操作根据用户所请求的 X、Y 坐标或感兴趣的图层，返回地图上某些特殊要 素的信息，信息以 HTML，GML 或 ASCII 的格式表示。 8.2.2 服务请求与响应 8.2.2.1 GetCapabilities 操作 空间数据访问服务的GetCapabilities操作的请求参数如表12所示。 表12 空间数据访问服务 GetCapabilities 操作的请求参数 序号 参数名称 参数个数 参数类型和值 1 service 1 个(必选) 字符类型，服务类型值为“WMS” 2 request 1 个(必选) 字符类型，请求的操作名称，值为“GetCapabilities” 9 DB37/T 2984—2017 表12 空间数据访问服务 GetCapabilities 操作的请求参数（续） 序号 参数名称 参数个数 参数类型和值 3 version 0 或 1 个(可选) 字符类型，值为请求的 WMS 的版本号，本平台为 1.3.0 4 format 0 或 1 个(可选) MIME 类型，值为服务元数据的输出格式 5 updateSequence 0 或 1 个(可选) 字符类型，可取的值有 none、any、equal、lower、higher，用来表示缓 存数据更新的方式 空间数据访问服务GetCapabilities操作的请求URL如下所示，该操作返回XML格式的服务元数据文 档，通过该文档用户能够了解： ——该地图服务器支持的所有操作接口列表； ——GetMap 操作返回的地图格式； ——可用的坐标参照系统列表； ——操作异常信息的列表； ——该地图服务提供方的信息； ——该地图服务的可用图层以及可选样式的列表； ——该地图服务是否支持可选的 GetFeaturelnfo 操作等。 服务请求示例如下： 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 个(必选) 字符类型，值为请求的 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 transparent 0 或 1 个(可选) 12 bgcolor 0 或 1 个(可选) 值为十六进制的 RGB 值，表示地图的背景颜色 13 exceptions 0 或 1 个(可选) 值为 WMS 的异常信息报告的格式(默认情况下是 XML 格式) 14 time 0 或 1 个(可选) 时间类型，值为时间值，表示需要在图层中有时间信息 15 elevation 0 或 1 个(可选) 数字类型，值为高程值，表示需要在图层中有高程信息 字符类型，值为 true 或者 false，用来表示地图图层是否透明(默认情况下是 不透明的) 10 DB37/T 2984—2017 每一个GetMap请求返回的是对应地图的一个图层或多个图层融合图层，对相同坐标参照系统下同一 区域内的不同地图进行多次GetMap请求可以得到多个图层，通过TRANSPARENT参数设置获得图层的透明 效果，从而实现多个要素层的叠加。对一个空间数据访问服务的GetMap操作的请求URL如下所示，其中6 表示请求的是第6个图层，使用的地图渲染样式是default，EPSG:4610代表XI’AN80坐标系。 服务请求示例如下： http://*.*.*.*/serviceaccess/wms/road?version=1.1.1&request=GetMap&service=WMS&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 空间数据访问服务 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 个(必选) MIME 类型，值为请求信息的返回类型 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&layers=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服务提供数据访问接口，通过中间数据视图的形式实现数据访问。如图1。 11 DB37/T 2984—2017 图1 数据访问机制 8.3.2 服务请求与响应 8.3.2.1 通讯方式 数 据 访 问 接 口 采 用 http 通 讯 协 议 进 行 同 步 通 讯 。 接 口 服 务 程 序 部 署 于 web 服 务 器 上 ， 通 过 Intranet/Internet/专线对外围系统提供查询服务。 8.3.2.2 服务请求规则 支持SOAP、POST、GET中至少一项请求方式，请求参数按照各业务数据访问接口需求进行设定。请 求报文以XML标签形式进行封装，XML中各节点元素按照参数进行命名。如请求2013年海洋渔业年收入的 示例： WebService地址：http://*.*.*.*/hyjj/GetList_yy? 报文范例：