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

III

DB42/T1940.1—2022

引言

国土空间规划“一张图”实施监督信息系统是建立国土空间规划体系并监督实施的重要技术支撑，

基于新技术、新手段，为国土空间规划编制、审批、修改和实施监督全周期管理提供信息化技术支持，

为打造可感知、能学习、善治理和自适应的智慧型规划奠定基础。

DB42/T1940旨在规范湖北省市县级国土空间规划“一张图”实施监督信息系统服务建设，DB42/T

1940由两个部分构成。

——第1部分：接口要求。目的在于规范湖北省市县级国土空间规划“一张图”实施监督信息系

统的服务接口建设，便于为其与国土空间基础信息平台和其它业务系统的对接提供规范的数

据服务和功能服务。

——第2部分：验收细则。目的在于规定湖北省市县级国土空间规划“一张图”实施监督信息系

统验收的验收条件、验收要求、验收流程，统一规范系统验收。

V

DB42/T1940.1—2022

湖北省市县级国土空间规划"一张图"实施监督信息系统技术规范

第1部分：接口要求

1范围

本文件规定了湖北省市（州）、县（市、区）国土空间规划“一张图”实施监督信息系统的接口分

类、数据服务接口定义和功能服务接口定义。

本文件适用于湖北省市（州）、县（市、区）国土空间规划“一张图”实施监督信息系统服务接口

的创建和使用。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

DB42/T1726自然资源一张图数据应用服务规范

3术语和定义

GB/T14911、GB/T17694、GB/T25597、GB/T35634、GB/T39972界定的以及下列术语和定义适用

于本文件。

3.1

坐标系coordinatesystem

给点赋予坐标的数据规则集。

[来源：GB/T25597-2010，4.3]

3.2

要素feature

真实世界现象的抽象。

[来源：GB/T17694-2009，B.179]

3.3

服务service

实体通过接口提供的功能性的独特角色。

[来源：GB/T25597-2010，4.13]

3.4

瓦片数据tiledata

根据一定的格网划分规则，对确定地理覆盖范围的地图进行分块形成的若干图片单元。

[来源：GB/T35634-2017，2.1]

3.5

高程基准verticaldatum

由特定验潮站平均海面确定的测量高程的起算面以及依据该面决定的水准原点高程。

[来源：GB/T14911-2008，2.20]

1

DB42/T1940.1—2022

3.6

国土空间基础信息平台basicspatialinformationplatform

按照“共建、共用、互联、共享”的原则，集成整合并统一管理各级各类国土空间数据的信息，为

统一行使全民所有自然资源资产所有者职责，统一行使所有国土空间用途管制和生态保护修复职责，提

升国土空间治理体系和治理能力现代化水平，提供基础服务、数据服务、专题服务和业务应用服务的基

础设施。

3.7

国土空间规划“一张图”“Inteplan”ofspatialplanning

以基础地理信息和自然资源调查监测成果数据为基础，应用全国统一的测绘基准和测绘系统，集成

整合国土空间规划编制和实施管理所需现状数据、各级各类国土空间规划成果数据和国土空间规划实施

监督数据，形成的覆盖全域、动态更新、权威统一的国土空间规划数据资源体系。

3.8

国土空间规划“一张图"实施监督信息系统“Inteplan”informationsystemfor

implementationandsupervisionofspatialplanning

基于国土空间基础信息平台构建国土空间规划“一张图”，为国土空间规划编制、审批、修改和实施

监督提供技术支撑的信息化系统。

4缩略语

下列缩略语适用于本文件。

JSON：一种轻量级的数据交换格式（JavaScriptObjectNotation）

CGCS2000：2000国家大地坐标系（ChinaGeodeticCoordinateSystem2000）

DPI：每英寸点数（DotsPerInch）

5接口分类

5.1按照接口性质划分为数据服务接口和功能服务接口。

5.2数据服务接口划分为网络地图服务、网络地图瓦片服务、网络要素服务、网络覆盖服务、数据目

录服务、三维瓦片数据服务；功能服务接口划分为编制项目填报接口、编制成果审查接口、规划一张图

接口、规划指标接口。接口分类见表1。

表1接口分类

一级类目二级类目备注

网络地图服务接口—

网络地图瓦片服务接口—

网络要素服务接口—

数据服务接口

网络覆盖服务接口—

数据目录服务接口—

三维瓦片数据服务接口—

2

DB42/T1940.1—2022

表1接口分类（续）

一级类目二级类目备注

编制项目填报接口—

编制成果审查接口—

功能服务接口

规划一张图接口—

规划指标接口—

6数据服务接口定义

