DB42_T 1940.1-2022 湖北省市县级国土空间规划“一张图”实施监督信息系统技术规范 第1部分：接口要求.docx

《DB42_T 1940.1-2022 湖北省市县级国土空间规划“一张图”实施监督信息系统技术规范 第1部分：接口要求.docx》由会员分享，可在线阅读，更多相关《DB42_T 1940.1-2022 湖北省市县级国土空间规划“一张图”实施监督信息系统技术规范 第1部分：接口要求.docx（41页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、DB42/T1940.12022目次前言.III引言.V1范围.12规范性引用文件.13术语和定义.14缩略语.25接口分类.26数据服务接口定义.36.1接口描述.36.2空间数据基础要求.37功能服务接口定义.37.1接口描述.37.2编制项目填报接口.37.3编制成果审查接口.47.4规划“一张图”接口.67.5规划指标接口.10附录A（资料性）接口返回状态码代表的状态值.13附录B（资料性）功能服务接口示例.15参考文献.30IDB42/T1940.12022引言国土空间规划“一张图”实施监督信息系统是建立国土空间规划体系并监督实施的重要技术支撑，基于新技术、新手段，为国土空间规划编制

2、、审批、修改和实施监督全周期管理提供信息化技术支持，为打造可感知、能学习、善治理和自适应的智慧型规划奠定基础。DB42/T1940旨在规范湖北省市县级国土空间规划“一张图”实施监督信息系统服务建设，DB42/T1940由两个部分构成。第1部分：接口要求。目的在于规范湖北省市县级国土空间规划“一张图”实施监督信息系统的服务接口建设，便于为其与国土空间基础信息平台和其它业务系统的对接提供规范的数据服务和功能服务。第2部分：验收细则。目的在于规定湖北省市县级国土空间规划“一张图”实施监督信息系统验收的验收条件、验收要求、验收流程，统一规范系统验收。VDB42/T1940.12022湖北省市县级国土空

3、间规划一张图实施监督信息系统技术规范第1部分：接口要求1范围本文件规定了湖北省市（州）、县（市、区）国土空间规划“一张图”实施监督信息系统的接口分类、数据服务接口定义和功能服务接口定义。本文件适用于湖北省市（州）、县（市、区）国土空间规划“一张图”实施监督信息系统服务接口的创建和使用。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。DB42/T1726自然资源一张图数据应用服务规范3术语和定义GB/T14911、GB/T17694、GB/T25

4、597、GB/T35634、GB/T39972界定的以及下列术语和定义适用于本文件。3.1坐标系coordinatesystem给点赋予坐标的数据规则集。来源：GB/T25597-2010，4.33.2要素feature真实世界现象的抽象。来源：GB/T17694-2009，B.1793.3服务service实体通过接口提供的功能性的独特角色。来源：GB/T25597-2010，4.133.4瓦片数据tiledata根据一定的格网划分规则，对确定地理覆盖范围的地图进行分块形成的若干图片单元。来源：GB/T35634-2017，2.13.5高程基准verticaldatum由特定验潮站平均海面确

5、定的测量高程的起算面以及依据该面决定的水准原点高程。来源：GB/T14911-2008，2.201一级类目二级类目备注数据服务接口网络地图服务接口网络地图瓦片服务接口网络要素服务接口网络覆盖服务接口数据目录服务接口三维瓦片数据服务接口DB42/T1940.120223.6国土空间基础信息平台basicspatialinformationplatform按照“共建、共用、互联、共享”的原则，集成整合并统一管理各级各类国土空间数据的信息，为统一行使全民所有自然资源资产所有者职责，统一行使所有国土空间用途管制和生态保护修复职责，提升国土空间治理体系和治理能力现代化水平，提供基础服务、数据服务、专题服

6、务和业务应用服务的基础设施。3.7国土空间规划“一张图”“Inteplan”ofspatialplanning以基础地理信息和自然资源调查监测成果数据为基础，应用全国统一的测绘基准和测绘系统，集成整合国土空间规划编制和实施管理所需现状数据、各级各类国土空间规划成果数据和国土空间规划实施监督数据，形成的覆盖全域、动态更新、权威统一的国土空间规划数据资源体系。3.8国土空间规划“一张图实施监督信息系统“Inteplan”informationsystemforimplementationandsupervisionofspatialplanning基于国土空间基础信息平台构建国土空间规划“一张图”

