DB42T1940.1-2022湖北省市縣級(jí)國(guó)土空間規(guī)劃“一張圖”實(shí)施監(jiān)督信息系統(tǒng)技術(shù)規(guī)范 第1部分：接口要求

III

DB42/T1940.1—2022

引言

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

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

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

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

1940由兩個(gè)部分構(gòu)成。

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

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

據(jù)服務(wù)和功能服務(wù)。

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

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

V

DB42/T1940.1—2022

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

第1部分：接口要求

1范圍

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

類、數(shù)據(jù)服務(wù)接口定義和功能服務(wù)接口定義。

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

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

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

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

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

文件。

DB42/T1726自然資源一張圖數(shù)據(jù)應(yīng)用服務(wù)規(guī)范

3術(shù)語和定義

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

于本文件。

3.1

坐標(biāo)系coordinatesystem

給點(diǎn)賦予坐標(biāo)的數(shù)據(jù)規(guī)則集。

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

3.2

要素feature

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

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

3.3

服務(wù)service

實(shí)體通過接口提供的功能性的獨(dú)特角色。

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

3.4

瓦片數(shù)據(jù)tiledata

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

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

3.5

高程基準(zhǔn)verticaldatum

由特定驗(yàn)潮站平均海面確定的測(cè)量高程的起算面以及依據(jù)該面決定的水準(zhǔn)原點(diǎn)高程。

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

1

DB42/T1940.1—2022

3.6

國(guó)土空間基礎(chǔ)信息平臺(tái)basicspatialinformationplatform

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

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

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

礎(chǔ)設(shè)施。

3.7

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

以基礎(chǔ)地理信息和自然資源調(diào)查監(jiān)測(cè)成果數(shù)據(jù)為基礎(chǔ)，應(yīng)用全國(guó)統(tǒng)一的測(cè)繪基準(zhǔn)和測(cè)繪系統(tǒng)，集成

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

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

3.8

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

implementationandsupervisionofspatialplanning

基于國(guó)土空間基礎(chǔ)信息平臺(tái)構(gòu)建國(guó)土空間規(guī)劃“一張圖”，為國(guó)土空間規(guī)劃編制、審批、修改和實(shí)施

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

4縮略語

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

JSON：一種輕量級(jí)的數(shù)據(jù)交換格式（JavaScriptObjectNotation）

CGCS2000：2000國(guó)家大地坐標(biāo)系（ChinaGeodeticCoordinateSystem2000）

DPI：每英寸點(diǎn)數(shù)（DotsPerInch）

5接口分類

5.1按照接口性質(zhì)劃分為數(shù)據(jù)服務(wù)接口和功能服務(wù)接口。

5.2數(shù)據(jù)服務(wù)接口劃分為網(wǎng)絡(luò)地圖服務(wù)、網(wǎng)絡(luò)地圖瓦片服務(wù)、網(wǎng)絡(luò)要素服務(wù)、網(wǎng)絡(luò)覆蓋服務(wù)、數(shù)據(jù)目

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

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

表1接口分類

一級(jí)類目二級(jí)類目備注

網(wǎng)絡(luò)地圖服務(wù)接口—

網(wǎng)絡(luò)地圖瓦片服務(wù)接口—

網(wǎng)絡(luò)要素服務(wù)接口—

數(shù)據(jù)服務(wù)接口

網(wǎng)絡(luò)覆蓋服務(wù)接口—

數(shù)據(jù)目錄服務(wù)接口—

三維瓦片數(shù)據(jù)服務(wù)接口—

2

DB42/T1940.1—2022

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

一級(jí)類目二級(jí)類目備注

編制項(xiàng)目填報(bào)接口—

編制成果審查接口—

功能服務(wù)接口

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

規(guī)劃指標(biāo)接口—

6數(shù)據(jù)服務(wù)接口定義

6.1接口描述

數(shù)據(jù)服務(wù)接口應(yīng)至少包括網(wǎng)絡(luò)地圖服務(wù)接口、網(wǎng)絡(luò)地圖瓦片服務(wù)接口、網(wǎng)絡(luò)要素服務(wù)接口、網(wǎng)絡(luò)覆

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

6.2空間數(shù)據(jù)基礎(chǔ)要求

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

6.2.2高程基準(zhǔn)采用1985國(guó)家高程基準(zhǔn)。

6.2.3地圖投影分帶采用“高斯-克呂格投影”，采用國(guó)家標(biāo)準(zhǔn)分帶。

