1、ICS35.240.70CCS A 7563青海省地方标准DB63/T 21232023自然资源统一确权登记数据共享接口规范（报批稿）2023-06-01 发布2023-08-01 实施青海省市场监督管理局发 布DB63/T 21232023I目次前言.II1 范围.12 规范性引用文件.13 术语和定义.14 缩略语.25 数据基本规定.25.1 数学基础.25.2 元数据.26 专题数据结构及内容.26.1 数据目录.26.2 属性内容.37 数据质量说明.38 数据构成.39 接口模型结构.49.1 模型资源内容.49.2 接口框架.410 接口实现模型.410.1 服务元数据.410.
2、2 数据块.510.3 附加要素.611 接口规则.711.1 专题数据服务接口分类.711.2 协议.711.3 操作请求方式.711.4 操作请求异常.811.5 返回数据.8附录 A（规范性）自然资源统一确权登记专题数据分类.10附录 B（资料性）数据属性内容构成.11附录 C（资料性）XML 文档实例.13C.1 引言.13C.2 MetadataInfo 响应实例.13附录 D（资料性）数据块例实.16D.1 引言.16D.2 数据块实例.16DB63/T 21232023II前言本文件按照GB/T 1.12020标准化工作导则第1部分：标准化文件的结构和起草规则的规定起草。本文件由
3、青海省自然资源厅提出并归口。本文件起草单位：青海省不动产登记事务中心、青海省地理信息和自然资源综合调查中心、青海省自然资源综合调查监测院、青海省地理空间信息技术与应用重点实验室。本文件主要起草人：祝茂良、晁剑、刘慧、丁毅、欧尔格力、王晓波、吴笑天、叶永年、米广玉、张辉、冯国杰、庄乾乐、陈生录、韩昆、宋海珍、马有录、苍健、霍俊领、吴元文、何生娟。本文件由青海省自然资源厅监督实施。DB63/T 212320231自然资源统一确权登记数据共享接口规范1范围本文件规定了专题数据的结构及内容、数据质量说明、数据构成、接口模型结构、接口实现模型、接口规则等内容。本文件适用于在空间信息化平台中交换确权登记数
4、据的整理、交换等作业处理，其他政务资源数据交换和共享平台也可参照使用。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T 2260中华人民共和国行政区划代码GB/T 10113分类与编码通用术语GB/T 10114 县级以下行政区划代码编制规则GB/T 13923 基础地理信息要素分类与代码GB/T 19710 地理信息元数据GB 21139基础地理信息标准数据基本规定GB/T 25597 地理信息 万维网服务接口GB/T 40525 地
5、理信息在线共享接口规范GB/T 40767 地理空间数据交换基本要求3术语和定义下列术语和定义适用于本文件。3.1自然资源天然存在、有使用价值、可提高人类当前和未来福利的自然环境因素的总和。3.2登记单元所有权主体清晰、自然资源种类明确、生态功能完整、集中连片和边界封闭的空间范围，简称登记单元。3.3接口描述实体行为的命名操作集。来源：GB/T25597-2010,4.53.4元数据DB63/T 212320232关于数据的数据。即数据的标识、覆盖范围、质量、空间和时间模式、空间参照系和分发等信息。来源：GB/T 19710-2005，4.53.5代码表示特定事物或概念的一个或一组字符。注：这
6、些字符可以是阿拉伯数字、拉丁字母或便于任何机器识别与处理的其他符号。来源：GB/T 10113-2003，2.2.53.6专题数据集中表现自然资源统一确权登记专题属性信息的空间数据。3.7数据块一组或几组按顺序连续排列在一起的记录，是主存储器与输入设备、输出设备或外存储器之间进行传输的数据单位。4缩略语下列缩略语适用于本文件。URNS：自然资源统一确权登记空间数据服务（Unified confirmation and registration of Rights for Natural resources Spatial data service）HTTPS：超文本传输安全协议（Hyper T
7、ext Transfer Protocol over SecureSocket Layer）REST：面向资源架构风格（Representational State Transfer）API：应用程序接口（Application Programming Interface）XML：可扩展标记语言（Xtensible Markup Language）JSON：JavaScript对象简谱(JavaScript Object Notation)WSDL：Web服务描述语言（Web Services Description Language）5数据基本规定5.1数学基础5.1.1坐标系统采用 200
8、0 国家大地坐标系（China Geodetic Coordinate System 2000，简称 CGCS2000）。5.1.2高程系采用 1985 国家高程基准（单位：米）。5.1.3投影方式、比例尺按照 GB 21139 执行。5.2元数据可共享和交换的各类空间数据的核心描述信息使用元数据方式进行表述，查询、检索和查看数据概况时使用元数据，元数据文件格式为XML格式。6专题数据结构及内容6.1数据目录自然资源统一确权登记专题数据分类见附录A中表A.1。DB63/T 2123202336.2属性内容6.2.1自然资源确权登记单元要素确权登记单元为面要素矢量数据形式展现，其属性信息按照附录
9、B中表B.1设计。6.2.2控制线要素控制线为线要素矢量数据，其属性信息按照附录B中表B.2设计。6.2.3省界省界类为线要素矢量数据，分类代码按照GB/T 2260执行，其属性信息按照附录B中表B.3设计。6.2.4州界州界类为线要素矢量数据，分类代码按照GB/T 2260执行，其属性信息按照附录B中表B.4设计。6.2.5县（市）、区界县（市）、区界类为线要素矢量数据，分类代码按照GB/T 10114执行，其属性信息按照附录B中表B.5设计。6.2.6定位基础定位基础类为点要素矢量数据，其属性信息按照附录B中表B.6设计。6.2.7遥感影像遥感影像属性信息按照附录B中表B.7设计。7数据质
10、量说明数据质量说明应包括数据情况说明、空间化精度、属性精度、时间精度、逻辑一致性、数据完整性以及表达的合理性。其中数据情况说明应包含数据获取来源、加工处理方法、使用范围等内容。8数据构成专题数据块基本构成分为3块信息单元：空间信息类、时间信息类、专题内容信息类。将以上区域单元定义为第1级数据块，每类区域单元视为一个对象，同一级别每个对象之间并列，这些对象可独立提供。根据第1级数据块的特点，可派生出子单元，视为第2级数据块。为保证数据模型的可扩展性，每一个第2级数据块也可派生多个子单元。具体数据构成见图1。DB63/T 212320234图1自然资源统一确权登记专题数据结构图9接口模型结构9.1
11、模型资源内容专题数据服务（URNS）可响应客户端面向资源的架构风格（REST）的请求使其接收3类资源。主要包括：服务元数据资源（MetadataInfo），描述指定服务器实现的数据资源能力和包含的信息。在面向过程架构风格下，对服务能力元数据资源获取操作（GetMetadataInfo）的响应服务器方必须实现。数据块资源(DataTile)，表示某一特定区域中一个或多个空间专题数据要素响应结果数据块。在面向过程架构风格下，对要素数据资源获取操作（GetDataTile）的响应服务器方必须实现。附加要素信息资源（OtherDataInfo）,描述某一特定区域不能以数据块形式提供的附加信息资源，对附
12、加要素信息资源获取操作(GetOtherDataInfo)的响应服务器方可选择实现。9.2接口框架服务接口抽象为2类，包括基础服务和数据服务。其中URNS基础服务接口为获取MetadataInfo的getMetadataInfo 操 作，URNS 数 据 服 务 接 口 为 获 取 DataTile、OtherDataInfo 的 getDataTile 和getOtherDataInfo操作。10接口实现模型10.1服务元数据10.1.1服务元数据文档MetadataInfo主要包括服务内容元数据和各数据块结构的元数据。其文档包含服务名称、服务机构说明、支持操作及其说明，可自定义扩展要素内容
13、。文档格式为XML格式，其组成结构包括但不限于附录C文档实例内容。10.1.2服务元数据文档说明MetadataInfo文档包括表1中所有的子集，具体内容说明如下：DB63/T 212320235表1MetadataInfo 说明名称定义数据类型与取值出现次数与用法versiongetMetadataInfo操作响应的标准版本字符串，非空取值为x.y.z的值列表如1.0.01(必选)WSDL对WSDL资源的引用URL类型0或1（可选）serviceMetadataURL对ServiceMetadata 资源的引用URL类型0或1在REST风格下是必选的serviceIdentification
14、关于该指定服务器的元数据0或1（可选）serviceProvider关于运作该服务器的机构的元数据0或1（可选）operationsMetadata关于该服务提供的操作的元数据0或3（可选）contents关于该服务器提供服务的数据的元数据0或1（可选）themes关于数据块专题层级的元数据0或1（可选）10.1.3getMetadataInfo 操作对getMetadataInfo请求的响应为一个包含关于服务器的服务元数据文档，包括关于服务提供信息、待请求的数据列表和细节信息。getMetadataInfo操作还应包含一个版本协商机制。10.2数据块10.2.1数据块资源URNS服务器用于提
15、供数据块服务。数据块资源应是一个包含自然资源统一确权登记空间数据内容的描述段，其数据描述结构具体见表2，由时空模块和扩展模块组成，每项数据内容都有相应标签进行标识。数据块格式为JSON格式，其实例见附录D数据块实例内容。表2数据块结构结构名称模块内容编码内容空间信息type:Feature,properties:,geometry:type:空间要素类型,coordinates:坐标值 时空模块时间信息type:Time,time:XXXXXXXXXXXXXXDB63/T 212320236表 2 数据块结构（续）结构名称模块内容编码内容扩展模块基础地理信息专题数据自然资源统一确权登记专题数据
16、基础地理空间数据其他信息type:Other,info:信息名称:信息内容 10.2.2数据块资源请求说明getDataTile操作中，客户端应使用预定义的格式请求某一块阵集中的特定数据块资源。该操作可允许多个数据层组合起来提供服务，应给这种数据层组合一个标识符并作为一个新的数据层添加到服务元数据文档中。getDataTile操作参数包括表3中所有的子集，可请求只包括部分这些子集的参数，具体参数要求见表3。表3getDataTile 操作请求参数名称定义数据类型与取值出现次数与用法service服务类型标识符字符串，非空，固定取值为URNS 1(必选)request操作名字符串，非空，固定取值
17、为GetDataTile 1(必选)version操作的标准版本字符串，非空，应包含1.0.01(必选)layers 图层列表获取标识符字符串，非空，固定取值为layers0或1(可选)layerid图层标识符字符串，非空，MetadataInfo文档中定义的标识符，包含表 1 中定义的要素层名0或1(可选)attributeName图层属性标识符字符串，非空，图层自定义值，包含附录A 表格中定义的字段命名0或1(可选)dataTileAttribute图层属性值字符串或数值，非空，attributeName中定义的值域或值列表中的一个值1(必选)attributeQueryString图层条
18、件查询标识符字符串，非空，固定取值为query0或1(可选)dataTileAttributeScope条件查询字符串字符串，非空，条件查询字符串，条件之间以&作为连接1(必选)10.2.3getDataTile 操作getDataTile操作分为图层列表请求与按属性内容查询请求2种操作模式。getDataTile操作应从以上2种操作模式中选择其中一种作为请求的内容。10.3附加要素10.3.1附加要素信息资源附加要素信息资源应是一个表述与自然资源统一确权登记空间数据信息相关的文档或图片资源。10.3.2附加要素信息资源请求说明客户端针对某一特定区域请求获取的附加信息应通过附加要素信息（Oth
19、erDataInfo）进行表达。DB63/T 212320237URNS服务器支持对某一特定区域非数据块形式的OtherDataInfo的查询请求。URNS服务器提供位于客户端请求中指定位置上或附近要素的信息，并由该服务器决定这些要素的具体形式。10.3.3getOtherDataInfo 操作OtherDataInfo由getOtherDataInfo操作请求响应。该操作只允许单个文件信息提供服务或接受请求。OtherDataInfo信息列表在MetadataInfo明确列出。getOtherDataInfo操作参数包括表4中所有的子集，具体参数要求见表4。表4getOtherDataInf
20、o 操作请求参数名称定义数据类型与取值出现次数与用法service服务类型标识符字符串，非空，固定取值为URNS 1(必选)request操作名字符串，非空，固定取值为GetOtherDataInfo1(必选)version操作的标准版本字符串，非空，应包含1.0.01(必选)infoList 附加要素列表获取标识符字符串，非空，固定取值为infolist0或1(可选)layerName附加要素标识符字符串，非空，附加要素自定义的标识符0或1(可选)otherDataInfoIdentifier 附加要素标识符字符串或数值，非空，layerName 中定义的值域或值列表中的一个值1(必选)11
21、接口规则11.1专题数据服务接口分类根据本文件对交换的数据进行整合，以数据资源和服务两种方式提供在线共享。针对现有各类信息化系统对以上URNS的调用，规定以XML和JSON方式提供信息服务。URNS服务器的API由一组分别指向服务元数据文档、各个数据块以及附加要素信息的规范URL组成,API以REST风格进行编码。服务元数据文档是唯一的入口，其他URL端点可通过分析服务元数据文档中每个数据块内各个内容模板来获得。11.2协议URNS服务器与客户端的文本传输协议使用HTTPs协议。11.3操作请求方式11.3.1getMetadataInfo 操作编码响应一个客户端针对URNS服务器getMet
22、adataInfo操作的请求，URNS服务器应发送该服务器能够提供数据服务的元数据信息资源的引用。网址模板中变量与值的排列顺序是固定的，应采用如下模板顺序：https:/URNS Server/URNS/getMetadataInfo/1.0.0/MetadataInfo.xml。11.3.2getDataTile 操作编码11.3.2.1getDataTile 请求概述响应一个客户端针对URNS服务器getDataTile操作的请求，URNS服务器应发送一个包含与某一符合查询条件区域相关的专题空间信息资源的引用。网址模板中变量与值的排列顺序分为图层列表请求与属性内容查询请求。DB63/T 2
23、1232023811.3.2.2图层列表请求编码模板https:/URNS Server/URNS/GetDataTile/1.0.0/layers。11.3.2.3属性内容查询请求编码模板按属性内容查询请求操作包括单属性查询和多属性条件查询。模板中“”符号中的参数按照表3的参数要求进行设置。具体如下：单属性查询模板：错误！超链接引用无效。tribute；多属性条件查询模板：https:/URNS Server/URNS/GetDataTile/1.0.0/query/dataTileAttributeScope。11.3.3getOtherDataInfo 操作编码11.3.3.1getOt
24、herDataInfo 请求概述响应一个客户端针对URNS服务器getOtherDataInfo操作的请求，URNS服务器应发送一个包含与某一符合查询条件的附加要素资源的引用。网址模板中变量与值的排列顺序分为文件列表请求与标识符查询请求。标识符查询请求模板中“”符号中的参数按照表5的参数要求进行设置。11.3.3.2文件列表请求编码模板https:/URNS Server/URNS/GetOtherDataInfo/1.0.0/infolist。11.3.3.3标识符查询请求编码模板https:/URNS Server/URNS/GetOtherDataInfo/1.0.0/otherData
25、InfoIdentifier。11.4操作请求异常当URNS服务器在执行getMetadataInfo、getDataTile、getOtherDataInfo操作出错时，应返回一个异常代码消息。可用的标准异常代码包括在表6中的列出的代码。当URNS服务器响应一个异常代码消息，该异常消息通过HTTP传输。URNS服务器根据表6给定的异常代码值与状态码对应关系设定相应的HTTP响应状态代码。表5操作异常代码及其含义异常代码值代码含义HTTP状态代码消息OperationNotSupported 请求的操作本服务器不支持501未实现MissingParameterValue操作请求不包含参数值，服
26、务器也没有为此参数申明默认值400不良请求InvalidParameterValue 操作请求包含无效参数值400不良请求DataTileOutOfRange条件查询取值不在值域范围内400不良请求NoApplicableCode该服务或服务器没有为此异常定义异常代码500服务器内部错误11.5返回数据API接口成功接到请求，则返回HTTP状态代码为200。URNS数据的返回格式采用固定的数据格式封装。其中：DB63/T 212320239接口返回模板如下：status:0,data:|,msg:模板说明如下：status：接口的执行的状态，=0表示成功；0 表示有异常=。Data：接口的主数
27、据，返回内容按照表8表述的方式组织。Msg：错误信息，当status!=0 都应该有错误信息。DB63/T 2123202310AA附录A（规范性）自然资源统一确权登记专题数据分类表A.1给出了自然资源统一确权登记专题数据分类。表A.1 数据分类要素类要素细类要素类名称自然保护地登记单元DJDY-ZRBHD水流登记单元DJDY-SHUILIU 草原登记单元DJDY-CAOYUAN 森林登记单元DJDY-SENLIN湿地登记单元DJDY-SHIDI荒地登记单元DJDY-HUANGDI确权登记单元探明储量矿产登记单元DJDY-KUANGCHAN生态保护红线STBHHX国土空间规划分区GTKJGHF
28、Q特殊保护TSBH控制线其他公共管制区QTGGGZQ行政区XZQ行政区界线XZQJX行政区域界线行政区注记XZQZJ测量控制点CLKZD定位基础测量控制点注记CLKZDZJ数字航空正射影像SZHKZSYXT遥感影像数字航天正射影像SZHTZSYXTBBDB63/T 2123202311附录B（资料性）数据属性内容构成表B.1给出了自然资源统一确权登记单元要素属性内容。表B.1 登记单元要素属性表字段名称字段代码字段类型字段长度（字节）备注标识码BSMText18要素代码YSDMText10自然资源登记单元号ZRZYDJDYHText15登记单元类型代码DJDYLXDMText50名称MCTex
29、t255坐落ZLText255单元四至-东DYSZDText255单元四至-南DYSZNText255单元四至-西DYSZXText255单元四至-北DYSZBText255登记单元面积DJDYMJFloat15单位：平方米表B.2给出了控制线属性内容。表B.2 控制线属性表字段名称字段代码字段类型字段长度（字节）备注控制线名称KZXMCText200控制线类型KZXLXText200表B.3给出了省界类属性内容。表B.3 省界类属性表字段名称字段代码字段类型字段长度（字节）备注分类代码FLDMText64邻接界名LJJMText64表B.4给出了州界类属性内容。表B.4 州界类属性表字段名称
30、字段代码字段类型字段长度（字节）备注分类代码FLDMText64邻接界名LJJMText64DB63/T 2123202312表B.5给出了县（市）、区界类属性内容。表B.5 县（市）、区界类属性表字段名称字段代码字段类型字段长度（字节）备注分类代码FLDMText64邻接界名LJJMText64表B.6给出了定位基础信息属性内容。表B.6 定位基础信息属性表字段名称字段代码字段类型字段长度（字节）备注测量控制点名称CLKZDMCText255测量控制点注记CLKZDZJText1024测量控制点地址描述或坐标信息表B.7给出了遥感影像属性内容。表B.7 遥感影像属性表字段名称字段代码字段类型
31、字段长度（字节）备注标识码BSMText18要素代码YSDMText10影像分辨率YXFBLText8影像精度YXJDText8遥感影像中误差传感器名称CGQMCText60中央子午线经度ZYZWXJDFloat8拍摄时间PSSJDate8DB63/T 2123202313CC附录C（资料性）XML 文档实例C.1引言本附录提供了包含URNS服务元数据信息的XML文档实例。C.2MetadataInfo 响应实例以下是一个完整的具有REST风格的URNS服务元数据文档实例。Disaster Spatial Data ServicesURNS1.0.0none青海省自然资源厅*.*+86*-*城
32、西区*路*号*西宁青海中国810001DB63/T 2123202314 https:/URNS Server/URNS/getMetadataInfo/1.0.0/MetadataInfo.xml https:/URNS Server/URNS/GetDataTile/1.0.0/https:/URNS Server/URNS/GetOtherDataInfo/1.0.0/省级行政界线ProvincialAdministrativeBoundary-180-90180 90DB63/T 2123202315CGCS 2000geojsonDB63/T 2123202316附录D（资料性）数据
33、块例实DD.1引言本附录提供了URNS服务器提供的数据块的JSON实例。D.2数据块实例以下是一个完整的JSON格式的URNS服务数据块实例。type:Feature,properties:FCODE:630123 ,geometry:type:Line,coordinates:100.90*,36.79*,100.97*,36.82*,101.02*,36.79*,101.18*,36.87*,101.41*,36.75*,101.43*,36.66*,101.35*,36.40*,101.23*,36.32*,101.08*,36.48*,101.01*,36.54*,100.95*,36.68*type:Time,time:XXXXXXXXXXXXXX type:Other,info:Name:湟源县 D
