DB63∕T 1828-2020 地理信息公共服務(wù) 地質(zhì)氣象災(zāi)害空間專題數(shù)據(jù)服務(wù)接口規(guī)范

35.240.70A

75DB63 DB63/T

1828—2020地理信息公共服務(wù)地質(zhì)氣象災(zāi)害空間專題數(shù)據(jù)服務(wù)接口規(guī)范 青海省市場監(jiān)督管理局 發(fā)

布DB63/T

1828—2020 本標(biāo)準(zhǔn)按照GB/T

1.1-2009給出的規(guī)則起草。本標(biāo)準(zhǔn)由青海省自然資源廳提出并歸口。局、青海省地質(zhì)環(huán)境監(jiān)測總站。歐爾格力、張晶、牛艷霞、劉楠、宋?？?、王轉(zhuǎn)、魏賽拉加、辛倩男、史飛飛。本標(biāo)準(zhǔn)由青海省自然資源廳監(jiān)督實(shí)施。DB63/T

1828—2020

1 范圍據(jù)構(gòu)成、接口模型結(jié)構(gòu)、接口實(shí)現(xiàn)模型、接口規(guī)則等內(nèi)容。間數(shù)據(jù)交換和共享平臺也可參照使用。2規(guī)范性引用文件件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T

2260 中華人民共和國行政區(qū)劃代碼GB/T

10113 分類與編碼通用術(shù)語GB/T

10114 縣級以下行政區(qū)劃代碼編制規(guī)則GB/T

16820 地圖學(xué)術(shù)語GB/T

19710地理信息

元數(shù)據(jù)GB

21139 基礎(chǔ)地理信息標(biāo)準(zhǔn)數(shù)據(jù)基本規(guī)定QX/T

氣象災(zāi)害預(yù)警信息編碼規(guī)范3 術(shù)語和定義GB/T

16820、GB/T

19710界定的以及下列術(shù)語和定義適用于本文件。3.1接口進(jìn)行信息交換時需要遵從的通信方式和要求。3.2元數(shù)據(jù)關(guān)于數(shù)據(jù)的數(shù)據(jù)。即數(shù)據(jù)的標(biāo)識、覆蓋范圍、質(zhì)量、空間和時間模式、空間參照系和分發(fā)等信息。[GB/T

19710，定義4.5]3.3地質(zhì)氣象災(zāi)害由典型氣象事件（強(qiáng)降水等）作為觸發(fā)因子而引發(fā)的突發(fā)性地質(zhì)災(zāi)害。DB63/T

1828—20203.4代碼表示特定事物或概念的一個或一組字符。[GB/T

10113，定義2.2.5]3.5矢量數(shù)據(jù)以坐標(biāo)或有序坐標(biāo)串表示的空間點(diǎn)、線、面等圖形數(shù)據(jù)及與其相聯(lián)系的有關(guān)屬性數(shù)據(jù)的總稱。[GB/T

16820，定義5.13]3.6交換專題數(shù)據(jù)的過程。3.7地質(zhì)氣象災(zāi)害空間專題數(shù)據(jù)集中表現(xiàn)地質(zhì)氣象災(zāi)害專題屬性信息的空間數(shù)據(jù)。3.8協(xié)議服務(wù)器端和客戶端必須共同遵從的一組約定。3.9空間信息化平臺實(shí)現(xiàn)提供空間信息服務(wù)所需的分析功能、數(shù)據(jù)資源及其運(yùn)行支撐環(huán)境的系統(tǒng)。4 縮略語下列縮略語適用于本文件。GMDS：地質(zhì)氣象災(zāi)害空間數(shù)據(jù)服務(wù)（Geological

Disaster

Spatial

DataServices）HTTPS：超文本傳輸安全協(xié)議（Hyper

Text

Transfer

Protocol

over

SecureSocket

REST：面向資源架構(gòu)風(fēng)格（Representational

Transfer）API：應(yīng)用程序接口（Application

XML：可擴(kuò)展標(biāo)記語言（eXtensible

