DB63T 2123-2023 自然资源统一确权登记 数据共享接口规范

ICS35.240.7063CCSA7563青 海 省 地 方 标 准DB63/T2123—2023自然资源统一确权登记数据共享接口规范（报批稿）2023-06-01发布 2023-08-01实施青海省场监理局 发布DB63/T2123DB63/T2123—2023目 次前言 II范围 1规性用件 1术和义 1缩语 2数基规定 2学础 2数据 2专数结及容 2据录 2性容 3数质说明 3数构成 3接模结构 4型源容 4口架 4口现型 4服元据 4数块 5附要素 6口则 7专数服接类 7协议 7操请方式 7操请异常 8返数据 8附录A（范）自源统确登专数分类 10附录B（料）数性内构成 11附录C（料）XML档实例 13言 13MetadataInfo响例 13附录D（料）数例实 16言 16据实例 16I前 言本文按照GB/T1.1—2020《标化作导则 第部分标准文的结和起规则的起草。本文件由青海省自然资源厅提出并归口。本文件主要起草人：祝茂良、晁剑、刘慧、丁毅、欧尔格力、王晓波、吴笑天、叶永年、米广玉、张辉、冯国杰、庄乾乐、陈生录、韩昆、宋海珍、马有录、苍健、霍俊领、吴元文、何生娟。本文件由青海省自然资源厅监督实施。II自然资源统一确权登记数据共享接口规范范围本文件规定了专题数据的结构及内容、数据质量说明、数据构成、接口模型结构、接口实现模型、接口规则等内容。（GB/T2260中华人民共和国行政区划代码GB/T10113分类与编码通用术语GB/T10114县级以下行政区划代码编制规则GB/T13923基础地理信息要素分类与代码GB/T19710地理信息元数据GB21139 GB/T25597地理信息万维网服务接口GB/T40525地理信息在线共享接口规范GB/T40767地理空间数据交换基本要求下列术语和定义适用于本文件。3.1自然资源天然存在、有使用价值、可提高人类当前和未来福利的自然环境因素的总和。3.2登记单元所有权主体清晰、自然资源种类明确、生态功能完整、集中连片和边界封闭的空间范围，简称登记单元。3.3接口描述实体行为的命名操作集。[来源：GB/T25597-2010,4.5]3.4元数据1：GB/T19710-2005，4.5]3.5代码表示特定事物或概念的一个或一组字符。注：这些字符可以是阿拉伯数字、拉丁字母或便于任何机器识别与处理的其他符号。[来源：GB/T10113-2003，2.2.5]3.6专题数据集中表现自然资源统一确权登记专题属性信息的空间数据。3.7数据块一组或几组按顺序连续排列在一起的记录，是主存储器与输入设备、输出设备或外存储器之间进行传输的数据单位。缩略语下列缩略语适用于本文件。URNS（UnifiedconfirmationandregistrationofRightsforNaturalresourcesSpatialdataservice）HTTPS：超文本传输安全协议（HyperTextTransferProtocoloverSecureSocketLayer）REST：面向资源架构风格（RepresentationalStateTransfer）API：应用程序接口（ApplicationProgrammingInterface）XML：可扩展标记语言（XtensibleMarkupLanguage）JSON：JavaScript对象简谱(JavaScriptObjectNotation)WSDL：Web服务描述语言（WebServicesDescriptionLanguage）000（hinaGedetcCoordnateSytem00GCS000。1985）。GB21139元数据XML自然资源统一确权登记专题数据分类见附录A中表A.1。2确权登记单元为面要素矢量数据形式展现，其属性信息按照附录B中表B.1设计。控制线为线要素矢量数据，其属性信息按照附录B中表B.2设计。省界省界类为线要素矢量数据，分类代码按照GB/T2260执行，其属性信息按照附录B中表B.3设计。州界州界类为线要素矢量数据，分类代码按照GB/T2260执行，其属性信息按照附录B中表B.4设计。县（）县（市）、区界类为线要素矢量数据，分类代码按照GB/T10114执行，其属性信息按照附录B中表B.5设计。定位基础类为点要素矢量数据，其属性信息按照附录B中表B.6设计。遥感影像属性信息按照附录B中表B.7设计。1221。3图1 自然源一权记题数结图专题数据服务（URNS）可响应客户端面向资源的架构风格（REST）的请求使其接收3类资源。主要包括：——服务元数据资源（MetadataInfo），描述指定服务器实现的数据资源能力和包含的信息。在面向过程架构风格下，对服务能力元数据资源获取操作（GetMetadataInfo）的响应服务器方必须实现。(DataTile——附加要素信息资源（OtherDataInfo）,描述某一特定区域不能以数据块形式提供的附加信息资源，对附加要素信息资源获取操作(GetOtherDataInfo)的响应服务器方可选择实现。服务接口抽象为2类，包括基础服务和数据服务。其中URNS基础服务接口为获取MetadataInfo的getMetadataInfoURNS数据服务接口为获取DataTileOtherDataInfogetDataTileMetadataInfoXMLMetadataInfo文档包括表1中所有的子集，具体内容说明如下：4表1 MetadataInfo说明名称定义数据类型与取值出现次数与用法versiongetMetadataInfo操作响应的标准版本字符串，非空取值为x.y.z的值列表如1.0.01(必选)WSDL对WSDL资源的引用URL类型0或1（可选）serviceMetadataURL对ServiceMetadata资源的引用URL类型0或1在REST风格下是必选的serviceIdentification关于该指定服务器的元数据0或1（可选）serviceProvider关于运作该服务器的机构的元数据0或1（可选）operationsMetadata关于该服务提供的操作的元数据0或3（可选）contents关于该服务器提供服务的数据的元数据0或1（可选）themes关于数据块专题层级的元数据0或1（可选）getMetadataInfo对getMetadataInfogetMetadataInfo数据块URNS2JSON表2 数据结构结构名称模块内容编码内容空间信息{"type":"Feature","properties":{},"geometry":{"type":"空间要素类型","coordinates":[坐标值]}}时空模块{时间信息"type":"Time","time":{XXXXXXXXXXXXXX}}5表2 数块构续）结构名称模块内容编码内容基础地理信息专题数据{"type":"Other","info":{"信息名称":"信息内容"}}扩展模块自然资源统一确权登记专题数据基础地理空间数据其他信息getDataTilegetDataTile。表3 getDataTile作求数名称定义数据类型与取值出现次数与用法service服务类型标识符字符串，非空，固定取值为"URNS"1(必选)request操作名字符串，非空，固定取值为"GetDataTile"1(必选)version操作的标准版本字符串，非空，应包含"1.0.0"1(必选)layers图层列表获取标识符字符串，非空，固定取值为"layers"0或1(可选)layerid图层标识符字符串，非空，MetadataInfo文档中定义的标识符，包含表1中定义的要素层名0或1(可选)attributeName图层属性标识符字符串，非空，图层自定义值，包含附录A表格中定义的字段命名0或1(可选)dataTileAttribute图层属性值attributeName值域或值列表中的一个值1(必选)attributeQueryString图层条件查询标识符字符串，非空，固定取值为"query"0或1(可选)dataTileAttributeScope条件查询字符串字符串，非空，条件查询字符串，条件之间以"&"作为连接1(必选)getDataTilegetDataTile操作分为图层列表请求与按属性内容查询请求2种操作模式。getDataTile操作应从以上2种操作模式中选择其中一种作为请求的内容。附加要素信息资源应是一个表述与自然资源统一确权登记空间数据信息相关的文档或图片资源。客户端针对某一特定区域请求获取的附加信息应通过附加要素信息（OtherDataInfo）进行表达。6URNS服务器支持对某一特定区域非数据块形式的OtherDataInfo的查询请求。URNS服务器提供位于客户端请求中指定位置上或附近要素的信息，并由该服务器决定这些要素的具体形式。getOtherDataInfogetOtherDataInfogetOtherDataInfo。表4 getOtherDataInfo操求参数名称定义数据类型与取值出现次数与用法service服务类型标识符字符串，非空，固定取值为"URNS"1(必选)request操作名字符串，非空，固定取值为"GetOtherDataInfo"1(必选)version操作的标准版本字符串，非空，应包含"1.0.0"1(必选)infoList附加要素列表获取标识符字符串，非空，固定取值为"infolist"0或1(可选)layerName附加要素标识符字符串，非空，附加要素自定义的标识符0或1(可选)otherDataInfoIdentifier附加要素标识符字符串或数值，非空，layerName值列表中的一个值1(必选)XML和JSONURNSAPIURL组成,API以RESTURL协议URNS服务器与客户端的文本传输协议使用HTTPs协议。getMetadataInfoURNS服务器getMetadataInfo，URNShttps://URNSServer/URNS/getMetadataInfo/1.0.0/MetadataInfo.xml。getDataTilegetDataTileURNS服务器getDataTileURNS7https://URNSServer/URNS/GetDataTile/1.0.0/layers。按属性内容查询请求操作包括单属性查询和多属性条件查询。模板中“{}”符号中的参数按照表3的参数要求进行设置。具体如下：——单属性查询模板：错误！超链接引用无效。tribute}；——多属性条件查询模板：https://URNSServer/URNS/GetDataTile/1.0.0/query/{dataTileAttributeScope}。getOtherDataInfogetOtherDataInfoURNgettheDatInfUNS5https://URNSServer/URNS/GetOtherDataInfo/1.0.0/infolist。https://URNSServer/URNS/GetOtherDataInfo/1.0.0/{otherDataInfoIdentifier}。当URNSgetMetadataInfogetDataTilegetOtherDataInfo6URNSHTTPURNS6HTTP响表5 操作常码其义异常代码值代码含义HTTP状态代码消息OperationNotSupported请求的操作本服务器不支持501未实现MissingParameterValue操作请求不包含参数值，服务器也没有为此参数申明默认值400不良请求InvalidParameterValue操作请求包含无效参数值400不良请求DataTileOutOfRange条件查询取值不在值域范围内400不良请求NoApplicableCode该服务或服务器没有为此异常定义异常代码500服务器内部错误APIHTTP200URNS8——接口返回模板如下：{status:0,data:{}||[],msg:’’}——模板说明如下：status0；<0DataMsgstatus!=09附录A（规范性）自然资源统一确权登记专题数据分类表A.1给出了自然资源统一确权登记专题数据分类。表A.1数据分类要素类要素细类要素类名称确权登记单元自然保护地登记单元DJDY-ZRBHD水流登记单元DJDY-SHUILIU草原登记单元DJDY-CAOYUAN森林登记单元DJDY-SENLIN湿地登记单元DJDY-SHIDI荒地登记单元DJDY-HUANGDI探明储量矿产登记单元DJDY-KUANGCHAN控制线生态保护红线STBHHX国土空间规划分区GTKJGHFQ特殊保护TSBH其他公共管制区QTGGGZQ行政区域界线行政区XZQ行政区界线XZQJX行政区注记XZQZJ定位基础测量控制点CLKZD测量控制点注记CLKZDZJ遥感影像数字航空正射影像SZHKZSYXT数字航天正射影像SZHTZSYXT10附录B（）表B.1登记单元要素属性表字段名称字段代码字段类型字段长度（字节）备注标识码BSMText18要素代码YSDMText10自然资源登记单元号ZRZYDJDYHText15登记单元类型代码DJDYLXDMText50名称MCText255坐落ZLText255单元四至-东DYSZDText255单元四至-南DYSZNText255单元四至-西DYSZXText255单元四至-北DYSZBText255登记单元面积DJDYMJFloat15单位：平方米表B.2给出了控制线属性内容。表B.2控制线属性表字段名称字段代码字段类型字段长度（字节）备注控制线名称KZXMCText200控制线类型KZXLXText200表B.3给出了省界类属性内容。表B.3省界类属性表字段名称字段代码字段类型字段长度（字节）备注分类代码FLDMText64邻接界名LJJMText64表B.4给出了州界类属性内容。表B.4州界类属性表字段名称字段代码字段类型字段长度（字节）备注分类代码FLDMText64邻接界名LJJMText6411表B.5给出了县（市）、区界类属性内容。表B.5（字段名称字段代码字段类型字段长度（字节）备注分类代码FLDMText64邻接界名LJJMText64表B.6给出了定位基础信息属性内容。表B.6定位基础信息属性表字段名称字段代码字段类型字段长度（字节）备注测量控制点名称CLKZDMCText255测量控制点注记CLKZDZJText1024测量控制点地址描述或坐标信息表B.7给出了遥感影像属性内容。表B.7遥感影像属性表字段名称字段代码字段类型字段长度（字节）备注标识码BSMText18要素代码YSDMText10影像分辨率YXFBLText8影像精度YXJDText8遥感影像中误差传感器名称CGQMCText60中央子午线经度ZYZWXJDFloat8拍摄时间PSSJDate812附录C（资料性）XML文档实例引言本附录提供了包含URNS服务元数据信息的XML文档实例。MetadataInfo以下是一个完整的具有REST风格的URNS服务元数据文档实例。<?xmlversion="1.0"encoding="UTF-8"?><MetadataInfoversion="1.0.0"><ServiceIdentification><Title>DisasterSpatialDataServices</Title><ServiceType>URNS</ServiceType><ServiceTypeVersion>1.0.0</ServiceTypeVersion><AccessConstraints>none</AccessConstraints></ServiceIdentification><ServiceProvider><ProviderName>青海省自然资源厅</ProviderName><ServiceContact><ContactInfo><Phone><EMail>*****@**.**</EMail><Facsimile>+86****-*******</Facsimile></Phone><Address><CompanyAddress>城西区**路**号****<CompanyAddress><City>西宁</City><AdministrativeArea>青海</AdministrativeArea><Country>中国</Country><PostalCode>810001</PostalCode></Address></ContactInfo></ServiceContact></ServiceProvider><Operations><Operationname="GetMetadataInfo"><TransportProtocol><HTTP><GetURL><Constraintname="GetEncoding">13<UrlValue></UrlValue></Constraint></GetURL></HTTP>

https://URNSServer/URNS/getMetadataInfo/1.0.0/MetadataInfo.xml</TransportProtocol></Operation><Operationname="getDataTile"><TransportProtocol><HTTP><GetURL><Constraintname="GetEncoding"><UrlValue>https://URNSServer/URNS/GetDataTile/1.0.0/</UrlValue></Constraint></GetURL></HTTP></TransportProtocol></Operation><Operationname="getOtherDataInfo"><TransportProtocol><HTTP><GetURL><Constraintname="GetEncoding"><UrlValue>https://URNSServer/URNS/GetOtherDataInfo/1.0.0/</UrlValue></Constraint></GetURL></HTTP></TransportProtocol></Operation></Operations