DB41-T 2788-2024 国土空间基础信息平台数据服务规范

国土空间基础信息平台数据服务规范2024-12-30发布2025-03-29实施I前言 1范围 12规范性引用文件 13术语和定义 14缩略语 25基本要求 26服务数据内容与交换 37数据服务类型和要求 38服务元数据 49服务安全 6 7 8 9 25附录H(规范性)数据目录服务接口 31参考文献 本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由河南省自然资源厅提出。本文件由河南省自然资源标准化技术委员会(HN/TC25)归口。本文件起草单位：河南省地理信息院、河南省测绘院、河南省地图院、河南省遥感院、河南省自然资源综合保障中心。本文件主要起草人：曹宏文、刘敏、王石岩、宋碧波、金子鑫、翟娅娟、付治河、禄二峰、孟洁、杨进、尚永福、印青、郭秀丽、毛航、朱琳。1国土空间基础信息平台数据服务规范本文件规定了国土空间基础信息平台数据服务的基本要求、服务数据内容与交换、数据服务类型和要求、服务元数据及服务安全。本文件适用于国土空间基础信息平台的数据服务。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本(包括所有的修改单)适用于本GB/T22239—2019信息安全技术网络安全等级保护基本要求GB/T25597—2010地理信息万维网地图服务接口GB/T30169—2013地理信息基于网络的要素服务GB/T35273—2020信息安全技术个人信息安全规范GB/T39477—2020信息安全技术政务信息共享数据安全技术要求GB/T40525—2021地理信息在线共享接口规范GB/T41479—2022信息安全技术网络数据处理安全要求CH/T9040—2023空间三维模型瓦片数据格式DB41/T2330—2022国土空间基础信息平台数据建库规范3术语和定义下列术语和定义适用于本文件。描述实体行为的命名操作集。[来源：GB/T25597—2010,4.5]请求通过客户端发出的操作的要求。[来源：GB/T25597—2010,4.10]由服务器返回给客户端的操作结果。[来源：GB/T25597—2010,4.11]服务2实体通过接口提供的功能性的独特角色。服务元数据描述服务器上的可用的操作和地理信息的元数据。下列缩略语适用于本文件。BOM:字节顺序标记(ByteOrderMark)GeoJSON:基于JavaScript对象表示法的地理空间信息数据交换格式(GeographicJavaScriptHTTP:超文本传输协议(HyperTextTransferProtocol)HTTPS:超文本传输安全协议(HypertextTransferProtocolSecure)JSON:JavaScript对象表示法(JavaScriptObjectNotation)MIME:多用途因特网邮件扩充协议(MultipurposeInternetMailExtensions)OGC:开放地理空间信息联盟(OpenGeospatialConsortium)REST:表述性状态传递(RepresentationalStateTransfer)URI:统一资源标识符(UniformResourceIdentifier)URL:统一资源定位符(UniformResourceLocator)UTF-8:8位元通用字符集(UnicodeTransformationFormat8bit)WFS:网络要素服务(WebFeatureService)WMS:网络地图服务(WebMapService)5基本要求5.1数学基础5.1.1空间参考系坐标系采用2000国家大地坐标系，高程基准采用1985国家高程基准。5.1.2时间参考系日期采用公历纪元，时间采用北京时间。5.2数据质量应符合DB41/T2330—2022中对数据质量的要求。本文件中涉及的JSON格式存储应符合以下要求：a)使用不包含BOM的UTF-8编码；b)JSON对象中名称唯一。35.4接口要求数据服务接口应符合以下要求：a)接口设计遵循规范性、安全性、开放性、灵活性和松耦合性原则；b)遵循HTTP或HTTPS协议标准；c)通过GET或POST方法获取数据资源；d)接收到有效请求时，按照接口说明作出准确应答；接收到无效请求时，须发送服务异常描述信息。具体要求符合附录A规定。应答对象伴随相应的MIME类型，符合附录B规定。5.5服务职责5.5.1数据发布单位，负责本单位数据资源的规划、编目、发布及更新，应保证所提供数据的正确性、完整性等，符合数据质量要求。5.5.2平台管理单位，指省、市、县(区)自然资源部门，负责维护本级数据服务目录，按要求审核、管理数据资源，应保障基于平台的各项数据服务正常运行，满足应用需要。5.5.3平台用户，负责根据应用需求提出数据使用申请，并在授权范围内规范调用数据服务。6服务数据内容与交换6.1数据内容包括国土空间现状数据、规划管控数据、业务管理数据、社会经济数据四类数据。6.2服务交换6.2.1数据发布数据发布单位登录平台，按照服务注册要求填报信息。平台管理单位对注册完成的服务进行审核，审核通过后发布服务接口，并实现代理运行。6.2.2接口申请平台用户通过数据目录、分类检索和接口搜索等功能，查找获得服务接口注册信息。平台用户对资源进行申请，填写申请部门、申请时间、截止时间、调用频率、用途说明等相关信息。6.2.3接口授权平台管理单位按照审批流程对接口申请进行审核并授权。6.2.4接口调用平台用户对授权后的服务接口进行调用。7数据服务类型和要求7.1要素服务7.1.1网络要素服务(WFS)4按照GB/T30169—2013规定执行。根据功能提供数据服务的图层元数据访问接口和数据查询接口。REST数据服务相关接口应符合附录C的规定。7.2属性表服务根据功能提供属性表服务的元数据访问接口和属性查询接口。属性表服务相关接口应符合附录D的规定。7.3文件服务根据功能提供文件服务的元数据访问接口和文件下载接口。文件服务相关接口应符合附录E的规定。7.4地图服务7.4.1网络地图服务(WMS)按照GB/T25597—2010规定执行。7.4.2网络地图瓦片服务(WMTS)按照GB/T40525—2021规定执行。7.4.3REST地图服务根据功能提供地图服务的元数据访问接口、地图瓦片接口和地图查询接口。REST地图服务相关接口应符合附录F的规定。7.5三维数据服务7.5.1三维瓦片数据服务(3DTiles)参照OGC22—025r4规定执行。7.5.2REST三维数据服务根据功能提供三维数据服务的元数据访问接口、三维图层元数据接口、三维图层配置文件接口和三维瓦片接口。REST三维数据服务相关接口应符合附录G的规定。7.6数据目录服务根据功能提供数据目录服务接口。数据目录服务接口应符合附录H的规定。8服务元数据要素服务、地图服务、三维数据服务等地理空间类数据服务的元数据应包含但不限于以下信息，具体见表1。5类别说明是是是是服务接口的访问地址(URL)图层名称是图层简介是行政区划是是关键词否服务的关键词是是地理空间否说明数据服务覆盖的空间范围坐标系是西南角点经度是西南角点纬度是东北角点经度是东北角点纬度是中心点经度是中心点纬度是时间信息注册时间是服务发布时间数据时间是数据生产时间更新时间否数据更新时间更新周期否是是是管理单位具体联系人姓名否否电子邮箱否管理单位联系人电子邮箱运维信息运行维护信息是务软件、是否具备不间断电源等信息69服务安全服务安全应符合GB/T22239—2019、GB/T35273—2020、GB/T39477—2020、GB/T41479—2022等相关要求。7(规范性)状态码说明被请求的资源有可供选择的回馈信息表示被请求的资源有一系列可供选择的回馈的地址进行重定向表示客户端响应没有被修改，因此客户端可以继续表示请求需要用户认证信息。客户端可以使用合适的Autho表示未经授权的请求，客户端没有内容的访问权限。户端的身份为服务器所知数据资源不支持该操作表示服务器端发生非预期情况，如服务器代码执行网关或者代理服务器从上游表示作为网关或者代理工作的服务器尝试执行请求应中将包含Retry-After头用以标明网关或者代理服务器未能及时从上游服务器收到响应表示作为网关或者代理工作的服务器尝试执行请求8(规范性)MIME类型与服务请求返回格式对照表MIME类型与服务请求返回格式对应关系按表B.1的规定。表B.1MIME类型与服务请求返回格式对照表B3DM/I3DM/PNTS/VCTR/CMPT/GLTF/SLPK/M3D/BIN/GLB/9(规范性)描述项说明图层元数据访问接口获取REST数据服务元数据信息接口调用示例/{datasourcename}/datasets/{dataset响应结果参数说明见表C.2。说明数据集名称，数据集的唯一标识，不区分大小写数据集的描述信息对应格网或影像的地理范围说明表名是否使用文件形式的缓存；仅对数据库型数按像素分块存储，每一块的大小；仅对影像数请求格式说明参见表C.3。说明数据查询接口接口调用示例http://{ip}:(port}/iserver/services/data-{workspacename}/rest/data/feC.2.3.1数据查询接口URI中请求参数说明见表C.4。说明否true表示直接返回查询结果，即元素类型为Feature的数组；false表示返回创建的featureResult资源的URI。否否查询结果的最大索引号。如果该值大于查询结果的最大索引号，则以查询结果的最大索引号为终止索引号否是否仅返回要素的数据集信息。默认为false否是否仅返回要素信息。默认为false否是否仅返回查询结果的要素数量。默认为falseC.2.3.2数据查询接口请求体中参数说明见表C.5。说明是数据查询的模式。包括ID、SQL、BOUNDS、BOUNDS_ATTRIBUTEFILTER、BUFFER、BUFFER_ATTRIBUTEFILTER、SPATIAL、SPA是否要获取的资源的ID数组。当getFeatureMod否范围查询时需要设置矩形坐标范围。当getFeaDS、BOUNDS_ATTRIBUTEFILTER时，否几何对象。当getFealureMode为BUFFER、BUFFER_ATTRIBUTEFILTER、SPATIAL、SPATIAL_ATTRIBUTEFILTER否缓冲区半径，参数单位和数据集的坐标单位一致eMode为BUFFER、BUFFER_ATTRIBUTE否属性查询过滤器。当getFeatureMode为BUFFER_ATTER、SPATIAL_ATTRIBUTEFILTER、BOUNDS_ATTRIBUTEFIL参数必选否空间查询模式。当getFeatureMode为SPATIAL、SPATIAL_ATTRI否SQL查询时用于设置服务端返回查询结果1000。当该值大丁fromIndex与LoIndex区间内查询结果的个数，则返回索引区间内所有结果；当该值小于等于froex区间内查询结果的个数，则返回索引区间内从fromIndex起，否查询参数。当getFeatureMode否动态投影的目标坐标系。当该参数不同于数表C.5数据查询接口请求体参数说明(续)说明否动态投影的目标坐标系对应的EPSGCode。使用时需在请求URI中添加returnContent参数，并设值为true。targetEpsgCode和否是否返回空间几何对象信息，默认为true。当getFeatureMode不为ID且URI参数returnContent为C.2.4.1默认响应结果参数说明见表C.6。说明数据查询是否成功创建的featureResult资源的URIC.2.4.2如果URI参数returnContent为true,则响应结果参数说明见表C.7。说明返回的数据集信息C.2.4.3Feature结构说明见表C.8。说明要素对应的几何对象。当hasGeometry为false时，返回的geometry值为null(规范性)属性表服务接口D.1元数据访问接口D.1.1功能说明用于获取属性表服务的描述信息。D.1.2请求格式请求格式说明参见表D.1。表D.1元数据访问接口请求格式说明描述项说明属性表服务的元数据访问接口获取属性表服务的元数据信息接口调用示例D.1.3请求参数URI中请求参数说明见表D.2。表D.2元数据访问接口请求参数说明说明否否D.1.4响应结果D.1.4.1响应结果参数说明见表D.3。表D.3元数据访问接口响应结果说明说明失败时的消息目录列表信息，见表D.4DB41/T2788—2024D.1.4.2DCDatasetInfo对象结构说明见表D.4。说明数据集的类型数据集的别名属性表的表名有效的开始时间有效的结束时间描述项说明属性查询接口接口调用示例http://{ip}:{port}/dfc/services/sgssfs/{datasetid}.json?request=get请求体中请求参数说明见表D.6。表D.6属性表查询接口请求体参数说明说明否否否否否D.2.4响应结果响应结果参数说明见表D.7。表D.7属性表查询接口响应结果参数说明说明数据类型异常信息(规范性)描述项说明文件服务的元数据访问接口获取文件服务的元数据信息接口调用示例http://{ip}:{port}/archive/services/archive/manage/publish/{E.1.4.1响应结果参数说明见表E.2。说明失败时的消息目录列表信息，见表E.3E.1.4.2ArchiveInfo对象结构说明见表E.3。说明数据原始类型文件的后缀名文件大小描述信息创建时间文件的更新时间目录类型E.2.1功能说明说明文件下载接口接口调用示例http://{ip}:{port}/archive/services/archive/manage/downl由文件类型确定E.2.3请求参数无。E.2.4响应结果响应结果为文件流。(规范性)说明REST地图服务的元数据访问接口获取REST地图服务的元数据信息接口调用示例http://{ip}:{port}/iserver/services/map-{workspacename}/rest/maps/{mapname}.jF.1.3请求参数响应结果参数说明见表F.2。说明当前地图的名称地图显示的中心点地图的最大显示比例尺。该值为0时，表示没有比例尺显示限制地图的最小显示比例尺。该值为0时，表示没有比例尺显示限制地图的全幅地理范围地图窗口显示区域的范围DB41/T2788—2024说明用户显示视窗，即产生的图片的大小自定义的地图全幅显示范围自定义的地图全幅显示范围是否有效当前地图的旋转角度是否反走样地图当前地图的描述信息指定点状符号的角度是否固定文本角度是否固定文本朝向是否固定避免地图对象压盖显示的过滤选项，当overlapDis是否使用固定比例尺来显示地图自定义的地图全幅显示范围是否有效是否启用自动避让效果自定义参数F.2地图瓦片接口请求格式说明参见表F.3。描述项说明地图瓦片接口获取REST地图服务中的瓦片数据接口调用示例true&origin={"x":-180,"y":90}&overlapDisplayed=false&scal说明X是瓦片在地图中列号，从左向右递增。默认情况下，切片y是瓦片在地图中行号，从上向下递增。默认情况下，切片是地图的比例尺。如0.0001表示比例尺否瓦片的宽度，单位为像素，默认为256像素否瓦片的高度，单位为像素，默认为256像素否瓦片图片是否透明否定为其他值，则以指定值作为切片的起始参考点计算瓦片行列号否图层进行切片否是否重定向，HTTP传输中的一个概念。如果为true,则将请求重定向到图片的真实地址；如果为false,则响应体中是图片的字节流。默认为false,不进行重定向否说明否动态投影后的地图瓦片否true,则对scale、X、y三个参数中未指定的参数在各自否有缓存(同cache参数)否有缓存(同cacheEnabled参数)否地图显示裁剪的区域，是一个面对象。当clnabled为true时有效，即地图只显示该否否地图自定义边界，customEntireBoundsEna时有效否自定义地图边界是否有效否当前地图的旋转角度否是否反走样地图否否否指定点状符号的角度是否固定否否否否地图对象在同一范围内时，是否重叠显示，默认为f否避免地图对象压盖显示的过滤选项。当overlayed为false时有效，用来增强对地否否文本角度是否固定否文本朝向是否固定否栅格运算，仅支持请求栅格瓦片否否自定义参数响应结果为png格式的文件流。说明地图查询接口接口调用示例http://{ip}:{port}/iserver/services/map-{workspacename}/rest/maps/{mapnueryResults.json?returnContenF.3.3请求参数F.3.3.1地图查询接口URI中请求参数说明见表F.6。表F.6地图查询接口URI请求参数说明说明是组；false表示返回创建的featureResult资源的URI。默认F.3.3.2地图查询接口请求体中参数说明见表F.7。说明是否否queryMode为距离查询或空间查询象信息。geometry的坐标系与地图坐标系一致否queryMode为范围查询时的必选参表F.7地图查询接口请求体参数说明(续)说明否queryMode为空间查询时的必选参式，包括包含、交叉、分离、重合、相交、叠加、邻接、被F.3.3.3QueryParameterSet对象结构说明见表F.8。说明否queryMode为距离查询或最近地物查询时的必选参数。distance的单位与地图坐标单位相同是括ATTRIBUTE(属性)、ATTRIBUTEANDGEOM何实体)、FIELD(字段类型，只返回查询结果集中的字段信息，不返回空间对象和属性信息)、GEOMETRY(几何实体)是否否否查询每个要素期望的重采样后返回的二维坐标对的数量，否否自定义参数，供扩展使用F.3.3.4QueryParam对象结构说明见表F.9。表F.9QueryParam参数说明说明否是否否否否需返回的字段集(规范性)REST三维数据服务接口G.1元数据访问接口G.1.1功能说明用于获取REST三维数据服务的描述信息。G.1.2请求格式请求格式说明参见表G.1。表G.1元数据访问接口请求格式说明说明REST三维数据服务元数据访问接口获取REST三维数据服务的元数据信息接口调用示例http://{ip}:{port}/iserver/services/3D-{workspacename}/rest/realspace/sG.1.3请求参数G.1.4响应结果响应结果参数说明见表G.2。表G.2元数据访问接口响应结果参数说明说明当前三维场景的名称当前三维场景的场景相机，相当于视点场景相机的视角，单位为度，范围为0～90度当前三维场景的雾对象表G.2元数据访问接口响应结果参数说明(续)说明当前三维场景中雾的可见高度，即离地球表面的海拔距离当前三维场景的经纬网设置比例尺是否可见地形夸大的比例3D跟踪图层G.2三维图层元数据接口G.2.1功能说明用于获取三维数据服务中指定三维图层的描述信息。G.2.2请求格式请求格式说明参见表G.3。表G.3三维图层元数据接口请求格式说明描述项说明三维图层元数据接口获取三维场景中指定图层的元数据信息接口调用示例G.2.3请求参数URI中请求参数说明见表G.4。表G.4三维图层元数据接口请求参数说明说明否是否使用缓存，默认为trueG.2.4响应结果响应结果参数说明见表G.5。说明图层是否始终渲染图层范围图层的标题图层的描述信息图层是否可被编辑图层的类型缓存层号图层的名称，在地图中唯一标识此图层，区分大小写图层中的对象是否可以查询图层的渲染风格子图层信息图层是否可见用于获取三维数据服务中指定三维图层的空间位说明三维图层配置文件接口获取三维场景中指定图层的配置信息接口调用示例http://{ip}:{port}/iserver/services/3D-{workspacename}/rest/realspace/da描述项说明G.3.4.1响应结果参数说明见表G.7。说明LOD细化类型，包括Add、