UML：統(tǒng)一建模語言(Unified

Modeling

Language)JSON：JavaScript對象簡譜(JavaScript

Object

WSDL：Web服務(wù)描述語言（Web

Services

Language）LX-HPLX-NSLLX-BTQY-WXFWQY-ZHDQH-SJQH-QJJCQX-QWQX-JSQX-JSXTQX-FSQX-FXQX-SDZHQX-BBZHQX-BYZHQX-LYYZHQX-GHZHQX-XZZHQX-DFBS-JGBS-YJDB63/T

1828—20205 數(shù)據(jù)基本規(guī)定5.1 數(shù)學(xué)基礎(chǔ)坐標(biāo)系統(tǒng)采用2000國家大地坐標(biāo)系（China

Coordinate

高程系按照采用1985國家高程基準(zhǔn)。投影方式按照GB

21139執(zhí)行。5.2元數(shù)據(jù)必填項(xiàng)數(shù)據(jù)文件標(biāo)準(zhǔn)格式為XML格式。6 數(shù)據(jù)服務(wù)內(nèi)容6.1數(shù)據(jù)目錄地質(zhì)氣象災(zāi)害空間專題數(shù)據(jù)內(nèi)容如表1所示。表1 數(shù)據(jù)分層DB63/T

1828—20206.2 屬性內(nèi)容6.2.1 災(zāi)害區(qū)域地質(zhì)氣象災(zāi)害區(qū)域?yàn)辄c(diǎn)或面要素矢量數(shù)據(jù)形式展現(xiàn)，其屬性信息按照表A.1設(shè)計(jì)。6.2.2 監(jiān)測監(jiān)測類為點(diǎn)要素矢量數(shù)據(jù)，其屬性信息按照表A.2設(shè)計(jì)。6.2.3 省、直轄市界省、直轄市界類為線要素矢量數(shù)據(jù)，分類代碼按照GB/T

2260執(zhí)行，其屬性信息按照表A.3設(shè)計(jì)。6.2.4 縣（市）、區(qū)界

6.2.5 氣象信息氣象信息為網(wǎng)格要素?cái)?shù)據(jù)，其屬性信息按照表A.5設(shè)計(jì)。7數(shù)據(jù)質(zhì)量要求性。數(shù)據(jù)情況說明包含數(shù)據(jù)獲取來源、加工處理方法、使用范圍等內(nèi)容。8 數(shù)據(jù)構(gòu)成地質(zhì)氣象災(zāi)害空間專題數(shù)據(jù)塊基本構(gòu)成分為3塊區(qū)域單元：空間信息類、時間信息類、專題內(nèi)容信構(gòu)，父節(jié)點(diǎn)與子節(jié)點(diǎn)以一對多方式存在。圖1 地質(zhì)氣象災(zāi)害空間專題數(shù)據(jù)結(jié)構(gòu)圖9 接口模型結(jié)構(gòu)DB63/T

1828—20209.1 模型資源內(nèi)容應(yīng)客戶端面向資源的架構(gòu)風(fēng)格（REST）的請求使其接收3類資源。這些資源和操作包括：a)

向過程架構(gòu)風(fēng)格下，對服務(wù)能力元數(shù)據(jù)資源獲取操作（GetMetadataInfo）的響應(yīng)服務(wù)器方必須實(shí)現(xiàn)。b)

數(shù)據(jù)塊資源(DataTile)，表示某一特定區(qū)域中一個或多個空間專題數(shù)據(jù)要素響應(yīng)結(jié)果數(shù)據(jù)塊。c)

源。對附加要素信息資源獲取操作(GetOtherDataInfo)的響應(yīng)服務(wù)器方可選擇實(shí)現(xiàn)。9.2 接口框架接口表示獲取MetadataInfo的操作，GMDS數(shù)據(jù)服務(wù)接口表示獲取DataTile、OtherDataInfo的getDataTile和getOtherDataInfo操作。在本UML圖中，每個操作的請求與響應(yīng)顯示為一個參數(shù)，該參數(shù)又是一個包含多個更低層級參數(shù)的數(shù)據(jù)結(jié)構(gòu)，這些數(shù)據(jù)結(jié)構(gòu)將在10.2.3和10.3.3中討論。圖2 服務(wù)接口模型