7功能服務(wù)接口定義

7.1接口描述

7.1.1功能服務(wù)接口至少包括編制項(xiàng)目填報(bào)接口、編制成果審查接口、規(guī)劃一張圖接口、規(guī)劃指標(biāo)接

口。

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

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

7.2編制項(xiàng)目填報(bào)接口

7.2.1規(guī)劃編制項(xiàng)目進(jìn)度上報(bào)接口

接口名稱：BZXM_GHBZXMJDSB。

接口描述：用于對(duì)編制項(xiàng)目進(jìn)度進(jìn)行上報(bào)。

接口類型：post。

請(qǐng)求參數(shù)：規(guī)劃編制項(xiàng)目進(jìn)度上報(bào)接口請(qǐng)求參數(shù)見表2，請(qǐng)求接口示例見附錄B中表B.1。

返回參數(shù)：規(guī)劃編制項(xiàng)目進(jìn)度上報(bào)接口返回參數(shù)見表3，返回結(jié)果示例見附錄B中表B.3。

表2規(guī)劃編制項(xiàng)目進(jìn)度上報(bào)接口請(qǐng)求參數(shù)

參數(shù)字段參數(shù)類型參數(shù)說明

tablenameString數(shù)據(jù)存放的表名

primaryidString數(shù)據(jù)表主鍵名

3

DB42/T1940.1—2022

表2規(guī)劃編制項(xiàng)目進(jìn)度上報(bào)接口請(qǐng)求參數(shù)（續(xù)）

參數(shù)字段參數(shù)類型參數(shù)說明

filedforvalueString編制項(xiàng)目的基本信息

表3規(guī)劃編制項(xiàng)目進(jìn)度上報(bào)接口返回參數(shù)

參數(shù)字段參數(shù)類型參數(shù)說明

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

descString接口返回信息描述

resultObject接口返回結(jié)構(gòu)體

7.2.2平臺(tái)與系統(tǒng)建設(shè)進(jìn)度上報(bào)接口

接口名稱：BZXM_PTYXTJSJDSB。

接口描述：對(duì)平臺(tái)與系統(tǒng)建設(shè)進(jìn)度進(jìn)行上報(bào)。

接口類型：post。

請(qǐng)求參數(shù)：平臺(tái)與系統(tǒng)建設(shè)進(jìn)度上報(bào)接口請(qǐng)求參數(shù)見表4，請(qǐng)求接口示例見附錄B中表B.4。

返回參數(shù)：平臺(tái)與系統(tǒng)建設(shè)進(jìn)度上報(bào)接口返回參數(shù)見表5，返回結(jié)果示例見附錄B中表B.7。

表4平臺(tái)與系統(tǒng)建設(shè)進(jìn)度上報(bào)接口請(qǐng)求參數(shù)

參數(shù)字段參數(shù)類型參數(shù)說明

tablenameString數(shù)據(jù)存放的表名

primaryidString數(shù)據(jù)表主鍵名

filedforvalueString系統(tǒng)建設(shè)進(jìn)度情況

表5平臺(tái)與系統(tǒng)建設(shè)進(jìn)度上報(bào)接口返回參數(shù)

參數(shù)字段參數(shù)類型參數(shù)說明

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

descString接口返回信息描述

resultObject接口返回結(jié)構(gòu)體

7.3編制成果審查接口

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

接口名稱：BZCG_GHCGSB。

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

接口類型：post。

請(qǐng)求參數(shù)：規(guī)劃成果上報(bào)接口請(qǐng)求參數(shù)見表6，請(qǐng)求接口示例見附錄B中表B.8。

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

4

DB42/T1940.1—2022

表6規(guī)劃成果上報(bào)接口請(qǐng)求參數(shù)

參數(shù)字段參數(shù)類型參數(shù)說明

cgmcString成果名稱

cglxString成果類型

cgjdString成果階段

cgztString成果狀態(tài)

xzqhString行政區(qū)劃

xzqhmcString行政區(qū)劃名稱

fileMultiFile成果包

表7規(guī)劃成果上報(bào)接口返回參數(shù)

參數(shù)字段參數(shù)類型參數(shù)說明

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

descString接口返回信息描述

resultObject接口返回結(jié)構(gòu)體

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

接口名稱：BZCG_GHCGGHXZJ。

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

接口類型：post。

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

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

表8規(guī)劃成果質(zhì)檢接口請(qǐng)求參數(shù)