7、，为国土空间规划编制、审批、修改和实施监督提供技术支撑的信息化系统。4缩略语下列缩略语适用于本文件。JSON：一种轻量级的数据交换格式（JavaScriptObjectNotation）CGCS2000：2000国家大地坐标系（ChinaGeodeticCoordinateSystem2000）DPI：每英寸点数（DotsPerInch）5接口分类5.1按照接口性质划分为数据服务接口和功能服务接口。5.2数据服务接口划分为网络地图服务、网络地图瓦片服务、网络要素服务、网络覆盖服务、数据目录服务、三维瓦片数据服务；功能服务接口划分为编制项目填报接口、编制成果审查接口、规划一张图接口、规划指标接口

8、。接口分类见表1。表1接口分类一级类目二级类目备注功能服务接口编制项目填报接口编制成果审查接口规划一张图接口规划指标接口参数字段参数类型参数说明tablenameString数据存放的表名primaryidString数据表主键名DB42/T1940.12022表1接口分类（续）6数据服务接口定义6.1接口描述数据服务接口应至少包括网络地图服务接口、网络地图瓦片服务接口、网络要素服务接口、网络覆盖服务接口、数据目录服务接口、三维瓦片数据服务接口，接口要求应符合DB42/T1726的规定。6.2空间数据基础要求6.2.1坐标系统采用2000国家大地坐标系（CGCS2000）。6.2.2高程基准采

9、用1985国家高程基准。6.2.3地图投影分带采用“高斯-克吕格投影”，采用国家标准分带。7功能服务接口定义7.1接口描述7.1.1功能服务接口至少包括编制项目填报接口、编制成果审查接口、规划一张图接口、规划指标接口。7.1.2接口名称使用分类前缀+名称方式命名。7.1.3接口返回状态码代表的状态值见附录A。7.2编制项目填报接口7.2.1规划编制项目进度上报接口接口名称：BZXM_GHBZXMJDSB。接口描述：用于对编制项目进度进行上报。接口类型：post。请求参数：规划编制项目进度上报接口请求参数见表2，请求接口示例见附录B中表B.1。返回参数：规划编制项目进度上报接口返回参数见表3，返

10、回结果示例见附录B中表B.3。表2规划编制项目进度上报接口请求参数3参数字段参数类型参数说明tablenameString数据存放的表名primaryidString数据表主键名filedforvalueString系统建设进度情况参数字段参数类型参数说明statusInt0表示成功，-1表示接口访问失败descString接口返回信息描述resultObject接口返回结构体参数字段参数类型参数说明statusInt0表示成功，-1表示接口访问失败descString接口返回信息描述resultObject接口返回结构体参数字段参数类型参数说明filedforvalueString编制项目的

11、基本信息DB42/T1940.12022表2规划编制项目进度上报接口请求参数（续）表3规划编制项目进度上报接口返回参数7.2.2平台与系统建设进度上报接口接口名称：BZXM_PTYXTJSJDSB。接口描述：对平台与系统建设进度进行上报。接口类型：post。请求参数：平台与系统建设进度上报接口请求参数见表4，请求接口示例见附录B中表B.4。返回参数：平台与系统建设进度上报接口返回参数见表5，返回结果示例见附录B中表B.7。表4平台与系统建设进度上报接口请求参数表5平台与系统建设进度上报接口返回参数7.3编制成果审查接口7.3.1规划成果上报接口接口名称：BZCG_GHCGSB。接口描述：规划成

12、果上报，可实现规划成果基本信息、规划成果附件统一上报。接口类型：post。请求参数：规划成果上报接口请求参数见表6，请求接口示例见附录B中表B.8。返回参数：规划成果上报接口返回参数见表7，返回结果示例见附录B中表B.10。4参数字段参数类型参数说明cgmcString成果名称cglxString成果类型cgjdString成果阶段cgztString成果状态xzqhString行政区划xzqhmcString行政区划名称fileMultiFile成果包参数字段参数类型参数说明scfaString审查方案cgbmcString成果包名称ywlxString业务类型xzqhString行政区划x