設(shè)計(jì)圖10接口實(shí)現(xiàn)模型10.1服務(wù)元數(shù)據(jù)10.1.1服務(wù)元數(shù)據(jù)文檔它是入口資源，描述了服務(wù)中可用的資源以及連接該服務(wù)的必備條件。結(jié)構(gòu)的元數(shù)據(jù)。該文檔不限于上述要素，可自定義擴(kuò)展要素內(nèi)容。文檔標(biāo)準(zhǔn)格式為XML格式，其組成結(jié)構(gòu)包括但不限于附錄B文檔實(shí)例內(nèi)容。versiongetMetadataInfo

x.y.z1.0.01(必選)WSDL

WSDL

URL

1（可選）serviceMetadataURL

ServiceMetadata

URL

0或1

REST

serviceIdentification

1（可選）serviceProvider

1（可選）operationsMetadata

3（可選）contents

1（可選）DB63/T

1828—202010.1.2 服務(wù)元數(shù)據(jù)文檔說明MetadataInfo文檔包括表2中所有的子集，但是可以請求只包括部分這些子集的文檔，具體內(nèi)容說明如下：表2MetadataInfo

說明10.1.3 服務(wù)元數(shù)據(jù)文檔

UML

模型MetadataInfo文檔包括5個子集類，各子集類的組成、相互間的具體關(guān)系以及每個子集類包含的必要屬性信息見圖3的UML類圖。DB63/T

1828—2020圖3 MetadataInfo

的

類圖10.1.4 getMetadataInfo

操作據(jù)的細(xì)節(jié)信息。getMetadataInfo操作還包含一個版本協(xié)商機(jī)制，讓客戶端與服務(wù)器就標(biāo)準(zhǔn)版本達(dá)成一致并基于此進(jìn)行之后的通信。getMetadataInfo操作服務(wù)接口UML模型設(shè)計(jì)見圖4。DB63/T

1828—2020數(shù)據(jù)類，具體數(shù)據(jù)構(gòu)成在表2中。圖4getMetadataInfo

的

UML

模型10.2 數(shù)據(jù)塊10.2.1 數(shù)據(jù)塊資源的信息確定如何發(fā)送獲取數(shù)據(jù)塊的有效請求。數(shù)據(jù)塊資源通常是一個包含地質(zhì)氣象災(zāi)害空間專題數(shù)據(jù)內(nèi)容的描述段。數(shù)據(jù)描述結(jié)構(gòu)具體見表3，例見附錄C數(shù)據(jù)塊實(shí)例內(nèi)容。service字符串，非空，固定取值為"GMDS"1(必選)request1(必選)version字符串，非空，應(yīng)包含"1.0.0"1(必選)layers字符串，非空，固定取值為"layers"

layerid

attributeName

dataTileAttribute字符串或數(shù)值，非空，attributeName

1(必選)attributeQueryString字符串，非空，固定取值為"query"

dataTileAttributeScope間以"&"作為連接1(必選)"type":"Feature","coordinates":[坐標(biāo)值]"type":"Time","type":"Other",DB63/T

1828—2020表3數(shù)據(jù)塊結(jié)構(gòu)10.2.2 數(shù)據(jù)塊資源請求說明getDataTile操作可以讓客戶端以預(yù)定義的格式請求某一塊陣集中的特定數(shù)據(jù)塊資源。該操作允許數(shù)據(jù)文檔中。getDataTile操作參數(shù)包括表4中所有的子集，但是可以請求只包括部分這些子集的參數(shù)，具體參數(shù)要求見表4。表4 getDataTile

操作請求參數(shù)10.2.3getDataTile

操作的

UML

模型DB63/T

1828—2020數(shù)據(jù)塊資源。getDataTile操作從以上2種操作模式中必須選擇其中一種作為請求的內(nèi)容。getDataTile操作服務(wù)接口UML模型設(shè)計(jì)見圖5。DataTile是getDataTile于MetadataInfo。DataTileAttribute圖5getDataTile

的

UML

模型10.3 附加要素10.3.1 附加要素資源10service字符串，非空，固定取值為"GMDS"1(必選)request"GetOtherDataInfo"1(必選)version字符串，非空，應(yīng)包含"1.0.0"1(必選)infoList字符串，非空，固定取值為"infolist"

