III

DB42/T1940.1—2022

引言

國土空間規(guī)劃“一張圖”實施監(jiān)督信息系統(tǒng)是建立國土空間規(guī)劃體系并監(jiān)督實施的重要技術支撐，

基于新技術、新手段，為國土空間規(guī)劃編制、審批、修改和實施監(jiān)督全周期管理提供信息化技術支持，

為打造可感知、能學習、善治理和自適應的智慧型規(guī)劃奠定基礎。

DB42/T1940旨在規(guī)范湖北省市縣級國土空間規(guī)劃“一張圖”實施監(jiān)督信息系統(tǒng)服務建設，DB42/T

1940由兩個部分構成。

——第1部分：接口要求。目的在于規(guī)范湖北省市縣級國土空間規(guī)劃“一張圖”實施監(jiān)督信息系

統(tǒng)的服務接口建設，便于為其與國土空間基礎信息平臺和其它業(yè)務系統(tǒng)的對接提供規(guī)范的數

據服務和功能服務。

——第2部分：驗收細則。目的在于規(guī)定湖北省市縣級國土空間規(guī)劃“一張圖”實施監(jiān)督信息系

統(tǒng)驗收的驗收條件、驗收要求、驗收流程，統(tǒng)一規(guī)范系統(tǒng)驗收。

V

DB42/T1940.1—2022

湖北省市縣級國土空間規(guī)劃"一張圖"實施監(jiān)督信息系統(tǒng)技術規(guī)范

第1部分：接口要求

1范圍

本文件規(guī)定了湖北省市（州）、縣（市、區(qū)）國土空間規(guī)劃“一張圖”實施監(jiān)督信息系統(tǒng)的接口分

類、數據服務接口定義和功能服務接口定義。

本文件適用于湖北省市（州）、縣（市、區(qū)）國土空間規(guī)劃“一張圖”實施監(jiān)督信息系統(tǒng)服務接口

的創(chuàng)建和使用。

2規(guī)范性引用文件

下列文件中的內容通過文中的規(guī)范性引用而構成本文件必不可少的條款。其中，注日期的引用文件，

僅該日期對應的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本

文件。

DB42/T1726自然資源一張圖數據應用服務規(guī)范

3術語和定義

GB/T14911、GB/T17694、GB/T25597、GB/T35634、GB/T39972界定的以及下列術語和定義適用

于本文件。

3.1

坐標系coordinatesystem

給點賦予坐標的數據規(guī)則集。

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

3.2

要素feature

真實世界現(xiàn)象的抽象。

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

3.3

服務service

實體通過接口提供的功能性的獨特角色。

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

3.4

瓦片數據tiledata

根據一定的格網劃分規(guī)則，對確定地理覆蓋范圍的地圖進行分塊形成的若干圖片單元。

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

3.5

高程基準verticaldatum

由特定驗潮站平均海面確定的測量高程的起算面以及依據該面決定的水準原點高程。

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

1

DB42/T1940.1—2022

3.6

國土空間基礎信息平臺basicspatialinformationplatform

按照“共建、共用、互聯(lián)、共享”的原則，集成整合并統(tǒng)一管理各級各類國土空間數據的信息，為

統(tǒng)一行使全民所有自然資源資產所有者職責，統(tǒng)一行使所有國土空間用途管制和生態(tài)保護修復職責，提

升國土空間治理體系和治理能力現(xiàn)代化水平，提供基礎服務、數據服務、專題服務和業(yè)務應用服務的基

礎設施。

3.7

國土空間規(guī)劃“一張圖”“Inteplan”ofspatialplanning

以基礎地理信息和自然資源調查監(jiān)測成果數據為基礎，應用全國統(tǒng)一的測繪基準和測繪系統(tǒng)，集成

整合國土空間規(guī)劃編制和實施管理所需現(xiàn)狀數據、各級各類國土空間規(guī)劃成果數據和國土空間規(guī)劃實施

監(jiān)督數據，形成的覆蓋全域、動態(tài)更新、權威統(tǒng)一的國土空間規(guī)劃數據資源體系。

3.8

國土空間規(guī)劃“一張圖"實施監(jiān)督信息系統(tǒng)“Inteplan”informationsystemfor