13、zqhmcString行政区划名称cjridString创建人idcjrString创建人pathString路径参数字段参数类型参数说明statusInt0表示成功，-1表示接口访问失败descString接口返回信息描述resultObject接口返回结构体DB42/T1940.12022表6规划成果上报接口请求参数表7规划成果上报接口返回参数7.3.2规划成果规范性质检接口接口名称：BZCG_GHCGGHXZJ。接口描述：创建质检任务及流程。接口类型：post。请求参数：规划成果质检接口请求参数见表8，请求接口示例见附录B中表B.11。返回参数：规划成果质检接口返回参数见表9，返回结果示

14、例见附录B中表B.12。表8规划成果质检接口请求参数5参数字段参数类型参数说明statusInt0表示成功，-1表示接口访问失败descString接口返回信息描述resultObject接口返回结构体参数字段参数类型参数说明returnidsonlyBoolean是否仅返回属性id数据whereString查询条件，sql条件表达式returngeometryBoolean是否返回图形数据insrNumber输入空间参考参数字段参数类型参数说明statusInt0表示成功，-1表示接口访问失败descString接口返回信息描述resultObject接口返回结构体参数字段参数类型参数说明s

15、crw_idString审查任务id6DB42/T1940.12022表9规划成果质检接口返回参数7.3.3规划成果质检进度查询接口接口名称：BZCG_GHCGZJJDCX。接口描述：规划成果质检进度查询。接口类型：post。请求参数：规划成果质检进度查询接口请求参数见表10，请求接口示例见附录B中表B.13。返回参数：规划成果质检进度查询接口返回参数见表11，返回结果示例见附录B中表B.14。表10规划成果质检进度查询接口请求参数表11规划成果质检进度查询接口返回参数7.4规划“一张图”接口7.4.1数据查询接口接口名称：GHYZT_SJCX。接口描述：数据查询接口。接口类型：get/pos

16、t。请求参数：数据查询接口见请求参数表12，请求接口示例见附录B中表B.16。返回参数：数据查询接口返回参数见表13，返回结果示例见附录B中表B.17。表12数据查询接口请求参数参数字段参数类型参数说明statusNumber返回结果状态：0为成功，否则失败descString描述resultJSON返回数查询结果对象参数字段参数类型参数说明geospacialdataJSONObject空间数据结构，参数以JSONString的形式传入fString返回格式参数字段参数类型参数说明outsrNumber输出空间参考outfieldsString查询显示字段参数字段参数类型参数说明xmmcSt

17、ring方案名称（以项目名称命名）参数字段参数类型参数说明ztmcString专题名称7DB42/T1940.12022表12数据查询接口请求参数（续）表13数据查询接口返回参数7.4.2数据统计接口接口名称：GHYZT_SJTJ。接口描述：统计专题展示。接口类型：get。请求参数：数据统计接口（请求展示页面）请求参数见表14，请求接口示例见附录B中表B.19。表14数据统计接口请求参数7.4.3合规性审查接口接口名称：GHYZT_HGXSC。接口描述：针对指定审查地块进行叠加分析，并将存在相交区域的地块信息及相交区域所存储的txt文件路径返回。接口类型：get。请求参数：合规性审查接口请求参

18、数见表15，请求接口示例见附录B中表B.20。返回参数：合规性审查接口返回参数见表18，返回结果示例见附录B中表B.21。表15合规性审查接口请求参数geospacialdata参数结构说明，见下表16。表16geospacialdata参数结构说明参数字段参数类型参数说明stateNumber0表示成功，-1表示接口访问失败descString接口返回信息描述resultJSON返回审查结果对象参数字段参数类型参数说明stateNumber0表示成功，-1表示接口访问失败descString接口返回信息描述resultJSON接口返回制图模板对象参数字段参数类型参数说明guidStringd

19、karrayArray多个地块数据areacalculatetypeString计算类型UnitString单位参数字段参数类型参数说明schemenameString制图方案名称fString返回格式默认JSON参数字段参数类型参数说明geometryJSONObject图形数据attributesJSONObject属性数据DB42/T1940.12022表16geospacialdata参数结构说明（续）dkarray参数说明，见下表17。表17dkarray参数说明表18合规性审查接口返回参数7.4.4成果制图接口接口名称：GHYZT_CGZT。接口描述：获取制图的相关参数和模板名称。