layerName

otherDataInfoIdentifier字符串或數(shù)值，非空，layerName

1(必選)DB63/T

1828—2020附加要素信息（OtherDataInfo）是客戶端針對某一特定區(qū)域請求獲取的附加信息。GMDS服務(wù)器支持對某一特定區(qū)域非數(shù)據(jù)塊形式的OtherDataInfo的查詢請求。GMDS服務(wù)器提供位于客戶端請求中指定位置上或附近要素的信息，并由該服務(wù)器決定這些要素的具體形式。附加要素資源通常是一個表述與地質(zhì)氣象災(zāi)害空間專題信息相關(guān)的文檔或圖片資源。10.3.2 附加要素資源請求說明OtherDataInfo由getOtherDataInfo操作請求響應(yīng)。該操作只允許單個文件信息提供服務(wù)或接受請集，但是可以請求只包括部分這些子集的參數(shù)，具體參數(shù)要求見表5。表5getOtherDataInfo

操作請求參數(shù)10.3.3getOtherDataInfo

操作的

UML

模型getOtherDataInfo操作分為文件列表請求與按標(biāo)識符查詢請求2種操作模式。文件列表請求返回可資源。getOtherDataInfo操作從以上2種操作模式中必須選擇其中一種作為請求的內(nèi)容。getOtherDataInfo操作服務(wù)接口UML模型設(shè)計(jì)見圖6。11DB63/T

1828—2020圖6getOtherDataInfo

的

模型11 接口規(guī)則11.1 接口分類向服務(wù)元數(shù)據(jù)文檔、各個數(shù)據(jù)塊以及附加要素信息的規(guī)范URL組成,API以REST風(fēng)格進(jìn)行編碼。服務(wù)元數(shù)據(jù)文檔是唯一的入口，其他URL端點(diǎn)都可以通過分析服務(wù)元數(shù)據(jù)文檔中每個數(shù)據(jù)塊內(nèi)各個內(nèi)容模板來獲得。11.2協(xié)議GMDS服務(wù)器與客戶端的文本傳輸協(xié)議使用HTTPS協(xié)議，確保交互數(shù)據(jù)的傳輸安全。11.3 getMetadataInfo

響應(yīng)一個客戶端針對GMDS服務(wù)器getMetadataInfo操作的請求，GMDS服務(wù)器應(yīng)發(fā)送該服務(wù)器能夠提供數(shù)據(jù)服務(wù)的元數(shù)據(jù)信息資源的引用。網(wǎng)址模板中變量與值的排列順序是固定的，采用如下模板順序：https://GMDS

12DB63/T

1828—202011.4 getDataTile

操作編碼11.4.1 getDataTile

請求概述響應(yīng)一個客戶端針對GMDS服務(wù)器getDataTile操作的請求，GMDS服務(wù)器應(yīng)發(fā)送一個包含與某一符合性內(nèi)容查詢請求。11.4.2 圖層列表請求編碼模板https://GMDS

11.4.3屬性內(nèi)容查詢請求編碼模板按屬性內(nèi)容查詢請求操作包括單屬性查詢和多屬性條件查詢。模板中“{}”符號中的參數(shù)按照表4的參數(shù)要求進(jìn)行設(shè)置?！獑螌傩圆樵兡０澹篽ttps://GMDSServer/GMDS/GetDataTile/1.0.0/{layerid}/{attributeName}/{dataTileAttribute}——多屬性條件查詢模板：https://GMDS

11.5 getOtherDataInfo

操作編碼11.5.1 getOtherDataInfo

請求概述請求。模板中“{}”符號中的參數(shù)按照表5的參數(shù)要求進(jìn)行設(shè)置。11.5.2 文件列表請求編碼模板https://GMDS

11.5.3 標(biāo)識符查詢請求編碼模板https://GMDS

Server/GMDS/GetOtherDataInfo/1.0.0/{otherDataInfoIdentifier}。11.6 操作請求異常該異常消息通過HTTP傳輸。GMDS服務(wù)器根據(jù)表6給定的異常代碼值與狀態(tài)碼對應(yīng)關(guān)系設(shè)定相應(yīng)的HTTP響應(yīng)狀態(tài)代碼。13HTTP