參數(shù)字段參數(shù)類型參數(shù)說明

scfaString審查方案

cgbmcString成果包名稱

ywlxString業(yè)務(wù)類型

xzqhString行政區(qū)劃

xzqhmcString行政區(qū)劃名稱

cjridString創(chuàng)建人id

cjrString創(chuàng)建人

pathString路徑

5

DB42/T1940.1—2022

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

參數(shù)字段參數(shù)類型參數(shù)說明

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

descString接口返回信息描述

resultObject接口返回結(jié)構(gòu)體

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

接口名稱：BZCG_GHCGZJJDCX。

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

接口類型：post。

請(qǐng)求參數(shù)：規(guī)劃成果質(zhì)檢進(jìn)度查詢接口請(qǐng)求參數(shù)見表10，請(qǐng)求接口示例見附錄B中表B.13。

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

表10規(guī)劃成果質(zhì)檢進(jìn)度查詢接口請(qǐng)求參數(shù)

參數(shù)字段參數(shù)類型參數(shù)說明

scrw_idString審查任務(wù)id

表11規(guī)劃成果質(zhì)檢進(jìn)度查詢接口返回參數(shù)

參數(shù)字段參數(shù)類型參數(shù)說明

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

descString接口返回信息描述

resultObject接口返回結(jié)構(gòu)體

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

7.4.1數(shù)據(jù)查詢接口

接口名稱：GHYZT_SJCX。

接口描述：數(shù)據(jù)查詢接口。

接口類型：get/post。

請(qǐng)求參數(shù)：數(shù)據(jù)查詢接口見請(qǐng)求參數(shù)表12，請(qǐng)求接口示例見附錄B中表B.16。

返回參數(shù)：數(shù)據(jù)查詢接口返回參數(shù)見表13，返回結(jié)果示例見附錄B中表B.17。

表12數(shù)據(jù)查詢接口請(qǐng)求參數(shù)

參數(shù)字段參數(shù)類型參數(shù)說明

returnidsonlyBoolean是否僅返回屬性id數(shù)據(jù)

whereString查詢條件，sql條件表達(dá)式

returngeometryBoolean是否返回圖形數(shù)據(jù)

insrNumber輸入空間參考

6

DB42/T1940.1—2022

表12數(shù)據(jù)查詢接口請(qǐng)求參數(shù)（續(xù)）

參數(shù)字段參數(shù)類型參數(shù)說明

outsrNumber輸出空間參考

outfieldsString查詢顯示字段

表13數(shù)據(jù)查詢接口返回參數(shù)

參數(shù)字段參數(shù)類型參數(shù)說明

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

descString描述

resultJSON返回?cái)?shù)查詢結(jié)果對(duì)象

7.4.2數(shù)據(jù)統(tǒng)計(jì)接口

接口名稱：GHYZT_SJTJ。

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

接口類型：get。

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

表14數(shù)據(jù)統(tǒng)計(jì)接口請(qǐng)求參數(shù)

參數(shù)字段參數(shù)類型參數(shù)說明

ztmcString專題名稱

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

接口名稱：GHYZT_HGXSC。

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

文件路徑返回。

接口類型：get。

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

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

表15合規(guī)性審查接口請(qǐng)求參數(shù)

參數(shù)字段參數(shù)類型參數(shù)說明

geospacialdataJSONObject空間數(shù)據(jù)結(jié)構(gòu)，參數(shù)以JSONString的形式傳入

fString返回格式

geospacialdata參數(shù)結(jié)構(gòu)說明，見下表16。

表16geospacialdata參數(shù)結(jié)構(gòu)說明

參數(shù)字段參數(shù)類型參數(shù)說明

xmmcString方案名稱（以項(xiàng)目名稱命名）

7

DB42/T1940.1—2022

表16geospacialdata參數(shù)結(jié)構(gòu)說明（續(xù)）

參數(shù)字段參數(shù)類型參數(shù)說明

guidString—

dkarrayArray多個(gè)地塊數(shù)據(jù)

areacalculatetypeString計(jì)算類型

UnitString單位

dkarray參數(shù)說明，見下表17。

表17dkarray參數(shù)說明

參數(shù)字段參數(shù)類型參數(shù)說明

geometryJSONObject圖形數(shù)據(jù)

attributesJSONObject屬性數(shù)據(jù)

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

參數(shù)字段參數(shù)類型參數(shù)說明

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

descString接口返回信息描述

resultJSON返回審查結(jié)果對(duì)象

