DB63T 1828-2020地理信息公共服务 地质气象灾害空间专题数据服务接口规范

ICS5.240.70A75青海省地DB63方标准DBT1828—2020青海省市场监督管理局发布IDBT28—2020前言GBT1.1-2009给出的规则起草。省自然资源厅提出并归口。境监测总站。、刘楠、宋福魁、王转、魏赛拉加、辛倩男、史飞飞。海省自然资源厅监督实施。1DBT28—2020地理信息公共服务地质气象灾害空间专题数据服务接口规范成、接口模型结构、接口实现模型、接口规则等内容。范性引用文件凡是不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。GBT260中华人民共和国行政区划代码GBT10113分类与编码通用术语GBT10114县级以下行政区划代码编制规则GBT6820地图学术语GBT710地理信息元数据GB21139基础地理信息标准数据基本规定QXT342气象灾害预警信息编码规范定义GBTGBTGBT列术语和定义适用于本文件。息交换时需要遵从的通信方式和要求。息。质灾害。2DBT28—2020事物或概念的一个或一组字符。T程。间专题数据质气象灾害专题属性信息的空间数据。客户端必须共同遵从的一组约定。服务所需的分析功能、数据资源及其运行支撑环境的系统。4缩略语GMDS：地质气象灾害空间数据服务(GeologicalandMeteorologicalDisasterSpatialDataesHTTPSHyperTextTransferProtocoloverSecureSocketLayer)REST资源架构风格(RepresentationalStateTransfer)API：应用程序接口(ApplicationProgrammingInterface)XML言(eXtensibleMarkupLanguage)UML统一建模语言(UnifiedModelingLanguage)JSONJavaScript谱(JavaScriptObjectNotation)WSDL：Web服务描述语言(WebServicesDescriptionLanguage)3DBT28—2020数据基本规定5.1数学基础GCS国家高程基准。GB139执行。5.2元数据必填项XML式。服务内容数据目录空间专题数据内容如表1所示。PSLTXFWHDJ县(市)、区界JWSSXTSXDXBBXBYXLYYXGHXXZXDF标志BSJGBSYJ4DBT28—2020属性内容灾害区域A。2监测量数据，其属性信息按照表A.2设计。省、直辖市界GBT表A.3设计。6.2.4县(市)、区界气象信息素数据，其属性信息按照表A.5设计。量要求据情况说明包含数据获取来源、加工处理方法、使用范围等内容。数据构成地质气象灾害空间专题数据块基本构成分为3块区域单元：空间信息类、时间信息类、专题内容信子节点以一对多方式存在。结构图9接口模型结构5DBT28—20209.1模型资源内容面向资源的架构风格(REST)的请求使其接收3类资源。这些资源和操作包括：向过程架构风格下，对服务能力元数据资源获取操作(GetMetadataInfo)的响应服务器方必b)数据块资源(DataTile)，表示某一特定区域中一个或多个空间专题数据要素响应结果数据块。要素信息资源获取操作(GetOtherDataInfo)的响应服务器方可选择实现。9.2接口框架erDataInfogetDataTilegetOtherDataInfo注：在本UML图中，每个操作的请求与响应显示为一个参数，该参数又是一个包含多个更低层级参数的数据结构，据结构将在10.2.3和10.3.3中讨论。资源，描述了服务中可用的资源以及连接该服务的必备条件。fo结构的元数据。该文档不限于上述要素，可自定义扩展要素内容。文档标准格式为XML格式，其组成结B文档实例内容。6DBT28—2020明MetadataInfo文档包括表2中所有的子集，但是可以请求只包括部分这些子集的文档，具体内容说ion，非空WSDLtaURLficationeronsMetadataMetadataInfo文档包括5个子集类，各子集类的组成、相互间的具体关系以及每个子集类包含的必3的UML类图。7DBT28—2020据的细节信息。getMetadataInfo操作还包含一个版本协商机制，让客户端与服务器就标准版本达成一之后的通信。getMetadataInfo操作服务接口UML模型设计见图4。8DBT28—2020GMDS义getMetadataInfo操作，MetadataInfo抽象类是getMetadataInfo操作返回的构成在表2中。定如何发送获取数据块的有效请求。数据块资源通常是一个包含地质气象灾害空间专题数据内容的描述段。数据描述结构具体见表3，C实例内容。9DBT28—2020构{eaturetiesypeoordinates}}{imeXXXXXXXXXX}据据{ther}}明getDataTile操作可以让客户端以预定义的格式请求某一块阵集中的特定数据块资源。该操作允许表4。空，固定取值为"GMDS"estion本串，非空，应包含"1.0.0"符空，固定取值为"layers"uteName层自定义值，包含附录ttribute个值。uteQueryString符空，固定取值为"query"ttributeScope件查询字符串，条件之DBT28—2020数据块资源。getDataTile操作从以上2种操作模式中必须选择其中一种作为请求的内容。getDataTile口UML模型设计见图5。注：DataTile类是getDataTile操作返回的数据类，服务类型来源于MetadataInfo文本。DataTileAttribute和taTileAttributeScopeDBT28—2020OtherDataInfo端针对某一特定区域请求获取的附加信息。GMDS服务器支持对某一特定区域非数据块形式的OtherDataInfo的查询请求。GMDS服务器提供位于客户端请求中指定或附近要素的信息，并由该服务器决定这些要素的具体形式。灾害空间专题信息相关的文档或图片资源。说明OtherDataInfo由getOtherDataInfo操作请求响应。该操作只允许单个文件信息提供服务或接受请可以请求只包括部分这些子集的参数，具体参数要求见表5。空，固定取值为"GMDS"est非空，固定取值为ataInfoion本串，非空，应包含"1.0.0"空，固定取值为"infolist"加要素自定义的标识符taInfoIdentifiergetOtherDataInfo操作分为文件列表请求与按标识符查询请求2种操作模式。文件列表请求返回可getOtherDataInfo口UML模型设计见图6。DBT28—2020SAPI向服务元数据文档、各个数据块以及附加要素信息的规范URL组成,API以REST风格进行编码。服务元数据文档是唯一的入口，其他URL端点都可以通过分析服务元数据文档中每个数据块内各个内容模板来获GMDS与客户端的文本传输协议使用HTTPS协议，确保交互数据的传输安全。针对GMDS服务器getMetadataInfo操作的请求，GMDS服务器应发送该服务器能够提httpsGMDSServer/GMDS/getMetadataInfo/1.0.0/MetadataInfo.xml。DBT28—2020e针对GMDS服务器getDataTile操作的请求，GMDS服务器应发送一个包含与某一符合请求。模板httpsGMDSServerGMDS/GetDataTile/1.0.0/layers。编码模板按属性内容查询请求操作包括单属性查询和多属性条件查询。模板中“{}”符号中的参数按照表4属性查询模板：httpsGMDSServerGMDSGetDataTile/{layerid}/{attributeName}/{dataTileAttribute}属性条件查询模板：httpsGMDSServerGMDS/GetDataTile/1.0.0/query/{dataTileAttributeScope}模板中“{}”符号中的参数按照表5的参数要求进行设置。模板httpsGMDSServer/GMDS/GetOtherDataInfo/1.0.0/infolist。码模板httpsGMDSServerGMDS/GetOtherDataInfo/1.0.0/{otherDataInfoIdentifier}。该异常消息通过HTTP传输。GMDS服务器根据表6给定的异常代码值与状态码对应关系设定相应的HTTP响。DBT28—2020代码及其含义ationNotSupported服务器不支持MissingParameterValuerValue无效参数值taTileOutOfRange值域范围内NoApplicableCode此异常定义异常代码如下：{msg:’’}下：(1)status：接口的执行的状态，=0表示成功；<0表示有异常=""。(2)data：接口的主数据，返回内容按照表3表述的方式组织。(3)msg：错误信息，当status!=0都应该有错误信息，信息包含在表6中。接口的安全性策略实现方式包括但不限于授权、时间戳、签名和访问地址限制4种机制，并保证接。DBT28—2020A(资料性附录)构成A属性表ODEText4)Text)Text55)A性表NAMEText55)Text024)坐标信息Text55)A市界类属性信息ODEText4)Text4)A、区界类属性表ODEText4)Text4)A属性表ODEText4)NAMEText55)WText55)SText55)SXTText55)XText55)SText55)SLText55)DBT28—2020LText55)DText55)DBT8—2020(资料性附录)B.1引言GMDS服务元数据信息的XML文档实例。BMetadataInfo应实例Sxmlversionencoding"UTF-8"?>MetadataInfoversionificationsasterSpatialDataServicesTitlepeGMDSServiceTypeceTypeVersionServiceTypeVersiontraintsnoneAccessConstraintstificationoviderProviderNameProviderNameactfoEMail</EMail>Facsimile****</Facsimile>CompanyAddress厦<CompanyAddress>tystrativeAreaAdministrativeArearyCountryostalCodePostalCodefotactovidersonnameGetMetadataInfotocolDBT8—2020ntnameGetEncodinghttpsGMDSServerGMDSgetMetadataInfo1.0.0/MetadataInfo.xmlotocolonnamegetDataTiletocolntnameGetEncodinghttps/GMDSServer/GMDS/GetDataTile/1.0.0/otocolnnamegetOtherDataInfotocolntnameGetEncodinghttps/GMDSServer/GMDS/GetOtherDataInfo/1.0.0/otocolnsitleTitleerProvincialAdministrativeBoundaryIdentifierBoxowerCornerLowerCornerDBT8—2020perCornerUpperCornerteBoxordinateIdentifierCGCSCoordinateIdentifiereojsonFo