OperationNotSupported501MissingParameterValue400InvalidParameterValue400DataTileOutOfRange400NoApplicableCode500DB63/T

1828—2020表6 操作異常代碼及其含義11.7 返回?cái)?shù)據(jù)接口返回模板如下：{status:0,data:{}||[],msg:’’}模板說明如下：（1）status：接口的執(zhí)行的狀態(tài)，=0表示成功；<0

表示有異常=""。（2）data：接口的主數(shù)據(jù)，返回內(nèi)容按照表3表述的方式組織。（3）msg：錯誤信息，當(dāng)status!=0

都應(yīng)該有錯誤信息，信息包含在表6中。11.8接口安全接口的安全性策略實(shí)現(xiàn)方式包括但不限于授權(quán)、時間戳、簽名和訪問地址限制4種機(jī)制，并保證接口的數(shù)據(jù)不會被篡改、注入攻擊和重復(fù)調(diào)用。14FCODEText（64）NAMEGEOZHQXText（255）

QX/T

342

QX-QWText（255）QX-JSText（255）QX-JSXTText（255）QX-FXText（255）QX-FSText（255）QX-FSLText（255）FCODEText（64）ZHBHText（5）LXText（255）ZHWZGEONAMEText（255）JCWZText（1024）JCNRText（255）FCODEText（64）LJJMText（64）FCODEText（64）LJJMText（64）DB63/T

1828—2020AA附錄 A（資料性附錄）數(shù)據(jù)屬性內(nèi)容構(gòu)成表A.1 災(zāi)害區(qū)域?qū)傩员肀鞟.2 監(jiān)測類屬性表表A.3 省、直轄市界類屬性信息表A.4 表A.5 氣象信息屬性表15QX-YLText（255）QX-SDText（255）DB63/T

1828—2020表

表

A.5

（續(xù)）DB63/T

1828—2020BB附 錄 B（資料性附錄）XML

文檔實(shí)例B.1 引言本附錄提供了包含GMDS服務(wù)元數(shù)據(jù)信息的XML文檔實(shí)例。B.2 MetadataInfo響應(yīng)實(shí)例以下是一個完整的具有REST風(fēng)格的GMDS服務(wù)元數(shù)據(jù)文檔實(shí)例。<?xml

version="1.0"

<MetadataInfo

version="1.0.0">

Data

Services</Title></ServiceIdentification><ServiceProvider><ProviderName>青海省自然資源廳</ProviderName><ServiceContact><ContactInfo><EMail>*****@**.**</EMail>

****-*******</Facsimile></Phone><Address><CompanyAddress>城西區(qū)黃河路15號測繪大廈<CompanyAddress><City>西寧</City><AdministrativeArea>青海</AdministrativeArea><Country>中國</Country><PostalCode>810001</PostalCode></Address></ContactInfo></ServiceContact></ServiceProvider><Operations><Operation

<HTTP>17DB63/T

1828—2020<GetURL>

name="GetEncoding">https://GMDS

Server/GMDS/getMetadataInfo/1.0.0/MetadataInfo.xml</GetURL></TransportProtocol></Operation><Operation

<HTTP><GetURL>

name="GetEncoding">https://GMDS

Server/GMDS/GetDataTile/1.0.0/</GetURL></TransportProtocol></Operation><Operation

name="getOtherDataInfo"><HTTP><GetURL>

name="GetEncoding">https://GMDS

Server/GMDS/GetOtherDataInfo/1.0.0/</GetURL></TransportProtocol></Operation></Operations><Contents><LayerID><Title>省級行政界線</Title><Identifier>ProvincialAdministrativeBoundary</Identifier><CoordinateBox>

-90</LowerCorner>18DB63/T

1828—2020

90</UpperCorner></CoordinateBox><CoordinateIdentifier>CGCS

2000</CoordinateIdentifier><Format>geojson</Format><ResourceURLformat="json"/></LayerID></Contents><ServiceMetadataURLxlink:href="https://GMDS

Server/GMDS/getMetadataInfo/1.0.0/MetadataInfo.xml"/></MetadataInfo>19DB63/T

1828—2020CC附 錄C（資