6.1接口描述

数据服务接口应至少包括网络地图服务接口、网络地图瓦片服务接口、网络要素服务接口、网络覆

盖服务接口、数据目录服务接口、三维瓦片数据服务接口，接口要求应符合DB42/T1726的规定。

6.2空间数据基础要求

6.2.1坐标系统采用2000国家大地坐标系（CGCS2000）。

6.2.2高程基准采用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，返回结果示例见附录B中表B.3。

表2规划编制项目进度上报接口请求参数

参数字段参数类型参数说明

tablenameString数据存放的表名

primaryidString数据表主键名

3

DB42/T1940.1—2022

表2规划编制项目进度上报接口请求参数（续）

参数字段参数类型参数说明

filedforvalueString编制项目的基本信息

表3规划编制项目进度上报接口返回参数

参数字段参数类型参数说明

statusInt0表示成功，-1表示接口访问失败

descString接口返回信息描述

resultObject接口返回结构体

7.2.2平台与系统建设进度上报接口

接口名称：BZXM_PTYXTJSJDSB。

接口描述：对平台与系统建设进度进行上报。

接口类型：post。

请求参数：平台与系统建设进度上报接口请求参数见表4，请求接口示例见附录B中表B.4。

返回参数：平台与系统建设进度上报接口返回参数见表5，返回结果示例见附录B中表B.7。

表4平台与系统建设进度上报接口请求参数

参数字段参数类型参数说明

tablenameString数据存放的表名

primaryidString数据表主键名

filedforvalueString系统建设进度情况

表5平台与系统建设进度上报接口返回参数

参数字段参数类型参数说明

statusInt0表示成功，-1表示接口访问失败

descString接口返回信息描述

resultObject接口返回结构体

7.3编制成果审查接口

7.3.1规划成果上报接口

接口名称：BZCG_GHCGSB。

接口描述：规划成果上报，可实现规划成果基本信息、规划成果附件统一上报。

接口类型：post。

请求参数：规划成果上报接口请求参数见表6，请求接口示例见附录B中表B.8。

返回参数：规划成果上报接口返回参数见表7，返回结果示例见附录B中表B.10。

4

DB42/T1940.1—2022

表6规划成果上报接口请求参数

参数字段参数类型参数说明

cgmcString成果名称

cglxString成果类型

cgjdString成果阶段

cgztString成果状态

xzqhString行政区划

xzqhmcString行政区划名称

fileMultiFile成果包

表7规划成果上报接口返回参数

参数字段参数类型参数说明

statusInt0表示成功，-1表示接口访问失败

descString接口返回信息描述

resultObject接口返回结构体

7.3.2规划成果规范性质检接口

接口名称：BZCG_GHCGGHXZJ。

接口描述：创建质检任务及流程。

接口类型：post。

请求参数：规划成果质检接口请求参数见表8，请求接口示例见附录B中表B.11。

返回参数：规划成果质检接口返回参数见表9，返回结果示例见附录B中表B.12。

表8规划成果质检接口请求参数

参数字段参数类型参数说明

scfaString审查方案

cgbmcString成果包名称

ywlxString业务类型

xzqhString行政区划

xzqhmcString行政区划名称

cjridString创建人id

cjrString创建人

pathString路径

5

DB42/T1940.1—2022

表9规划成果质检接口返回参数

参数字段参数类型参数说明

statusInt0表示成功，-1表示接口访问失败

descString接口返回信息描述

resultObject接口返回结构体

7.3.3规划成果质检进度查询接口

接口名称：BZCG_GHCGZJJDCX。

接口描述：规划成果质检进度查询。

接口类型：post。

请求参数：规划成果质检进度查询接口请求参数见表10，请求接口示例见附录B中表B.13。

返回参数：规划成果质检进度查询接口返回参数见表11，返回结果示例见附录B中表B.14。

表10规划成果质检进度查询接口请求参数

参数字段参数类型参数说明

scrw_idString审查任务id

表11规划成果质检进度查询接口返回参数

参数字段参数类型参数说明

statusInt0表示成功，-1表示接口访问失败

descString接口返回信息描述

resultObject接口返回结构体

7.4规划“一张图”接口

7.4.1数据查询接口

接口名称：GHYZT_SJCX。

接口描述：数据查询接口。

接口类型：get/post。

请求参数：数据查询接口见请求参数表12，请求接口示例见附录B中表B.16。

返回参数：数据查询接口返回参数见表13，返回结果示例见附录B中表B.17。

表12数据查询接口请求参数

参数字段参数类型参数说明

returnidsonlyBoolean是否仅返回属性id数据

