1、ICS 35.240.70 A 75 DB63 青 海 省 地 方 标 准 DB63/T 18282020 地理信息公共服务 地质气象灾害空间专题数据服务接口规范 2020 - 11 - 12发布 2020 - 12 - 31实施 青海省市场监督管理局 发 布 DB63/T 18282020 I 前 言 本标准按照GB/T 1.1-2009给出的规则起草。 本标准由青海省自然资源厅提出并归口。 本标准起草单位：青海省地理信息中心、青海省地理空间信息技术与应用重点实验室、青海省气象 局、青海省地质环境监测总站。 本标准主要起草人：祝茂良、晁剑、朱平、张芳、隋嘉、肖建设、王苑、许长军、虎文珺、杨鸿
2、海、 欧尔格力、张晶、牛艳霞、刘楠、宋福魁、王转、魏赛拉加、辛倩男、史飞飞。 本标准由青海省自然资源厅监督实施。 DB63/T 18282020 1 地理信息公共服务 地质气象灾害空间专题数据服务接口规范 1 范围 本规范规定了地质气象灾害空间专题服务接口的数据基本规定、数据服务内容、数据质量要求、数 据构成、接口模型结构、接口实现模型、接口规则等内容。 本规范可适用于在空间信息化平台中交换地质气象灾害数据的整理、交换等作业处理，其他地理空 间数据交换和共享平台也可参照使用。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文 件。凡是不
3、注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T 2260 中华人民共和国行政区划代码 GB/T 10113 分类与编码通用术语 GB/T 10114 县级以下行政区划代码编制规则 GB/T 16820 地图学术语 GB/T 19710 地理信息 元数据 GB 21139 基础地理信息标准数据基本规定 QX/T 342 气象灾害预警信息编码规范 3 术语和定义 GB/T 10113、GB/T 16820、GB/T 19710界定的以及下列术语和定义适用于本文件。 3.1 接口 进行信息交换时需要遵从的通信方式和要求。 3.2 元数据 关于数据的数据。即数据的标识、覆盖范
4、围、质量、空间和时间模式、空间参照系和分发等信息。 GB/T 19710，定义4.5 3.3 地质气象灾害 由典型气象事件（强降水等）作为触发因子而引发的突发性地质灾害。 DB63/T 18282020 2 3.4 代码 表示特定事物或概念的一个或一组字符。 GB/T 10113，定义2.2.5 3.5 矢量数据 以坐标或有序坐标串表示的空间点、线、面等图形数据及与其相联系的有关属性数据的总称。 GB/T 16820，定义5.13 3.6 交换 包括数据提供和数据使用两个方面，是指数据提供单位和数据使用单位相互交换地质气象灾害空间 专题数据的过程。 3.7 地质气象灾害空间专题数据 集中表现地
5、质气象灾害专题属性信息的空间数据。 3.8 协议 服务器端和客户端必须共同遵从的一组约定。 3.9 空间信息化平台 实现提供空间信息服务所需的分析功能、数据资源及其运行支撑环境的系统。 4 缩略语 下列缩略语适用于本文件。 GMDS：地质气象灾害空间数据服务（Geological and Meteorological Disaster Spatial Data Services） HTTPS：超文本传输安全协议（Hyper Text Transfer Protocol over SecureSocket Layer） REST：面向资源架构风格（Representational State T
6、ransfer） API：应用程序接口（Application Programming Interface） XML：可扩展标记语言（eXtensible Markup Language） UML：统一建模语言(Unified Modeling Language) JSON：JavaScript对象简谱(JavaScript Object Notation) WSDL：Web服务描述语言（Web Services Description Language） DB63/T 18282020 3 5 数据基本规定 5.1 数学基础 坐标系统采用2000国家大地坐标系（China Geodetic
7、Coordinate System 2000，简称CGCS2000）。 高程系按照采用1985国家高程基准。 投影方式按照GB 21139执行。 5.2 元数据必填项 元数据是关于可共享和交换的各类空间数据的核心描述信息，用于查询、检索和查看数据概况，元 数据文件标准格式为XML格式。 6 数据服务内容 6.1 数据目录 地质气象灾害空间专题数据内容如表1所示。 表1 数据分层 要素类 要素细类 要素类名称 滑坡 LX-HP 泥石流 LX-NSL 灾害类型 崩塌 LX-BT 威胁范围 QY-WXFW 灾害区域 灾害点 QY-ZHD 省、直辖市界 QH-SJ 行政区域界线 县（市）、区界 QH-
8、QJ 监测 监测点 JC 气温 QX-QW 降水 QX-JS 降水相态 QX-JSXT 风速 QX-FS 风向 QX-FX 气象基本信息 空气相对湿度 QX-SD 冰雹 ZHQX-BB 暴雨 ZHQX-BY 连阴雨 ZHQX-LYY 干旱 ZHQX-GH 雪灾 ZHQX-XZ 灾害性天气类型 大风 ZHQX-DF 标志、警告区标志 BS-JG 标识 灾害预警 BS-YJ DB63/T 18282020 4 6.2 属性内容 6.2.1 灾害区域 地质气象灾害区域为点或面要素矢量数据形式展现，其属性信息按照表A.1设计。 6.2.2 监测 监测类为点要素矢量数据，其属性信息按照表A.2设计。 6
9、.2.3 省、直辖市界 省、直辖市界类为线要素矢量数据，分类代码按照GB/T 2260执行，其属性信息按照表A.3设计。 6.2.4 县（市）、区界 县（市）、区界类为线要素矢量数据，分类代码按照GB/T 10114执行，其属性信息按照表A.4设计。 6.2.5 气象信息 气象信息为网格要素数据，其属性信息按照表A.5设计。 7 数据质量要求 包括数据情况说明、空间化精度、属性精度、时间精度、逻辑一致性、数据完整性以及表达的合理 性。数据情况说明包含数据获取来源、加工处理方法、使用范围等内容。 8 数据构成 地质气象灾害空间专题数据块基本构成分为3块区域单元：空间信息类、时间信息类、专题内容信
10、 息类。将以上区域单元定义为第1级数据块，每类区域单元视为一个对象，同一级别每个对象之间并列， 这些对象可独立提供。根据第1级数据块的特点，又可派生出子单元，视为第2级数据块。为保证数据模 型的可扩展性，每一个第2级数据块也可派生多个子单元。具体数据构成见图1，整个数据对象为树状结 构，父节点与子节点以一对多方式存在。 图1 地质气象灾害空间专题数据结构图 9 接口模型结构 DB63/T 18282020 5 9.1 模型资源内容 地质气象灾害空间专题数据服务（GMDS）目的是将信息资源以若干数据块的形式对外提供，并可响 应客户端面向资源的架构风格（REST）的请求使其接收3类资源。这些资源和
11、操作包括： a) 服务元数据资源（MetadataInfo），描述指定服务器实现的数据资源能力和包含的信息。在面 向过程架构风格下，对服务能力元数据资源获取操作（GetMetadataInfo）的响应服务器方必 须实现。 b) 数据块资源(DataTile)，表示某一特定区域中一个或多个空间专题数据要素响应结果数据块。 在面向过程架构风格下，对要素数据资源获取操作（GetDataTile）的响应服务器方必须实现。 c) 附加要素信息资源（OtherDataInfo）,描述某一特定区域不能以数据块形式提供的附加信息资 源。对附加要素信息资源获取操作(GetOtherDataInfo)的响应服务器
12、方可选择实现。 9.2 接口框架 服务接口抽象为2类，包括基础服务和数据服务，其相互关系和UML设计见图2。图2中GMDS基础服务 接口表示获取MetadataInfo的getMetadataInfo操作，GMDS数据服务接口表示获取DataTile、 OtherDataInfo的getDataTile和getOtherDataInfo操作。 注：在本UML图中，每个操作的请求与响应显示为一个参数，该参数又是一个包含多个更低层级参数的数据结构， 这些数据结构将在10.2.3和10.3.3中讨论。 图2 服务接口模型UML设计图 10 接口实现模型 10.1 服务元数据 10.1.1 服务元数据
13、文档 MetadataInfo文档是getMetadataInfo请求的响应文档，也是对正确端点发起标准请求的响应文档。 它是入口资源，描述了服务中可用的资源以及连接该服务的必备条件。 MetadataInfo文档包括服务名称、服务机构说明、支持操作及其说明、服务内容元数据、各数据块 结构的元数据。该文档不限于上述要素，可自定义扩展要素内容。文档标准格式为XML格式，其组成结 构包括但不限于附录B文档实例内容。 DB63/T 18282020 6 10.1.2 服务元数据文档说明 MetadataInfo文档包括表2中所有的子集，但是可以请求只包括部分这些子集的文档，具体内容说 明如下： 表2
14、 MetadataInfo说明 名称 定义 数据类型与取值 出现次数与用法 version getMetadataInfo操作响 应的标准版本 字符串，非空 取值为x.y.z的值列表如 1.0.0 1(必选) WSDL 对WSDL资源的引用 URL类型 0或1（可选） serviceMetadataURL 对ServiceMetadata 资 源的引用 URL类型 0或1 在REST风格下是必选的 serviceIdentification 关于该指定服务器的元 数据 0或1（可选） serviceProvider 关于运作该服务器的机 构的元数据 0或1（可选） operationsMeta
15、data 关于该服务提供的操作 的元数据 0或3（可选） contents 关于该服务器提供服务 的数据的元数据 0或1（可选） 10.1.3 服务元数据文档UML模型 MetadataInfo文档包括5个子集类，各子集类的组成、相互间的具体关系以及每个子集类包含的必 要属性信息见图3的UML类图。 DB63/T 18282020 7 图3 MetadataInfo的UML类图 10.1.4 getMetadataInfo操作 getMetadataInfo操作允许客户端从服务器获取一个服务元数据文档。对getMetadataInfo请求的响 应为一个包含关于服务器的服务元数据文档，包括关于服
16、务提供信息、可以请求的数据列表以及这些数 据的细节信息。getMetadataInfo操作还包含一个版本协商机制，让客户端与服务器就标准版本达成一 致并基于此进行之后的通信。getMetadataInfo操作服务接口UML模型设计见图4。 DB63/T 18282020 8 注：所有的GMDS数据服务通用接口定义getMetadataInfo操作，MetadataInfo抽象类是getMetadataInfo操作返回的 数据类，具体数据构成在表2中。 图4 getMetadataInfo的UML模型 10.2 数据块 10.2.1 数据块资源 GMDS服务器是用来提供数据块服务的。前面说明的服
17、务元数据文档列出了服务器上可用的数据块以 及请求数据块的要求。典型情况是客户端先从服务器请求一个服务元数据文档，然后根据该文档中提供 的信息确定如何发送获取数据块的有效请求。 数据块资源通常是一个包含地质气象灾害空间专题数据内容的描述段。数据描述结构具体见表3， 由时空模块和扩展模块组成，每项数据内容都有相应标签进行标识。数据块标准格式为JSON格式，其实 例见附录C数据块实例内容。 DB63/T 18282020 9 表3 数据块结构 结构名称 模块内容 编码内容 空间信息 type:Feature, properties:, geometry: type:空间要素类型, coordinat
18、es:坐标值 时空模块 时间信息 type:Time, time:XXXXXXXXXXXXXX 扩展模块 气象专题数据 地质灾害专题数据 基础地理空间数据 其他信息 type:Other, info: 信息名称:信息内容 10.2.2 数据块资源请求说明 getDataTile操作可以让客户端以预定义的格式请求某一块阵集中的特定数据块资源。该操作允许 多个数据层组合起来提供服务，必须给这种数据层组合一个标识符并作为一个新的数据层添加到服务元 数据文档中。getDataTile操作参数包括表4中所有的子集，但是可以请求只包括部分这些子集的参数， 具体参数要求见表4。 表4 getDataTile
19、操作请求参数 名称 定义 数据类型与取值 出现次数与用法 service 服务类型标识符 字符串，非空，固定取值为GMDS 1(必选) request 操作名 字符串，非空，固定取值为GetDataTile 1(必选) version 操作的标准版本 字符串，非空，应包含1.0.0 1(必选) layers 图层列表获取标识 符 字符串，非空，固定取值为layers 0或1(可选) layerid 图层标识符 字符串，非空，MetadataInfo文档中定义 的标识符，包含表1中定义的要素层名 0或1(可选) attributeName 图层属性标识符 字符串，非空，图层自定义值，包含附录 A
20、表格中定义的字段命名 0或1(可选) dataTileAttribute 图层属性值 字符串或数值，非空，attributeName中 定义的值域或值列表中的一个值。 1(必选) attributeQueryString 图层条件查询标识 符 字符串，非空，固定取值为query 0或1(可选) dataTileAttributeScope 条件查询字符串 字符串，非空，条件查询字符串，条件之 间以&作为连接 1(必选) 10.2.3 getDataTile操作的UML模型 DB63/T 18282020 10 getDataTile操作分为图层列表请求与按属性内容查询请求2种操作模式。图层列表
21、请求返回可提供 的数据图层列表及其属性相关信息，按属性内容查询请求是通过属性条件查询的方式返回客户端需要的 数据块资源。getDataTile操作从以上2种操作模式中必须选择其中一种作为请求的内容。getDataTile 操作服务接口UML模型设计见图5。 注：DataTile类是getDataTile操作返回的数据类，服务类型来源于MetadataInfo文本。DataTileAttribute和 DataTileAttributeScope是按属性内容查询请求操作模式进行请求时提供的数据类型，具体数据说明在表4中。 图5 getDataTile的UML模型 10.3 附加要素 10.3.1
22、 附加要素资源 DB63/T 18282020 11 附加要素信息（OtherDataInfo）是客户端针对某一特定区域请求获取的附加信息。GMDS服务器支 持对某一特定区域非数据块形式的OtherDataInfo的查询请求。GMDS服务器提供位于客户端请求中指定 位置上或附近要素的信息，并由该服务器决定这些要素的具体形式。 附加要素资源通常是一个表述与地质气象灾害空间专题信息相关的文档或图片资源。 10.3.2 附加要素资源请求说明 OtherDataInfo由getOtherDataInfo操作请求响应。该操作只允许单个文件信息提供服务或接受请 求。OtherDataInfo信息列表在Me
23、tadataInfo明确列出。getOtherDataInfo操作参数包括表5中所有的子 集，但是可以请求只包括部分这些子集的参数，具体参数要求见表5。 表5 getOtherDataInfo操作请求参数 名称 定义 数据类型与取值 出现次数与用法 service 服务类型标识符 字符串，非空，固定取值为GMDS 1(必选) request 操作名 字符串，非空，固定取值为 GetOtherDataInfo 1(必选) version 操作的标准版本 字符串，非空，应包含1.0.0 1(必选) infoList 附加要素列表获取 标识符 字符串，非空，固定取值为infolist 0或1(可选)
24、 layerName 附加要素标识符 字符串，非空，附加要素自定义的标识符 0或1(可选) otherDataInfoIdentifier 附加要素标识符 字符串或数值，非空，layerName中定义 的值域或值列表中的一个值。 1(必选) 10.3.3 getOtherDataInfo操作的UML模型 getOtherDataInfo操作分为文件列表请求与按标识符查询请求2种操作模式。文件列表请求返回可 提供的所有文件列表，按标识符查询请求是通过文件信息标识符查询的方式返回客户端需要的附加要素 资源。getOtherDataInfo操作从以上2种操作模式中必须选择其中一种作为请求的内容。 g
25、etOtherDataInfo操作服务接口UML模型设计见图6。 DB63/T 18282020 12 图6 getOtherDataInfo的UML模型 11 接口规则 11.1 接口分类 根据本规范对交换的数据进行整合，以数据资源和服务两种方式提供在线共享。同时为便于现有各 类信息化系统对以上GMDS的调用，规定以XML和JSON方式提供信息服务。GMDS服务器的API由一组分别指 向服务元数据文档、各个数据块以及附加要素信息的规范URL组成,API以REST风格进行编码。服务元数 据文档是唯一的入口，其他URL端点都可以通过分析服务元数据文档中每个数据块内各个内容模板来获 得。 11.2
26、 协议 GMDS服务器与客户端的文本传输协议使用HTTPS协议，确保交互数据的传输安全。 11.3 getMetadataInfo操作编码 响应一个客户端针对GMDS服务器getMetadataInfo操作的请求，GMDS服务器应发送该服务器能够提 供数据服务的元数据信息资源的引用。网址模板中变量与值的排列顺序是固定的，采用如下模板顺序： https:/GMDS Server/GMDS/getMetadataInfo/1.0.0/MetadataInfo.xml。 DB63/T 18282020 13 11.4 getDataTile操作编码 11.4.1 getDataTile请求概述 响应
27、一个客户端针对GMDS服务器getDataTile操作的请求，GMDS服务器应发送一个包含与某一符合 查询条件区域相关的专题空间信息资源的引用。网址模板中变量与值的排列顺序分为图层列表请求与属 性内容查询请求。 11.4.2 图层列表请求编码模板 https:/GMDS Server/GMDS/GetDataTile/1.0.0/layers。 11.4.3 属性内容查询请求编码模板 按属性内容查询请求操作包括单属性查询和多属性条件查询。模板中“”符号中的参数按照表4 的参数要求进行设置。 单属性查询模板： https:/GMDS Server/GMDS/GetDataTile/1.0.0/l
28、ayerid/attributeName/dataTileAttribute 多属性条件查询模板： https:/GMDS Server/GMDS/GetDataTile/1.0.0/query/dataTileAttributeScope 11.5 getOtherDataInfo操作编码 11.5.1 getOtherDataInfo请求概述 响应一个客户端针对GMDS服务器getOtherDataInfo操作的请求，GMDS服务器应发送一个包含与某一 符合查询条件的附加要素资源的引用。网址模板中变量与值的排列顺序分为文件列表请求与标识符查询 请求。模板中“”符号中的参数按照表5的参数要求
29、进行设置。 11.5.2 文件列表请求编码模板 https:/GMDS Server/GMDS/GetOtherDataInfo/1.0.0/infolist。 11.5.3 标识符查询请求编码模板 https:/GMDS Server/GMDS/GetOtherDataInfo/1.0.0/otherDataInfoIdentifier。 11.6 操作请求异常 当GMDS服务器在执行getMetadataInfo、getDataTile、getOtherDataInfo操作出错时，应返回一个 异常代码消息。可用的标准异常代码包括在表6中的列出的代码。当GMDS服务器响应一个异常代码消息，
30、该异常消息通过HTTP传输。GMDS服务器根据表6给定的异常代码值与状态码对应关系设定相应的HTTP响 应状态代码。 DB63/T 18282020 14 表6 操作异常代码及其含义 异常代码值 代码含义 HTTP状态代码 消息 OperationNotSupported 请求的操作本服务器不支持 501 未实现 MissingParameterValue 操作请求不包含参数值，服务器也没有为此参数申 明默认值 400 不良请求 InvalidParameterValue 操作请求包含无效参数值 400 不良请求 DataTileOutOfRange 条件查询取值不在值域范围内 400 不良请
31、求 NoApplicableCode 该服务或服务器没有为此异常定义异常代码 500 服务器内部错误 11.7 返回数据 API接口成功接到请求，则返回HTTP状态代码为200。GMDS数据的返回格式采用固定的数据格式封装。 接口返回模板如下： status:0, data:|, msg: 模板说明如下： （1）status：接口的执行的状态，=0表示成功；0 表示有异常=。 （2）data：接口的主数据，返回内容按照表3表述的方式组织。 （3）msg：错误信息，当status!=0 都应该有错误信息，信息包含在表6中。 11.8 接口安全 接口的安全性策略实现方式包括但不限于授权、时间戳、签
32、名和访问地址限制4种机制，并保证接 口的数据不会被篡改、注入攻击和重复调用。 DB63/T 18282020 15 A A 附 录 A （资料性附录） 数据属性内容构成 表A.1 灾害区域属性表 字段命名 别名 字段类型 描述语义 FCODE 灾害代码 Text（64） 灾害分类代码 ZHBH 灾害编号 Text（5） 站位编号 LX 灾害类型 Text（255） 灾害类型 ZHWZ 灾害位置 GEO 灾害发生区域 表A.2 监测类属性表 字段命名 别名 字段类型 描述语义 NAME 监测名称 Text（255） 监测点名称 JCWZ 监测位置 Text（1024） 监测点地址描述或坐标信息
33、JCNR 监测内容描述 Text（255） 监测点内容概况 表A.3 省、直辖市界类属性信息 字段命名 别名 字段类型 描述语义 FCODE 分类代码 Text（64） 分类代码 LJJM 邻接界名 Text（64） 邻接界名 表A.4 县（市）、区界类属性表 字段命名 别名 字段类型 描述语义 FCODE 分类代码 Text（64） 分类代码 LJJM 邻接界名 Text（64） 邻接界名 表A.5 气象信息属性表 字段命名 别名 字段类型 描述语义 FCODE 分类代码 Text（64） 分类代码 NAME 网格位置信息 GEO ZHQX 灾害性天气类型 Text（255） 该网格位置发生
34、灾害性天气的类型，其类型按照QX/T 342补充 QX-QW 气温 Text（255） QX-JS 降水 Text（255） QX-JSXT 降水相态 Text（255） QX-FX 风向 Text（255） QX-FS 风速 Text（255） QX-FSL 辐射 Text（255） DB63/T 18282020 16 表A.5 （续） 字段命名 别名 字段类型 描述语义 QX-YL 云量 Text（255） QX-SD 相对湿度 Text（255） DB63/T 18282020 17 B B 附 录 B （资料性附录） XML文档实例 B.1 引言 本附录提供了包含GMDS服务元数据信
35、息的XML文档实例。 B.2 MetadataInfo响应实例 以下是一个完整的具有REST风格的GMDS服务元数据文档实例。 Disaster Spatial Data Services GMDS 1.0.0 none 青海省自然资源厅 *.* +86 *-* 城西区黄河路15号测绘大厦 西宁 青海 中国 810001 DB63/T 18282020 18 https:/GMDS Server/GMDS/getMetadataInfo/1.0.0/MetadataInfo.xml https:/GMDS Server/GMDS/GetDataTile/1.0.0/ https:/GMDS S
36、erver/GMDS/GetOtherDataInfo/1.0.0/ 省级行政界线 ProvincialAdministrativeBoundary -180 -90 DB63/T 18282020 19 180 90 CGCS 2000 geojson DB63/T 18282020 20 C C 附 录 C （资料性附录） 数据块实例 C.1 引言 本附录提供了GMDS服务器提供的数据块的JSON实例。 C.2 数据块实例 以下是一个完整的JSON格式的GMDS服务数据块实例。 type:Feature, properties: FCODE:630102 , geometry: type:
37、Line, coordinates:101.8290,36.6543,101.8339,36.6450, 101.8460,36.6398,101.8499,36.6419, 101.8619,36.6381,101.8509,36.6180, 101.8669,36.6096,101.8789,36.6133, 101.8789,36.6049,101.8880,36.6054, 101.9150,36.5619,101.8919,36.5329, 101.8430,36.5290,101.8330,36.5339, 101.8280,36.5279,101.8209,36.5404, 10
38、1.8209,36.5404,101.8119,36.5336, 101.7990,36.5411,101.7819,36.5550, 101.7799,36.5768,101.7740,36.5861, 101.7880,36.5923,101.7809,36.5984, 101.7860,36.6049,101.7839,36.6077, 101.7860,36.6114,101.7839,36.6139, 101.7959,36.6274,101.7919,36.6292, 101.7959,36.6342,101.8010,36.6472, 101.8119,36.6528 type:Time, DB63/T 18282020 21 time:20200324152112 type:Other, info: Name:城东区 _