20、接口类型：get。请求参数：成果制图接口A（获取制图模板）请求参数见表19，请求接口示例见附录B中表B.23。返回参数：成果制图接口A（获取制图模板）返回参数见表20，返回结果示例见附录B中表B.24。表19成果制图接口A（获取制图模板）请求参数表20成果制图接口A（获取制图模板）返回参数8参数字段参数类型参数说明cartoinfoJSON制图元素信息cartodataArray制图叠加图层和图层透明度maptempString制图模板名称projectinfosArray项目地块信息projectdisplysymbolJSON项目显示符号dpiNumber出图精度formatString出

21、图格式mapscaleNumber制图比例尺versionString版本fString返回格式默认JSON参数字段参数类型参数说明maintitleString主标题bzdateString编制日期参数字段参数类型参数说明layerString叠加服务图层名称transparencyNumber透明度参数字段参数类型参数说明projectnameString项目类型geometryJSON地块信息包含图形数据，属性数据，空间参考DB42/T1940.12022接口名称：GHYZT_CGZT。接口描述：根据制图参数返回制图文件。接口类型：get。请求参数：成果制图接口B（模板制图）请求参数见表

22、21，请求接口示例见附录B中表B.26。返回参数：成果制图接口B（模板制图）返回参数见表26，返回结果示例见附录B中表B.27。表21成果制图接口B（模板制图）请求参数cartoinfo参数说明，见下表22。表22cartoinfo参数说明cartodata参数说明，见下表23。表23cartodata参数说明projectInfos参数说明，见下表24。表24projectInfos参数说明9参数字段参数类型参数说明colorString填充样式outlineJSON边框样式typeString点、线、面参数字段参数类型参数说明stateNumber0表示成功，-1表示接口访问失败descS

23、tring接口返回信息描述resultJSON返回包含制图结果地址的对象参数字段参数类型参数说明statusInt0表示成功，-1表示接口访问失败descString接口返回信息描述resultObject接口返回结构体参数字段参数类型参数说明indexNumber地块序号参数字段参数类型参数说明zbtxmcString指标体系名称DB42/T1940.12022表24projectInfos参数说明（续）projectdisplysymbol参数说明，见下表25。表25projectdisplysymbol参数说明表26成果制图接口B（模板制图）返回参数7.5规划指标接口7.5.1指标体系查

24、询接口接口名称：GHZB_ZBTXCX。接口描述：根据指标体系ID查询指标体系信息。接口类型：post。请求参数：指标体系查询接口请求参数见表27，请求接口示例见附录B中表B.28。返回参数：指标体系查询接口返回参数见表28，返回结果示例见附录B中表B.29。表27指标体系查询接口请求参数表28指标体系查询接口返回参数7.5.2指标信息查询接口10参数字段参数类型参数说明statusInt0表示成功，-1表示接口访问失败descString接口返回信息描述resultObject接口返回结构体参数字段参数类型参数说明statusInt0表示成功，-1表示接口访问失败descString接口返回

25、信息描述resultObject接口返回结构体参数字段参数类型参数说明zbbmString指标编码ndString该参数不为空时，查询指定年度数据xzqhString该参数不为空时，查询指定行政区划数据参数字段参数类型参数说明zbbmString指标编码DB42/T1940.12022接口名称：GHZB_ZBXXCX。接口描述：根据指标编码查询指标项信息。接口类型：post。请求参数：指标信息查询接口请求参数见表29，请求接口示例见附录B中表B.30。返回参数：指标信息查询接口返回参数见表30，返回结果示例见附录B中表B.31。表29指标信息查询接口请求参数表30指标信息查询接口返回参数7.5

26、.3指标数据查询接口接口名称：GHZB_ZBSJCX。接口描述：用于查询给定的指标编码对应的指标项的某一年度的指标数据，或全部数据。接口类型：post。请求参数：指标数据查询接口请求参数见表31，请求接口示例见附录B中表B.32。返回参数：指标数据查询接口返回参数见表32，返回结果示例见附录B中表B.33。表31指标数据查询接口请求参数表32指标数据查询接口返回参数7.5.4预警指标统计接口接口名称：GHZB_YJZBTJ。接口描述：用于查询给定的指标编码对应的指标项的某一年度的预警指标数据。11参数字段参数类型参数说明statusInt0表示成功，-1表示接口访问失败descString接口

