ICS35.240.70

CCSL77

41

河南省地方標(biāo)準

DB41/T2788—2024

國土空間基礎(chǔ)信息平臺數(shù)據(jù)服務(wù)規(guī)范

2024-12-30發(fā)布2025-03-29實施

河南省市場監(jiān)督管理局發(fā)布

DB41/T2788—2024

目次

前言II

1范圍1

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

3術(shù)語和定義1

4縮略語2

5基本要求2

6服務(wù)數(shù)據(jù)內(nèi)容與交換3

7數(shù)據(jù)服務(wù)類型和要求3

8服務(wù)元數(shù)據(jù)4

9服務(wù)安全6

附錄A（規(guī)范性）狀態(tài)碼7

附錄B（規(guī)范性）MIME類型與服務(wù)請求返回格式對照表8

附錄C（規(guī)范性）REST數(shù)據(jù)服務(wù)接口9

附錄D（規(guī)范性）屬性表服務(wù)接口13

附錄E（規(guī)范性）文件服務(wù)接口16

附錄F（規(guī)范性）REST地圖服務(wù)接口19

附錄G（規(guī)范性）REST三維數(shù)據(jù)服務(wù)接口25

附錄H（規(guī)范性）數(shù)據(jù)目錄服務(wù)接口31

參考文獻33

I

DB41/T2788—2024

前言

本文件按照GB/T1.1—2020《標(biāo)準化工作導(dǎo)則第1部分：標(biāo)準化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定

起草。

請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機構(gòu)不承擔(dān)識別專利的責(zé)任。

本文件由河南省自然資源廳提出。

本文件由河南省自然資源標(biāo)準化技術(shù)委員會（HN/TC25）歸口。

本文件起草單位：河南省地理信息院、河南省測繪院、河南省地圖院、河南省遙感院、河南省自然

資源綜合保障中心。

本文件主要起草人：曹宏文、劉敏、王石巖、宋碧波、金子鑫、翟婭娟、付治河、祿二峰、孟潔、

楊進、尚永福、印青、郭秀麗、毛航、朱琳。

II

DB41/T2788—2024

國土空間基礎(chǔ)信息平臺數(shù)據(jù)服務(wù)規(guī)范

1范圍

本文件規(guī)定了國土空間基礎(chǔ)信息平臺數(shù)據(jù)服務(wù)的基本要求、服務(wù)數(shù)據(jù)內(nèi)容與交換、數(shù)據(jù)服務(wù)類型和

要求、服務(wù)元數(shù)據(jù)及服務(wù)安全。

本文件適用于國土空間基礎(chǔ)信息平臺的數(shù)據(jù)服務(wù)。

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

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

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

文件。

GB/T22239—2019信息安全技術(shù)網(wǎng)絡(luò)安全等級保護基本要求

GB/T25597—2010地理信息萬維網(wǎng)地圖服務(wù)接口

GB/T30169—2013地理信息基于網(wǎng)絡(luò)的要素服務(wù)

GB/T35273—2020信息安全技術(shù)個人信息安全規(guī)范

GB/T39477—2020信息安全技術(shù)政務(wù)信息共享數(shù)據(jù)安全技術(shù)要求

GB/T40525—2021地理信息在線共享接口規(guī)范

GB/T41479—2022信息安全技術(shù)網(wǎng)絡(luò)數(shù)據(jù)處理安全要求

CH/T9040—2023空間三維模型瓦片數(shù)據(jù)格式

DB41/T2330—2022國土空間基礎(chǔ)信息平臺數(shù)據(jù)建庫規(guī)范

3術(shù)語和定義

下列術(shù)語和定義適用于本文件。

3.1

接口

描述實體行為的命名操作集。

[來源：GB/T25597—2010，4.5]

3.2

請求

通過客戶端發(fā)出的操作的要求。

[來源：GB/T25597—2010，4.10]

3.3

響應(yīng)

由服務(wù)器返回給客戶端的操作結(jié)果。

[來源：GB/T25597—2010，4.11]

3.4

服務(wù)

1

DB41/T2788—2024

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

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

3.5

服務(wù)元數(shù)據(jù)

描述服務(wù)器上的可用的操作和地理信息的元數(shù)據(jù)。