implementationandsupervisionofspatialplanning

基于國土空間基礎信息平臺構建國土空間規(guī)劃“一張圖”，為國土空間規(guī)劃編制、審批、修改和實施

監(jiān)督提供技術支撐的信息化系統(tǒng)。

4縮略語

下列縮略語適用于本文件。

JSON：一種輕量級的數據交換格式（JavaScriptObjectNotation）

CGCS2000：2000國家大地坐標系（ChinaGeodeticCoordinateSystem2000）

DPI：每英寸點數（DotsPerInch）

5接口分類

5.1按照接口性質劃分為數據服務接口和功能服務接口。

5.2數據服務接口劃分為網絡地圖服務、網絡地圖瓦片服務、網絡要素服務、網絡覆蓋服務、數據目

錄服務、三維瓦片數據服務；功能服務接口劃分為編制項目填報接口、編制成果審查接口、規(guī)劃一張圖

接口、規(guī)劃指標接口。接口分類見表1。

表1接口分類

一級類目二級類目備注

網絡地圖服務接口—

網絡地圖瓦片服務接口—

網絡要素服務接口—

數據服務接口

網絡覆蓋服務接口—

數據目錄服務接口—

三維瓦片數據服務接口—

2

DB42/T1940.1—2022

表1接口分類（續(xù)）

一級類目二級類目備注

編制項目填報接口—

編制成果審查接口—

功能服務接口

規(guī)劃一張圖接口—

規(guī)劃指標接口—

6數據服務接口定義

6.1接口描述

數據服務接口應至少包括網絡地圖服務接口、網絡地圖瓦片服務接口、網絡要素服務接口、網絡覆

蓋服務接口、數據目錄服務接口、三維瓦片數據服務接口，接口要求應符合DB42/T1726的規(guī)定。

6.2空間數據基礎要求

6.2.1坐標系統(tǒng)采用2000國家大地坐標系（CGCS2000）。

6.2.2高程基準采用1985國家高程基準。

6.2.3地圖投影分帶采用“高斯-克呂格投影”，采用國家標準分帶。

7功能服務接口定義

7.1接口描述

7.1.1功能服務接口至少包括編制項目填報接口、編制成果審查接口、規(guī)劃一張圖接口、規(guī)劃指標接

口。

7.1.2接口名稱使用分類前綴+名稱方式命名。

7.1.3接口返回狀態(tài)碼代表的狀態(tài)值見附錄A。

7.2編制項目填報接口

7.2.1規(guī)劃編制項目進度上報接口

接口名稱：BZXM_GHBZXMJDSB。

接口描述：用于對編制項目進度進行上報。

接口類型：post。

請求參數：規(guī)劃編制項目進度上報接口請求參數見表2，請求接口示例見附錄B中表B.1。

返回參數：規(guī)劃編制項目進度上報接口返回參數見表3，返回結果示例見附錄B中表B.3。

表2規(guī)劃編制項目進度上報接口請求參數

參數字段參數類型參數說明

tablenameString數據存放的表名

primaryidString數據表主鍵名

3

DB42/T1940.1—2022

表2規(guī)劃編制項目進度上報接口請求參數（續(xù)）

參數字段參數類型參數說明

filedforvalueString編制項目的基本信息

表3規(guī)劃編制項目進度上報接口返回參數

參數字段參數類型參數說明

statusInt0表示成功，-1表示接口訪問失敗

descString接口返回信息描述

resultObject接口返回結構體

7.2.2平臺與系統(tǒng)建設進度上報接口

接口名稱：BZXM_PTYXTJSJDSB。

接口描述：對平臺與系統(tǒng)建設進度進行上報。

接口類型：post。

請求參數：平臺與系統(tǒng)建設進度上報接口請求參數見表4，請求接口示例見附錄B中表B.4。

返回參數：平臺與系統(tǒng)建設進度上報接口返回參數見表5，返回結果示例見附錄B中表B.7。

表4平臺與系統(tǒng)建設進度上報接口請求參數

參數字段參數類型參數說明

tablenameString數據存放的表名

primaryidString數據表主鍵名

filedforvalueString系統(tǒng)建設進度情況