7.4.4成果制圖接口

接口名稱：GHYZT_CGZT。

接口描述：獲取制圖的相關(guān)參數(shù)和模板名稱。

接口類型：get。

請(qǐng)求參數(shù)：成果制圖接口A（獲取制圖模板）請(qǐng)求參數(shù)見表19，請(qǐng)求接口示例見附錄B中表B.23。

返回參數(shù)：成果制圖接口A（獲取制圖模板）返回參數(shù)見表20，返回結(jié)果示例見附錄B中表B.24。

表19成果制圖接口A（獲取制圖模板）請(qǐng)求參數(shù)

參數(shù)字段參數(shù)類型參數(shù)說明

schemenameString制圖方案名稱

fString返回格式默認(rèn)JSON

表20成果制圖接口A（獲取制圖模板）返回參數(shù)

參數(shù)字段參數(shù)類型參數(shù)說明

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

descString接口返回信息描述

resultJSON接口返回制圖模板對(duì)象

8

DB42/T1940.1—2022

接口名稱：GHYZT_CGZT。

接口描述：根據(jù)制圖參數(shù)返回制圖文件。

接口類型：get。

請(qǐng)求參數(shù)：成果制圖接口B（模板制圖）請(qǐng)求參數(shù)見表21，請(qǐng)求接口示例見附錄B中表B.26。

返回參數(shù)：成果制圖接口B（模板制圖）返回參數(shù)見表26，返回結(jié)果示例見附錄B中表B.27。

表21成果制圖接口B（模板制圖）請(qǐng)求參數(shù)

參數(shù)字段參數(shù)類型參數(shù)說明

cartoinfoJSON制圖元素信息

cartodataArray制圖疊加圖層和圖層透明度

maptempString制圖模板名稱

projectinfosArray項(xiàng)目地塊信息

projectdisplysymbolJSON項(xiàng)目顯示符號(hào)

dpiNumber出圖精度

formatString出圖格式

mapscaleNumber制圖比例尺

versionString版本

fString返回格式默認(rèn)JSON

cartoinfo參數(shù)說明，見下表22。

表22cartoinfo參數(shù)說明

參數(shù)字段參數(shù)類型參數(shù)說明

maintitleString主標(biāo)題

bzdateString編制日期

cartodata參數(shù)說明，見下表23。

表23cartodata參數(shù)說明

參數(shù)字段參數(shù)類型參數(shù)說明

layerString疊加服務(wù)圖層名稱

transparencyNumber透明度

projectInfos參數(shù)說明，見下表24。

表24projectInfos參數(shù)說明

參數(shù)字段參數(shù)類型參數(shù)說明

projectnameString項(xiàng)目類型

geometryJSON地塊信息包含圖形數(shù)據(jù)，屬性數(shù)據(jù)，空間參考

9

DB42/T1940.1—2022

表24projectInfos參數(shù)說明（續(xù)）

參數(shù)字段參數(shù)類型參數(shù)說明

indexNumber地塊序號(hào)

projectdisplysymbol參數(shù)說明，見下表25。

表25projectdisplysymbol參數(shù)說明

參數(shù)字段參數(shù)類型參數(shù)說明

colorString填充樣式

outlineJSON邊框樣式

typeString點(diǎn)、線、面

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

參數(shù)字段參數(shù)類型參數(shù)說明

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

descString接口返回信息描述

resultJSON返回包含制圖結(jié)果地址的對(duì)象

7.5規(guī)劃指標(biāo)接口

7.5.1指標(biāo)體系查詢接口

接口名稱：GHZB_ZBTXCX。

接口描述：根據(jù)指標(biāo)體系ID查詢指標(biāo)體系信息。

接口類型：post。

請(qǐng)求參數(shù)：指標(biāo)體系查詢接口請(qǐng)求參數(shù)見表27，請(qǐng)求接口示例見附錄B中表B.28。

返回參數(shù)：指標(biāo)體系查詢接口返回參數(shù)見表28，返回結(jié)果示例見附錄B中表B.29。

表27指標(biāo)體系查詢接口請(qǐng)求參數(shù)

參數(shù)字段參數(shù)類型參數(shù)說明

zbtxmcString指標(biāo)體系名稱

表28指標(biāo)體系查詢接口返回參數(shù)

參數(shù)字段參數(shù)類型參數(shù)說明

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

descString接口返回信息描述

resultObject接口返回結(jié)構(gòu)體