whereString查询条件，sql条件表达式

returngeometryBoolean是否返回图形数据

insrNumber输入空间参考

6

DB42/T1940.1—2022

表12数据查询接口请求参数（续）

参数字段参数类型参数说明

outsrNumber输出空间参考

outfieldsString查询显示字段

表13数据查询接口返回参数

参数字段参数类型参数说明

statusNumber返回结果状态：0为成功，否则失败

descString描述

resultJSON返回数查询结果对象

7.4.2数据统计接口

接口名称：GHYZT_SJTJ。

接口描述：统计专题展示。

接口类型：get。

请求参数：数据统计接口（请求展示页面）请求参数见表14，请求接口示例见附录B中表B.19。

表14数据统计接口请求参数

参数字段参数类型参数说明

ztmcString专题名称

7.4.3合规性审查接口

接口名称：GHYZT_HGXSC。

接口描述：针对指定审查地块进行叠加分析，并将存在相交区域的地块信息及相交区域所存储的txt

文件路径返回。

接口类型：get。

请求参数：合规性审查接口请求参数见表15，请求接口示例见附录B中表B.20。

返回参数：合规性审查接口返回参数见表18，返回结果示例见附录B中表B.21。

表15合规性审查接口请求参数

参数字段参数类型参数说明

geospacialdataJSONObject空间数据结构，参数以JSONString的形式传入

fString返回格式

geospacialdata参数结构说明，见下表16。

表16geospacialdata参数结构说明

参数字段参数类型参数说明

xmmcString方案名称（以项目名称命名）

7

DB42/T1940.1—2022

表16geospacialdata参数结构说明（续）

参数字段参数类型参数说明

guidString—

dkarrayArray多个地块数据

areacalculatetypeString计算类型

UnitString单位

dkarray参数说明，见下表17。

表17dkarray参数说明

参数字段参数类型参数说明

geometryJSONObject图形数据

attributesJSONObject属性数据

表18合规性审查接口返回参数

参数字段参数类型参数说明

stateNumber0表示成功，-1表示接口访问失败

descString接口返回信息描述

resultJSON返回审查结果对象

7.4.4成果制图接口

接口名称：GHYZT_CGZT。

接口描述：获取制图的相关参数和模板名称。

接口类型：get。

请求参数：成果制图接口A（获取制图模板）请求参数见表19，请求接口示例见附录B中表B.23。

返回参数：成果制图接口A（获取制图模板）返回参数见表20，返回结果示例见附录B中表B.24。

表19成果制图接口A（获取制图模板）请求参数

参数字段参数类型参数说明

schemenameString制图方案名称

fString返回格式默认JSON

表20成果制图接口A（获取制图模板）返回参数

参数字段参数类型参数说明

stateNumber0表示成功，-1表示接口访问失败

descString接口返回信息描述

resultJSON接口返回制图模板对象

8

DB42/T1940.1—2022

接口名称：GHYZT_CGZT。

接口描述：根据制图参数返回制图文件。

接口类型：get。

请求参数：成果制图接口B（模板制图）请求参数见表21，请求接口示例见附录B中表B.26。

返回参数：成果制图接口B（模板制图）返回参数见表26，返回结果示例见附录B中表B.27。

表21成果制图接口B（模板制图）请求参数

参数字段参数类型参数说明

cartoinfoJSON制图元素信息

cartodataArray制图叠加图层和图层透明度

maptempString制图模板名称

projectinfosArray项目地块信息

projectdisplysymbolJSON项目显示符号

dpiNumber出图精度

formatString出图格式

mapscaleNumber制图比例尺

versionString版本

fString返回格式默认JSON

cartoinfo参数说明，见下表22。

表22cartoinfo参数说明

参数字段参数类型参数说明

maintitleString主标题

bzdateString编制日期

cartodata参数说明，见下表23。

表23cartodata参数说明

参数字段参数类型参数说明

layerString叠加服务图层名称

transparencyNumber透明度

projectInfos参数说明，见下表24。

表24projectInfos参数说明

参数字段参数类型参数说明

projectnameString项目类型

geometryJSON地块信息包含图形数据，属性数据，空间参考

9

DB42/T1940.1—2022

表24projectInfos参数说明（续）

参数字段参数类型参数说明

indexNumber地块序号

projectdisplysymbol参数说明，见下表25。

表25projectdisplysymbol参数说明

参数字段参数类型参数说明

colorString填充样式

outlineJSON边框样式

typeString点、线、面

表26成果制图接口B（模板制图）返回参数

参数字段参数类型参数说明

stateNumber0表示成功，-1表示接口访问失败