表5平臺與系統(tǒng)建設進度上報接口返回參數

參數字段參數類型參數說明

statusInt0表示成功，-1表示接口訪問失敗

descString接口返回信息描述

resultObject接口返回結構體

7.3編制成果審查接口

7.3.1規(guī)劃成果上報接口

接口名稱：BZCG_GHCGSB。

接口描述：規(guī)劃成果上報，可實現(xiàn)規(guī)劃成果基本信息、規(guī)劃成果附件統(tǒng)一上報。

接口類型：post。

請求參數：規(guī)劃成果上報接口請求參數見表6，請求接口示例見附錄B中表B.8。

返回參數：規(guī)劃成果上報接口返回參數見表7，返回結果示例見附錄B中表B.10。

4

DB42/T1940.1—2022

表6規(guī)劃成果上報接口請求參數

參數字段參數類型參數說明

cgmcString成果名稱

cglxString成果類型

cgjdString成果階段

cgztString成果狀態(tài)

xzqhString行政區(qū)劃

xzqhmcString行政區(qū)劃名稱

fileMultiFile成果包

表7規(guī)劃成果上報接口返回參數

參數字段參數類型參數說明

statusInt0表示成功，-1表示接口訪問失敗

descString接口返回信息描述

resultObject接口返回結構體

7.3.2規(guī)劃成果規(guī)范性質檢接口

接口名稱：BZCG_GHCGGHXZJ。

接口描述：創(chuàng)建質檢任務及流程。

接口類型：post。

請求參數：規(guī)劃成果質檢接口請求參數見表8，請求接口示例見附錄B中表B.11。

返回參數：規(guī)劃成果質檢接口返回參數見表9，返回結果示例見附錄B中表B.12。

表8規(guī)劃成果質檢接口請求參數

參數字段參數類型參數說明

scfaString審查方案

cgbmcString成果包名稱

ywlxString業(yè)務類型

xzqhString行政區(qū)劃

xzqhmcString行政區(qū)劃名稱

cjridString創(chuàng)建人id

cjrString創(chuàng)建人

pathString路徑

5

DB42/T1940.1—2022

表9規(guī)劃成果質檢接口返回參數

參數字段參數類型參數說明

statusInt0表示成功，-1表示接口訪問失敗

descString接口返回信息描述

resultObject接口返回結構體

7.3.3規(guī)劃成果質檢進度查詢接口

接口名稱：BZCG_GHCGZJJDCX。

接口描述：規(guī)劃成果質檢進度查詢。

接口類型：post。

請求參數：規(guī)劃成果質檢進度查詢接口請求參數見表10，請求接口示例見附錄B中表B.13。

返回參數：規(guī)劃成果質檢進度查詢接口返回參數見表11，返回結果示例見附錄B中表B.14。

表10規(guī)劃成果質檢進度查詢接口請求參數

參數字段參數類型參數說明

scrw_idString審查任務id

表11規(guī)劃成果質檢進度查詢接口返回參數

參數字段參數類型參數說明

statusInt0表示成功，-1表示接口訪問失敗

descString接口返回信息描述

resultObject接口返回結構體

7.4規(guī)劃“一張圖”接口

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數據查詢接口請求參數（續(xù)）

參數字段參數類型參數說明

outsrNumber輸出空間參考

outfieldsString查詢顯示字段

表13數據查詢接口返回參數

參數字段參數類型參數說明

statusNumber返回結果狀態(tài)：0為成功，否則失敗

descString描述

resultJSON返回數查詢結果對象

7.4.2數據統(tǒng)計接口

接口名稱：GHYZT_SJTJ。

接口描述：統(tǒng)計專題展示。

接口類型：get。

請求參數：數據統(tǒng)計接口（請求展示頁面）請求參數見表14，請求接口示例見附錄B中表B.19。

表14數據統(tǒng)計接口請求參數

參數字段參數類型參數說明

ztmcString專題名稱

7.4.3合規(guī)性審查接口

接口名稱：GHYZT_HGXSC。

接口描述：針對指定審查地塊進行疊加分析，并將存在相交區(qū)域的地塊信息及相交區(qū)域所存儲的txt