7.5.2指標(biāo)信息查詢接口

10

DB42/T1940.1—2022

接口名稱：GHZB_ZBXXCX。

接口描述：根據(jù)指標(biāo)編碼查詢指標(biāo)項(xiàng)信息。

接口類型：post。

請(qǐng)求參數(shù)：指標(biāo)信息查詢接口請(qǐng)求參數(shù)見表29，請(qǐng)求接口示例見附錄B中表B.30。

返回參數(shù)：指標(biāo)信息查詢接口返回參數(shù)見表30，返回結(jié)果示例見附錄B中表B.31。

表29指標(biāo)信息查詢接口請(qǐng)求參數(shù)

參數(shù)字段參數(shù)類型參數(shù)說明

zbbmString指標(biāo)編碼

表30指標(biāo)信息查詢接口返回參數(shù)

參數(shù)字段參數(shù)類型參數(shù)說明

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

descString接口返回信息描述

resultObject接口返回結(jié)構(gòu)體

7.5.3指標(biāo)數(shù)據(jù)查詢接口

接口名稱：GHZB_ZBSJCX。

接口描述：用于查詢給定的指標(biāo)編碼對(duì)應(yīng)的指標(biāo)項(xiàng)的某一年度的指標(biāo)數(shù)據(jù)，或全部數(shù)據(jù)。

接口類型：post。

請(qǐng)求參數(shù)：指標(biāo)數(shù)據(jù)查詢接口請(qǐng)求參數(shù)見表31，請(qǐng)求接口示例見附錄B中表B.32。

返回參數(shù)：指標(biāo)數(shù)據(jù)查詢接口返回參數(shù)見表32，返回結(jié)果示例見附錄B中表B.33。

表31指標(biāo)數(shù)據(jù)查詢接口請(qǐng)求參數(shù)

參數(shù)字段參數(shù)類型參數(shù)說明

zbbmString指標(biāo)編碼

ndString該參數(shù)不為空時(shí)，查詢指定年度數(shù)據(jù)

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

表32指標(biāo)數(shù)據(jù)查詢接口返回參數(shù)

參數(shù)字段參數(shù)類型參數(shù)說明

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

descString接口返回信息描述

resultObject接口返回結(jié)構(gòu)體

7.5.4預(yù)警指標(biāo)統(tǒng)計(jì)接口

接口名稱：GHZB_YJZBTJ。

接口描述：用于查詢給定的指標(biāo)編碼對(duì)應(yīng)的指標(biāo)項(xiàng)的某一年度的預(yù)警指標(biāo)數(shù)據(jù)。

11

DB42/T1940.1—2022

接口類型：post。

請(qǐng)求參數(shù)：預(yù)警指標(biāo)統(tǒng)計(jì)接口請(qǐng)求參數(shù)見表33，請(qǐng)求接口示例見附錄B中表B.34。

返回參數(shù)：預(yù)警指標(biāo)統(tǒng)計(jì)接口返回參數(shù)見表34，返回結(jié)果示例見附錄B中表B.35。

表33預(yù)警指標(biāo)統(tǒng)計(jì)接口請(qǐng)求參數(shù)表

參數(shù)字段參數(shù)類型參數(shù)說明

famcString指標(biāo)體系名稱

ndString該參數(shù)不為空時(shí)，查詢指定年份數(shù)據(jù)

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

表34返回參數(shù)表-預(yù)警指標(biāo)統(tǒng)計(jì)接口

參數(shù)字段參數(shù)類型參數(shù)說明

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

descString接口返回信息描述

resultObject接口返回結(jié)構(gòu)體

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參數(shù)為空

2數(shù)據(jù)重復(fù)

3參數(shù)類型異常

4添加失敗

5更新失敗

6刪除失敗

7API調(diào)用失敗

8其他異常信息

9非法字符

10網(wǎng)關(guān)異常

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參數(shù)為空

-1002數(shù)據(jù)重復(fù)

-1003參數(shù)類型異常

-1004非法字符

-1005其他異常信息

-1006API調(diào)用失敗

-1101網(wǎng)關(guān)異常

-1100系統(tǒng)異常

14

DB42/T1940.1—2022

附錄B

（資料性）

功能服務(wù)接口示例

B.1規(guī)劃編制項(xiàng)目進(jìn)度上報(bào)接口

表B.1給出了請(qǐng)求接口示例。

表B.1請(qǐng)求接口示例

輸入?yún)?shù)

{

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