[來源：GB/T25597—2010，4.14]

4縮略語

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

BOM：字節(jié)順序標(biāo)記（ByteOrderMark）

GeoJSON：基于JavaScript對象表示法的地理空間信息數(shù)據(jù)交換格式（GeographicJavaScript

ObjectNotation）

HTTP：超文本傳輸協(xié)議（HyperTextTransferProtocol）

HTTPS：超文本傳輸安全協(xié)議（HypertextTransferProtocolSecure）

JSON：JavaScript對象表示法（JavaScriptObjectNotation）

MIME：多用途因特網(wǎng)郵件擴充協(xié)議（MultipurposeInternetMailExtensions）

OGC：開放地理空間信息聯(lián)盟（OpenGeospatialConsortium）

REST：表述性狀態(tài)傳遞（RepresentationalStateTransfer）

URI：統(tǒng)一資源標(biāo)識符（UniformResourceIdentifier）

URL：統(tǒng)一資源定位符（UniformResourceLocator）

UTF-8：8位元通用字符集（UnicodeTransformationFormat8bit）

WFS：網(wǎng)絡(luò)要素服務(wù)（WebFeatureService）

WMS：網(wǎng)絡(luò)地圖服務(wù)（WebMapService）

WMTS：網(wǎng)絡(luò)地圖瓦片服務(wù)（WebMapTileService）

5基本要求

5.1數(shù)學(xué)基礎(chǔ)

5.1.1空間參考系

坐標(biāo)系采用2000國家大地坐標(biāo)系，高程基準采用1985國家高程基準。

5.1.2時間參考系

日期采用公歷紀元，時間采用北京時間。

5.2數(shù)據(jù)質(zhì)量

應(yīng)符合DB41/T2330—2022中對數(shù)據(jù)質(zhì)量的要求。

5.3JSON存儲

本文件中涉及的JSON格式存儲應(yīng)符合以下要求：

a)使用不包含BOM的UTF-8編碼；

b)JSON對象中名稱唯一。

2

DB41/T2788—2024

5.4接口要求

數(shù)據(jù)服務(wù)接口應(yīng)符合以下要求：

a)接口設(shè)計遵循規(guī)范性、安全性、開放性、靈活性和松耦合性原則；

b)遵循HTTP或HTTPS協(xié)議標(biāo)準；

c)通過GET或POST方法獲取數(shù)據(jù)資源；

d)接收到有效請求時，按照接口說明作出準確應(yīng)答；接收到無效請求時，須發(fā)送服務(wù)異常描述

信息。具體要求符合附錄A規(guī)定。應(yīng)答對象伴隨相應(yīng)的MIME類型，符合附錄B規(guī)定。

5.5服務(wù)職責(zé)

5.5.1數(shù)據(jù)發(fā)布單位，負責(zé)本單位數(shù)據(jù)資源的規(guī)劃、編目、發(fā)布及更新，應(yīng)保證所提供數(shù)據(jù)的正確性、

完整性等，符合數(shù)據(jù)質(zhì)量要求。

5.5.2平臺管理單位，指省、市、縣（區(qū)）自然資源部門，負責(zé)維護本級數(shù)據(jù)服務(wù)目錄，按要求審核、

管理數(shù)據(jù)資源，應(yīng)保障基于平臺的各項數(shù)據(jù)服務(wù)正常運行，滿足應(yīng)用需要。

5.5.3平臺用戶，負責(zé)根據(jù)應(yīng)用需求提出數(shù)據(jù)使用申請，并在授權(quán)范圍內(nèi)規(guī)范調(diào)用數(shù)據(jù)服務(wù)。

6服務(wù)數(shù)據(jù)內(nèi)容與交換

6.1數(shù)據(jù)內(nèi)容

包括國土空間現(xiàn)狀數(shù)據(jù)、規(guī)劃管控數(shù)據(jù)、業(yè)務(wù)管理數(shù)據(jù)、社會經(jīng)濟數(shù)據(jù)四類數(shù)據(jù)。

6.2服務(wù)交換

6.2.1數(shù)據(jù)發(fā)布

數(shù)據(jù)發(fā)布單位登錄平臺，按照服務(wù)注冊要求填報信息。