descString接口返回信息描述

resultJSON返回包含制图结果地址的对象

7.5规划指标接口

7.5.1指标体系查询接口

接口名称：GHZB_ZBTXCX。

接口描述：根据指标体系ID查询指标体系信息。

接口类型：post。

请求参数：指标体系查询接口请求参数见表27，请求接口示例见附录B中表B.28。

返回参数：指标体系查询接口返回参数见表28，返回结果示例见附录B中表B.29。

表27指标体系查询接口请求参数

参数字段参数类型参数说明

zbtxmcString指标体系名称

表28指标体系查询接口返回参数

参数字段参数类型参数说明

statusInt0表示成功，-1表示接口访问失败

descString接口返回信息描述

resultObject接口返回结构体

7.5.2指标信息查询接口

10

DB42/T1940.1—2022

接口名称：GHZB_ZBXXCX。

接口描述：根据指标编码查询指标项信息。

接口类型：post。

请求参数：指标信息查询接口请求参数见表29，请求接口示例见附录B中表B.30。

返回参数：指标信息查询接口返回参数见表30，返回结果示例见附录B中表B.31。

表29指标信息查询接口请求参数

参数字段参数类型参数说明

zbbmString指标编码

表30指标信息查询接口返回参数

参数字段参数类型参数说明

statusInt0表示成功，-1表示接口访问失败

descString接口返回信息描述

resultObject接口返回结构体

7.5.3指标数据查询接口

接口名称：GHZB_ZBSJCX。

接口描述：用于查询给定的指标编码对应的指标项的某一年度的指标数据，或全部数据。

接口类型：post。

请求参数：指标数据查询接口请求参数见表31，请求接口示例见附录B中表B.32。

返回参数：指标数据查询接口返回参数见表32，返回结果示例见附录B中表B.33。

表31指标数据查询接口请求参数

参数字段参数类型参数说明

zbbmString指标编码

ndString该参数不为空时，查询指定年度数据

xzqhString该参数不为空时，查询指定行政区划数据

表32指标数据查询接口返回参数

参数字段参数类型参数说明

statusInt0表示成功，-1表示接口访问失败

descString接口返回信息描述

resultObject接口返回结构体

7.5.4预警指标统计接口

接口名称：GHZB_YJZBTJ。

接口描述：用于查询给定的指标编码对应的指标项的某一年度的预警指标数据。

11

DB42/T1940.1—2022

接口类型：post。

请求参数：预警指标统计接口请求参数见表33，请求接口示例见附录B中表B.34。

返回参数：预警指标统计接口返回参数见表34，返回结果示例见附录B中表B.35。

表33预警指标统计接口请求参数表

参数字段参数类型参数说明

famcString指标体系名称

ndString该参数不为空时，查询指定年份数据

xzqhString该参数不为空时，查询指定行政区划数据

表34返回参数表-预警指标统计接口

参数字段参数类型参数说明

statusInt0表示成功，-1表示接口访问失败

descString接口返回信息描述

resultObject接口返回结构体

12

DB42/T1940.1—2022

A

A

附录A

（资料性）

接口返回状态码代表的状态值

表A.1～表A.3分别给出了接口返回状态码代表的状态值、接口正常状态码、接口异常状态码。

表A.1接口返回状态码代表的状态值

状态码状态说明

0成功

1参数为空

2数据重复

3参数类型异常

4添加失败

5更新失败

6删除失败

7API调用失败

8其他异常信息

9非法字符

10网关异常

11系统异常

-1接口访问失败

表A.2接口正常状态码

状态码状态说明

0成功

1添加失败

2更新失败

3删除失败

13

DB42/T1940.1—2022

B

B

表A.3接口异常状态码

状态码状态说明

-1000接口访问失败

-1001参数为空

-1002数据重复

-1003参数类型异常

-1004非法字符

-1005其他异常信息

-1006API调用失败

-1101网关异常

-1100系统异常

14

DB42/T1940.1—2022

附录B

（资料性）

功能服务接口示例

B.1规划编制项目进度上报接口

表B.1给出了请求接口示例。

表B.1请求接口示例

输入参数

{

tablename:ghbzxm_progress_ztghbzjd

filedforvalue:[

{"fieldname":"xzqh","fieldvalue":"42****000000"},

{"fieldname":"ghcg","fieldvalue":"0"},

{"fieldname":"gzzx","fieldvalue":"0"},

{"fieldname":"qqztyj","fieldvalue":"1"},

{"fieldname":"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","fieldvalue":"1"},

{"fieldname":"zjps","fieldvalue":"1"},