文件路徑返回。

接口類型：get。

請求參數：合規(guī)性審查接口請求參數見表15，請求接口示例見附錄B中表B.20。

返回參數：合規(guī)性審查接口返回參數見表18，返回結果示例見附錄B中表B.21。

表15合規(guī)性審查接口請求參數

參數字段參數類型參數說明

geospacialdataJSONObject空間數據結構，參數以JSONString的形式傳入

fString返回格式

geospacialdata參數結構說明，見下表16。

表16geospacialdata參數結構說明

參數字段參數類型參數說明

xmmcString方案名稱（以項目名稱命名）

7

DB42/T1940.1—2022

表16geospacialdata參數結構說明（續(xù)）

參數字段參數類型參數說明

guidString—

dkarrayArray多個地塊數據

areacalculatetypeString計算類型

UnitString單位

dkarray參數說明，見下表17。

表17dkarray參數說明

參數字段參數類型參數說明

geometryJSONObject圖形數據

attributesJSONObject屬性數據

表18合規(guī)性審查接口返回參數

參數字段參數類型參數說明

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參數說明（續(xù)）

參數字段參數類型參數說明

indexNumber地塊序號

projectdisplysymbol參數說明，見下表25。

表25projectdisplysymbol參數說明

參數字段參數類型參數說明

colorString填充樣式

outlineJSON邊框樣式

typeString點、線、面

表26成果制圖接口B（模板制圖）返回參數

參數字段參數類型參數說明

stateNumber0表示成功，-1表示接口訪問失敗

descString接口返回信息描述

resultJSON返回包含制圖結果地址的對象

7.5規(guī)劃指標接口

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該參數不為空時，查詢指定行政區(qū)劃數據

表32指標數據查詢接口返回參數

參數字段參數類型參數說明

statusInt0表示成功，-1表示接口訪問失敗

descString接口返回信息描述

resultObject接口返回結構體

7.5.4預警指標統(tǒng)計接口

接口名稱：GHZB_YJZBTJ。

接口描述：用于查詢給定的指標編碼對應的指標項的某一年度的預警指標數據。

11

DB42/T1940.1—2022

接口類型：post。

請求參數：預警指標統(tǒng)計接口請求參數見表33，請求接口示例見附錄B中表B.34。

返回參數：預警指標統(tǒng)計接口返回參數見表34，返回結果示例見附錄B中表B.35。

表33預警指標統(tǒng)計接口請求參數表

參數字段參數類型參數說明

famcString指標體系名稱

ndString該參數不為空時，查詢指定年份數據

xzqhString該參數不為空時，查詢指定行政區(qū)劃數據

表34返回參數表-預警指標統(tǒng)計接口

參數字段參數類型參數說明

statusInt0表示成功，-1表示接口訪問失敗

descString接口返回信息描述

resultObject接口返回結構體

12

DB42/T1940.1—2022

A

A

附錄A

（資料性）

接口返回狀態(tài)碼代表的狀態(tài)值

表A.1～表A.3分別給出了接口返回狀態(tài)碼代表的狀態(tài)值、接口正常狀態(tài)碼、接口異常狀態(tài)碼。

表A.1接口返回狀態(tài)碼代表的狀態(tài)值

狀態(tài)碼狀態(tài)說明

0成功

1參數為空

2數據重復

3參數類型異常

4添加失敗

5更新失敗

6刪除失敗

7API調用失敗

8其他異常信息

9非法字符

10網關異常

11系統(tǒng)異常

-1接口訪問失敗

表A.2接口正常狀態(tài)碼

狀態(tài)碼狀態(tài)說明

0成功

1添加失敗

2更新失敗

3刪除失敗

13

DB42/T1940.1—2022

B

B

表A.3接口異常狀態(tài)碼

狀態(tài)碼狀態(tài)說明

-1000接口訪問失敗

-1001參數為空

-1002數據重復

-1003參數類型異常

-1004非法字符

-1005其他異常信息

-1006API調用失敗

-1101網關異常

-1100系統(tǒng)異常

14

DB42/T1940.1—2022

附錄B

（資料性）

功能服務接口示例

B.1規(guī)劃編制項目進度上報接口

表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"},