平臺管理單位對注冊完成的服務(wù)進行審核，審核通過后發(fā)布服務(wù)接口，并實現(xiàn)代理運行。

6.2.2接口申請

平臺用戶通過數(shù)據(jù)目錄、分類檢索和接口搜索等功能，查找獲得服務(wù)接口注冊信息。

平臺用戶對資源進行申請，填寫申請部門、申請時間、截止時間、調(diào)用頻率、用途說明等相

關(guān)信息。

6.2.3接口授權(quán)

平臺管理單位按照審批流程對接口申請進行審核并授權(quán)。

6.2.4接口調(diào)用

平臺用戶對授權(quán)后的服務(wù)接口進行調(diào)用。

7數(shù)據(jù)服務(wù)類型和要求

7.1要素服務(wù)

7.1.1網(wǎng)絡(luò)要素服務(wù)（WFS）

3

DB41/T2788—2024

按照GB/T30169—2013規(guī)定執(zhí)行。

7.1.2REST數(shù)據(jù)服務(wù)

根據(jù)功能提供數(shù)據(jù)服務(wù)的圖層元數(shù)據(jù)訪問接口和數(shù)據(jù)查詢接口。REST數(shù)據(jù)服務(wù)相關(guān)接口應(yīng)符合附

錄C的規(guī)定。

7.2屬性表服務(wù)

根據(jù)功能提供屬性表服務(wù)的元數(shù)據(jù)訪問接口和屬性查詢接口。屬性表服務(wù)相關(guān)接口應(yīng)符合附錄D

的規(guī)定。

7.3文件服務(wù)

根據(jù)功能提供文件服務(wù)的元數(shù)據(jù)訪問接口和文件下載接口。文件服務(wù)相關(guān)接口應(yīng)符合附錄E的規(guī)定。

7.4地圖服務(wù)

7.4.1網(wǎng)絡(luò)地圖服務(wù)（WMS）

按照GB/T25597—2010規(guī)定執(zhí)行。

7.4.2網(wǎng)絡(luò)地圖瓦片服務(wù)（WMTS）

按照GB/T40525—2021規(guī)定執(zhí)行。

7.4.3REST地圖服務(wù)

根據(jù)功能提供地圖服務(wù)的元數(shù)據(jù)訪問接口、地圖瓦片接口和地圖查詢接口。REST地圖服務(wù)相關(guān)接

口應(yīng)符合附錄F的規(guī)定。

7.5三維數(shù)據(jù)服務(wù)

7.5.1三維瓦片數(shù)據(jù)服務(wù)（3DTiles）

參照OGC22—025r4規(guī)定執(zhí)行。

7.5.2REST三維數(shù)據(jù)服務(wù)

根據(jù)功能提供三維數(shù)據(jù)服務(wù)的元數(shù)據(jù)訪問接口、三維圖層元數(shù)據(jù)接口、三維圖層配置文件接口和三

維瓦片接口。REST三維數(shù)據(jù)服務(wù)相關(guān)接口應(yīng)符合附錄G的規(guī)定。

7.6數(shù)據(jù)目錄服務(wù)

根據(jù)功能提供數(shù)據(jù)目錄服務(wù)接口。數(shù)據(jù)目錄服務(wù)接口應(yīng)符合附錄H的規(guī)定。

8服務(wù)元數(shù)據(jù)

要素服務(wù)、地圖服務(wù)、三維數(shù)據(jù)服務(wù)等地理空間類數(shù)據(jù)服務(wù)的元數(shù)據(jù)應(yīng)包含但不限于以下信息，具

體見表1。

4

DB41/T2788—2024

表1服務(wù)元數(shù)據(jù)信息

類別字段名稱是否必填說明

服務(wù)名稱是服務(wù)資源的名稱

服務(wù)目錄是服務(wù)分級目錄信息，說明服務(wù)的分類

服務(wù)簡介是服務(wù)內(nèi)容的概要描述

服務(wù)地址是服務(wù)接口的訪問地址（URL）

圖層名稱是服務(wù)中圖層的名稱

服務(wù)標(biāo)識

對包含圖層內(nèi)容的概要描述，若圖層數(shù)量較多，僅描