27、返回信息描述resultObject接口返回结构体参数字段参数类型参数说明famcString指标体系名称ndString该参数不为空时，查询指定年份数据xzqhString该参数不为空时，查询指定行政区划数据DB42/T1940.12022接口类型：post。请求参数：预警指标统计接口请求参数见表33，请求接口示例见附录B中表B.34。返回参数：预警指标统计接口返回参数见表34，返回结果示例见附录B中表B.35。表33预警指标统计接口请求参数表表34返回参数表-预警指标统计接口状态码状态说明0成功1参数为空2数据重复3参数类型异常4添加失败5更新失败6删除失败7API调用失败8其他异常信息9

28、非法字符10网关异常11系统异常-1接口访问失败状态码状态说明0成功1添加失败2更新失败3删除失败DB42/T1940.12022AA附录A（资料性）接口返回状态码代表的状态值表A.1表A.3分别给出了接口返回状态码代表的状态值、接口正常状态码、接口异常状态码。表A.1接口返回状态码代表的状态值表A.2接口正常状态码13状态码状态说明-1000接口访问失败-1001参数为空-1002数据重复-1003参数类型异常-1004非法字符-1005其他异常信息-1006API调用失败-1101网关异常-1100系统异常DB42/T1940.12022BB表A.3接口异常状态码14字段名称（fieldn

29、ame）字段值（fieldvalue）ghcg有无规划成果gzzx有无公众咨询表B.2输入参数说明15DB42/T1940.12022附录B（资料性）功能服务接口示例B.1规划编制项目进度上报接口表B.1给出了请求接口示例。表B.1请求接口示例输入参数tablename:ghbzxm_progress_ztghbzjdfiledforvalue:fieldname:xzqh,fieldvalue:42*000000,fieldname:ghcg,fieldvalue:0,fieldname:gzzx,fieldvalue:0,fieldname:qqztyj,fieldvalue:1,fiel

30、dname:xczqyjg,fieldvalue:1,fieldname:ghcags,fieldvalue:0,fieldname:ghwyhsy,fieldvalue:1,fieldname:zfsy,fieldvalue:1,fieldname:rdsy,fieldvalue:1,fieldname:xgws,fieldvalue:1,fieldname:cggg,fieldvalue:1,fieldname:tgsp,fieldvalue:0,fieldname:sbsc,fieldvalue:0,fieldname:dwsy,fieldvalue:1,fieldname:xcssg,

31、fieldvalue:1,fieldname:zjps,fieldvalue:1,fieldname:tjbmzqyj,fieldvalue:0,fieldname:zjzx,fieldvalue:1,fieldname:xccbfa,fieldvalue:1,fieldname:xzdy,fieldvalue:1,fieldname:xmmc,fieldvalue:项目,表B.2给出了输入参数说明。字段名称（fieldname）字段值（fieldvalue）qqztyj有无前期专题研究xczqyjg有无形成征求意见稿ghcags有无规划草案公示ghwyhsy有无规划委员会审议zfsy有无政府

32、审议rdsy有无人大审议xgws有无修改完善cggg有无成果公告tgsp有无通过审批sbsc有无上报审查dwsy有无党委审议xcssg有无形成送审稿zjps有无专家评审tjbmzqyj有无同级部门征求意见zjzx有无专家咨询xccbfa有无形成初步方案xzdy有无现状调研xmmc项目名称fieldname字段名称fieldvalue字段值0表示否1表示是输出参数格式status:0,desc:操作成功,result:fcfee9d6-a051-34af-dda5-a0e6ff103adf,JSONObjectDB42/T1940.12022表B.2输入参数说明（续）表B.3给出了返回结果示例。

33、表B.3返回结果示例B.2平台与系统建设进度上报接口表B.4给出了请求接口示例。表B.4请求接口示例输入参数tablename:ghbzxm_progress_ptxtjsjd16代码名称别名代码值yztjsfs一张图建设方式1:省统建；2:市统建；3:自建gtkjptjsfs国土空间平台建设方式1:省统建；2:市统建；3:自建yztjsjz一张图建设进展1:招投标；2:在建；3:具备初步评定条件；4:具备全面评定条件gtkjptjsjz国土空间平台建设进展1:招投标；2:在建；3:具备初步评定条件；4:具备全面评定条件csxxmxjsjz城市信息模型建设进展-1:未建；1:在建；2:建成字段名称（fieldname