圖層簡介是

述核心圖層

行政區(qū)劃是所屬行政區(qū)劃的名稱

發(fā)布版本是服務(wù)發(fā)布的時間版本

關(guān)鍵詞否服務(wù)的關(guān)鍵詞

服務(wù)類型是服務(wù)的類型，如地圖服務(wù)、要素服務(wù)等

服務(wù)分類

接口類型是服務(wù)接口的類型，如WMS130、WFS100等

范圍描述否說明數(shù)據(jù)服務(wù)覆蓋的空間范圍

坐標(biāo)系是坐標(biāo)系編碼

西南角點經(jīng)度是服務(wù)覆蓋范圍西南角點的經(jīng)度

西南角點緯度是服務(wù)覆蓋范圍西南角點的緯度

地理空間

東北角點經(jīng)度是服務(wù)覆蓋范圍東北角點的經(jīng)度

東北角點緯度是服務(wù)覆蓋范圍東北角點的緯度

中心點經(jīng)度是服務(wù)覆蓋范圍中心點經(jīng)度

中心點緯度是服務(wù)覆蓋范圍中心點緯度

注冊時間是服務(wù)發(fā)布時間

數(shù)據(jù)時間是數(shù)據(jù)生產(chǎn)時間

時間信息

更新時間否數(shù)據(jù)更新時間

更新周期否數(shù)據(jù)更新周期，一般按年、月、日計

來源單位是數(shù)據(jù)的來源單位

管理單位是數(shù)據(jù)服務(wù)管理單位

管理單位聯(lián)系人是管理單位具體聯(lián)系人姓名

管理單位

聯(lián)系地址否管理單位地址

聯(lián)系電話否管理單位聯(lián)系人電話

電子郵箱否管理單位聯(lián)系人電子郵箱

對服務(wù)接口所在運行環(huán)境信息的必要描述，如服務(wù)

運維信息運行維護信息是器、網(wǎng)絡(luò)設(shè)備、存儲設(shè)備、安全系統(tǒng)、數(shù)據(jù)庫及在線服

務(wù)軟件、是否具備不間斷電源等信息

5

DB41/T2788—2024

9服務(wù)安全

服務(wù)安全應(yīng)符合GB/T22239—2019、GB/T35273—2020、GB/T39477—2020、GB/T41479—2022

等相關(guān)要求。

6

DB41/T2788—2024

附錄A

（規(guī)范性）

狀態(tài)碼

采用的狀態(tài)碼及其含義應(yīng)符合HTTP及HTTPS協(xié)議規(guī)定，具體狀態(tài)碼及說明按表A.1的規(guī)定。

表A.1狀態(tài)碼及說明

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

請求執(zhí)行成功200表示服務(wù)器成功執(zhí)行客戶端的HTTP請求

表示被請求的資源有一系列可供選擇的回饋信息，每個均有自己特定

被請求的資源有可供選擇的

300的地址和瀏覽器驅(qū)動的商議信息。用戶或瀏覽器能夠自行選擇一個首選

回饋信息

的地址進行重定向

表示客戶端響應(yīng)沒有被修改，因此客戶端可以繼續(xù)使用相同的緩存版

客戶端響應(yīng)未被修改304

本的響應(yīng)

請求參數(shù)不合法400表示客戶端的請求參數(shù)不合法或沒有表達足夠的信息

表示請求需要用戶認證信息?？蛻舳丝梢允褂煤线m的Authorization

請求需用戶認證信息401

頭域重復(fù)請求

表示未經(jīng)授權(quán)的請求，客戶端沒有內(nèi)容的訪問權(quán)限。與401不同，客

未經(jīng)授權(quán)的請求403

戶端的身份為服務(wù)器所知

請求的數(shù)據(jù)資源不存在404表示客戶端請求的數(shù)據(jù)資源不存在，即URI無效

數(shù)據(jù)資源不支持該操作405表示客戶端請求的數(shù)據(jù)資源不支持該方法

數(shù)據(jù)資源不支持請求的表述

406表示數(shù)據(jù)資源不支持客戶端的請求內(nèi)容的表述格式

格式

服務(wù)器端發(fā)生非預(yù)期情況導(dǎo)表示服務(wù)器端發(fā)生非預(yù)期情況，如服務(wù)器代碼執(zhí)行過程中遇到了異常

500

致請求沒有完成或崩潰，導(dǎo)致請求沒有完成

網(wǎng)關(guān)或者代理服務(wù)器從上游表示作為網(wǎng)關(guān)或者代理工作的服務(wù)器嘗試執(zhí)行請求時，從上游服務(wù)器

502

服務(wù)器接收到無效響應(yīng)接收到無效的響應(yīng)

表示由于臨時的服務(wù)器維護或者過載，造成服務(wù)器當(dāng)前無法處理請求。

該狀況是臨時的，并將在一段時間后恢復(fù)。如果能夠預(yù)計延遲時間，響

服務(wù)器當(dāng)前無法處理請求503

應(yīng)中將包含Retry-After頭用以標(biāo)明延遲時間；如果沒有給出Retry-A

fter信息，客戶端會以處理500響應(yīng)的方式處理

網(wǎng)關(guān)或者代理服務(wù)器未能及表示作為網(wǎng)關(guān)或者代理工作的服務(wù)器嘗試執(zhí)行請求時，未能及時從上

504

時從上游服務(wù)器收到響應(yīng)游服務(wù)器或者輔助服務(wù)器收到響應(yīng)

7

DB41/T2788—2024

附錄B

（規(guī)范性）

MIME類型與服務(wù)請求返回格式對照表

MIME類型與服務(wù)請求返回格式對應(yīng)關(guān)系按表B.1的規(guī)定。

表B.1MIME類型與服務(wù)請求返回格式對照表

MIME類型表述格式

application/jsonJSON

application/xmlXML

image/pngPNG

image/jpegJPEG

image/webpWEBP

image/tiffTIFF

application/octet-streamB3DM/I3DM/PNTS/VCTR/CMPT/GLTF/SLPK/M3D/BIN/GLB/GLBX等

application/s3mbS3MB

8

DB41/T2788—2024

附錄C

（規(guī)范性）

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

C.1圖層元數(shù)據(jù)訪問接口

C.1.1功能說明

用于獲取REST數(shù)據(jù)服務(wù)的圖層描述信息。

C.1.2請求格式

請求格式說明參見表C.1。

表C.1圖層元數(shù)據(jù)訪問接口請求格式說明

描述項說明

接口名稱圖層元數(shù)據(jù)訪問接口

接口描述獲取REST數(shù)據(jù)服務(wù)元數(shù)據(jù)信息

http://{ip}:{port}/iserver/services/data-{workspacename}/rest/data/datasources

接口調(diào)用示例

/{datasourcename}/datasets/{datasetname}.json

接口類型GET請求

參數(shù)傳遞方式path、body

請求MIME類型application/json

服務(wù)請求返回格式JSON

C.1.3請求參數(shù)

無。

C.1.4響應(yīng)結(jié)果

響應(yīng)結(jié)果參數(shù)說明見表C.2。

表C.2圖層元數(shù)據(jù)訪問接口響應(yīng)結(jié)果參數(shù)說明

參數(shù)名稱類型說明

nameString數(shù)據(jù)集名稱，數(shù)據(jù)集的唯一標(biāo)識，不區(qū)分大小寫

descriptionString數(shù)據(jù)集的描述信息

數(shù)據(jù)集類型，包括屬性表數(shù)據(jù)集、點數(shù)據(jù)集、線數(shù)據(jù)集、面數(shù)據(jù)集、文本

typeString數(shù)據(jù)集、復(fù)合數(shù)據(jù)集（CAD數(shù)據(jù)集）等矢量數(shù)據(jù)集,以及影像數(shù)據(jù)集、網(wǎng)絡(luò)數(shù)

據(jù)集等

數(shù)據(jù)集范圍，為矢量數(shù)據(jù)集中所有對象的最小外接矩形；或柵格數(shù)據(jù)集所

boundsArray

對應(yīng)格網(wǎng)或影像的地理范圍

dataSourceNameString數(shù)據(jù)集對象所屬的數(shù)據(jù)源名稱

9

DB41/T2788—2024

表C.2圖層元數(shù)據(jù)訪問接口響應(yīng)結(jié)果參數(shù)說明（續(xù)）

參數(shù)名稱類型說明

encodeTypeString數(shù)據(jù)集存儲時的壓縮編碼方式

isReadOnlyBoolean數(shù)據(jù)集是否為只讀

tableNameString表名

charsetString矢量數(shù)據(jù)集的字符集

isFileCacheBoolean是否使用文件形式的緩存；僅對數(shù)據(jù)庫型數(shù)據(jù)源中的矢量數(shù)據(jù)集有效

recordCountInt矢量數(shù)據(jù)集中的記錄條數(shù)

blockSizeInt按像素分塊存儲，每一塊的大??；僅對影像數(shù)據(jù)集或柵格數(shù)據(jù)集有效

heightInt數(shù)據(jù)的高度；僅對影像數(shù)據(jù)集或柵格數(shù)據(jù)集有效

widthInt數(shù)據(jù)的寬度；僅對影像數(shù)據(jù)集或柵格數(shù)據(jù)集有效

pixelFormatString數(shù)據(jù)存儲的像素格式；僅對影像數(shù)據(jù)集或柵格數(shù)據(jù)集有效

isMultiBandBoolean是否為多波段影像數(shù)據(jù)集；僅對影像數(shù)據(jù)集有效

C.2數(shù)據(jù)查詢接口

C.2.1功能說明

根據(jù)給定的參數(shù)，創(chuàng)建一個數(shù)據(jù)查詢結(jié)果資源。

C.2.2請求格式

請求格式說明參見表C.3。

表C.3數(shù)據(jù)查詢接口請求格式說明

描述項說明

接口名稱數(shù)據(jù)查詢接口

接口描述根據(jù)給定的參數(shù)，基于REST數(shù)據(jù)服務(wù)獲取查詢結(jié)果

http://{ip}:{port}/iserver/services/data-{workspacename}/rest/data/featureR

接口調(diào)用示例

esults.json

接口類型POST請求

參數(shù)傳遞方式path、body

請求MIME類型application/json

服務(wù)請求返回格式JSON

C.2.3請求參數(shù)

C.2.3.1數(shù)據(jù)查詢接口URI中請求參數(shù)說明見表C.4。

10

DB41/T2788—2024

表C.4數(shù)據(jù)查詢接口URI請求參數(shù)說明

參數(shù)名稱類型是否必填說明

true表示直接返回查詢結(jié)果，即元素類型為Feature的

returnContentBoolean否數(shù)組；false表示返回創(chuàng)建的featureResult資源的URI。

默認為false

fromIndexInt否查詢結(jié)果的最小索引號。默認值為0

查詢結(jié)果的最大索引號。如果該值大于查詢結(jié)果的最大索

toIndexInt否

引號，則以查詢結(jié)果的最大索引號為終止索引號

returnDatasetInfoOnlyBoolean否是否僅返回要素的數(shù)據(jù)集信息。默認為false

returnFeaturesOnlyBoolean否是否僅返回要素信息。默認為false

returnCountOnlyBoolean否是否僅返回查詢結(jié)果的要素數(shù)量。默認為false

C.2.3.2數(shù)據(jù)查詢接口請求體中參數(shù)說明見表C.5。

表C.5數(shù)據(jù)查詢接口請求體參數(shù)說明

參數(shù)名稱類型是否必填說明

數(shù)據(jù)查詢的模式。包括ID、SQL、BOUNDS、BOUNDS_ATTRIBUTEFI

getFeatureModeString是LTER、BUFFER、BUFFER_ATTRIBUTEFILTER、SPATIAL、SPATIAL_AT

TRIBUTEFILTER等

數(shù)據(jù)集名稱數(shù)組，數(shù)據(jù)集名稱由數(shù)據(jù)源名和數(shù)據(jù)集名構(gòu)成

datasetNamesString是

（datasourceName:datasetName）

要獲取的資源的ID數(shù)組。當(dāng)getFeatureMode為ID時，此參數(shù)

idsInt否

必選

范圍查詢時需要設(shè)置矩形坐標(biāo)范圍。當(dāng)getFeatureMode為BOUN

boundsArray否

DS、BOUNDS_ATTRIBUTEFILTER時，此參數(shù)必選

幾何對象。當(dāng)getFeatureMode為BUFFER、BUFFER_ATTRIBUTEFI

geometryObject否

LTER、SPATIAL、SPATIAL_ATTRIBUTEFILTER時，此參數(shù)必選

緩沖區(qū)半徑，參數(shù)單位和數(shù)據(jù)集的坐標(biāo)單位一致。當(dāng)getFeatur

bufferDistanceDouble否

eMode為BUFFER、BUFFER_ATTRIBUTEFILTER時，此參數(shù)必選

屬性查詢過濾器。當(dāng)getFeatureMode為BUFFER_ATTRIBUTEFILT

attributeFilterString否ER、SPATIAL_ATTRIBUTEFILTER、BOUNDS_ATTRIBUTEFILTER時，此

參數(shù)必選

空間查詢模式。當(dāng)getFeatureMode為SPATIAL、SPATIAL_ATTRI

spatialQueryModeString否

BUTEFILTER時，此參數(shù)必選

SQL查詢時用于設(shè)置服務(wù)端返回查詢結(jié)果條目的數(shù)量，默認為

1000。當(dāng)該值大于fromIndex與toIndex區(qū)間內(nèi)查詢結(jié)果的個數(shù)，

maxFeaturesInt否則返回索引區(qū)間內(nèi)所有結(jié)果；當(dāng)該值小于等于fromIndex與toInd

ex區(qū)間內(nèi)查詢結(jié)果的個數(shù)，則返回索引區(qū)間內(nèi)從fromIndex起，

指定數(shù)量的結(jié)果

queryParameterObject否查詢參數(shù)。當(dāng)getFeatureMode為SQL時，此參數(shù)必選

動態(tài)投影的目標(biāo)坐標(biāo)系。當(dāng)該參數(shù)不同于數(shù)據(jù)原坐標(biāo)系統(tǒng)時，將

targetPrjObject否

進行動態(tài)投影，并返回動態(tài)投影后的查詢結(jié)果

11

DB41/T2788—2024

表C.5數(shù)據(jù)查詢接口請求體參數(shù)說明（續(xù)）

參數(shù)名稱類型是否必填說明

動態(tài)投影的目標(biāo)坐標(biāo)系對應(yīng)的EPSGCode。使用時需在請求URI

targetEpsgCodeInt否中添加returnContent參數(shù)，并設(shè)值為true。targetEpsgCode和

targetPr均都設(shè)置時，以targetEpsgCode為準

是否返回空間幾何對象信息,默認為true。當(dāng)getFeatureMode

hasGeometryBoolean否

不為ID且URI參數(shù)returnContent為true時，此參數(shù)有效

C.2.4響應(yīng)結(jié)果

C.2.4.1默認響應(yīng)結(jié)果參數(shù)說明見表C.6。

表C.6數(shù)據(jù)查詢接口默認響應(yīng)結(jié)果參數(shù)說明

參數(shù)名稱類型說明

succeedBoolean數(shù)據(jù)查詢是否成功

newResourceIDString創(chuàng)建的featureResult資源的ID

newResourceLocationString創(chuàng)建的featureResult資源的URI

C.2.4.2如果URI參數(shù)returnContent為true，則響應(yīng)結(jié)果參數(shù)說明見表C.7。

表C.7數(shù)據(jù)查詢接口returnContent結(jié)果參數(shù)說明

參數(shù)名稱類型說明

featureCountInt返回的要素數(shù)量

featuresString返回的要素列表。單個要素的結(jié)構(gòu)見表C.8

totalCountInt要素總個數(shù)

featureUriListString返回的要素子資源地址

datasetInfosString返回的數(shù)據(jù)集信息

C.2.4.3Feature結(jié)構(gòu)說明見表C.8。

表C.8Feature結(jié)構(gòu)說明

參數(shù)名稱類型說明

IDInt要素的ID

fieldNamesString要素的屬性字段名集合

fieldValuesString要素的屬性字段值集合

要素對應(yīng)的幾何對象。當(dāng)hasGeometry為false時，返回的

geometryGeometry

geometry值為null

12

DB41/T2788—2024

附錄D

（規(guī)范性）

屬性表服務(wù)接口

D.1元數(shù)據(jù)訪問接口

D.1.1功能說明

用于獲取屬性表服務(wù)的描述信息。

D.1.2請求格式

請求格式說明參見表D.1。

表D.1元數(shù)據(jù)訪問接口請求格式說明

描述項說明

接口名稱屬性表服務(wù)的元數(shù)據(jù)訪問接口

接口描述獲取屬性表服務(wù)的元數(shù)據(jù)信息

接口調(diào)用示例http://{ip}:{port}/dfc/services/sgssfs/{datasetid}.json?request=getCapaBilities

接口類型GET請求

參數(shù)傳遞方式path

請求MIME類型application/json

服務(wù)請求返回格式JSON

D.1.3請求參數(shù)

URI中請求參數(shù)說明見表D.2。

表D.2元數(shù)據(jù)訪問接口請求參數(shù)說明

參數(shù)名稱類型是否必填說明

requestString否請求操作類型。默認為getCapaBilities

versionString否版本號，默認為1.1.0

D.1.4響應(yīng)結(jié)果

D.1.4.1響應(yīng)結(jié)果參數(shù)說明見表D.3。

表D.3元數(shù)據(jù)訪問接口響應(yīng)結(jié)果說明

參數(shù)名稱類型說明

successBoolean請求是否成功

messageString失敗時的消息

dataDCDatasetInfo目錄列表信息，見表D.4

13

DB41/T2788—2024

D.1.4.2DCDatasetInfo對象結(jié)構(gòu)說明見表D.4。

表D.4DCDatasetInfo對象結(jié)構(gòu)說明

參數(shù)名稱類型說明

datasetIdString數(shù)據(jù)集id

dataSourceIdInt數(shù)據(jù)源id

datasetNameString數(shù)據(jù)集的名稱

datasetTypeInt數(shù)據(jù)集的類型

datasetAliasString數(shù)據(jù)集的別名

recordCountInt屬性表中記錄的條數(shù)

tableNameString屬性表的表名

datasetDbTypeInt數(shù)據(jù)集類別，包括0-現(xiàn)狀和1-歷史

currentDatasetIdString現(xiàn)狀數(shù)據(jù)集的id

datasetVersionString數(shù)據(jù)集的版本號

sequenceStartDate有效的開始時間

sequenceEndDate有效的結(jié)束時間

datasetHisList<DCDatasetInfo>元數(shù)據(jù)歷史列表

hisVersionCountInt歷史版本的個數(shù)

D.2屬性查詢接口

D.2.1功能說明

根據(jù)給定的參數(shù)，獲取指定的要素記錄。

D.2.2請求格式

請求格式說明參見表D.5。

表D.5屬性表查詢接口請求格式說明

描述項說明

接口名稱屬性查詢接口

接口描述根據(jù)給定的參數(shù)，獲取屬性查詢結(jié)果

接口調(diào)用示例http://{ip}:{port}/dfc/services/sgssfs/{datasetid}.json?request=getFeature

接口類型POST請求

參數(shù)傳遞方式body

請求MIME類型application/json

服務(wù)請求返回格式JSON

D.2.3請求參數(shù)

14

DB41/T2788—2024

請求體中請求參數(shù)說明見表D.6。

表D.6屬性表查詢接口請求體參數(shù)說明

參數(shù)名稱類型是否必填說明

requestString否請求類型

filterString否查詢過濾條件

pageInt否分頁的頁碼數(shù)

pageNumInt否分頁的個數(shù)

versionString否版本號，默認為1.1.0

D.2.4響應(yīng)結(jié)果

響應(yīng)結(jié)果參數(shù)說明見表D.7。

表D.7屬性表查詢接口響應(yīng)結(jié)果參數(shù)說明

參數(shù)名稱類型說明

pageInt分頁的頁碼數(shù)

pageNumInt分頁的個數(shù)

totalInt滿足條件的記錄個數(shù)

queryString查詢參數(shù)

rowsList<Object>符合條件的屬性列表記錄

dataTypeInt數(shù)據(jù)類型

errorInfoString異常信息