ICS07.040

A75

DB4403

深圳市地方標準

DB4403/T91—2020

地理空間信息服務接口規范

Specificationforgeospatialinformationinterfaceservice

2020-09-29發布2020-11-01實施

深圳市市場監督管理局發布

DB4403/91—2020

地理空間信息服務接口規范

1范圍

本規范規定了深圳市地理空間信息服務分類、服務接口基本規定、服務接口要求等。

本規范適用于深圳市地理空間信息服務資源獲取、分發、二次開發以及服務擴展與維護等。

2規范性引用文件

下列文件對于本文件的應用是必不可少的。凡是注日期的引用文件，僅注日期的版本適用于本文件。

凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。

GB/T30169地理信息基于網絡的要素服務

GB/T35652瓦片地圖服務

OGC04-094WebFeatureServiceImplementationSpecification

OGC06-042WebMapServiceImplementationSpecification

OGC07-057r7OpenGISWebMapTileServiceImplementationStandard

3術語和定義

下列術語和定義適用于本標準。

3.1

地理空間信息geospatialinformation

直接或間接與地球位置相關聯的現象的有關信息。

3.2

坐標coordinate

用來指示N維空間中點的位置的數值序列。

3.3

坐標參考系統coordinatereferencesystem

通過基準與顯示世界相關的坐標系。

3.4

要素feature

1

DB4403/T91—2020

代表物理實體的，具有幾何形狀的地圖元素。

3.5

瓦片tile

地圖數據根據一定規則切分為的若干數據單元。

3.6

地理編碼geocoding

地址匹配address-matching

采用標準化的編碼格式表示的地表、地下或者空中的地理空間點在特定時間的確切位置的測量信

息。可理解為建立地理位置坐標與給定地址一致性的過程，即指在地圖上找到并標明每條地址所對應

的位置。

3.7

接口interface

兩個功能單元共享的邊界，由各種特征來定義。

3.8

服務service

由實體通過接口提供的明確功能。

3.9

空間分析spatialanalysis

基于地理對象的位置和形態特征的數據分析技術，其目的在于提取和傳輸空間信息。

3.10

緩沖區分析bufferanalysis

對選中的一組或一類地圖要素（點、線或面）按設定的距離條件，圍繞其要素而形成一定緩沖區多

邊形實體，從而實現數據在二維空間得以擴展的信息分析方法。

3.11

疊加分析overlayanalysis

將兩層或多層地圖要素進行疊加產生一個新要素層的操作，其結果將原來要素分割生成新的要

素，新要素綜合了原來兩層或多層要素所具有的屬性，并形成新的空間關系和新的屬性關系。

3.12

2

DB4403/91—2020

地名geographicalnames

用于表征具體地理實體的專用名稱。

示例：洞、公路、河流、湖、潭、環島、紀念地、建筑物、交通場站、街巷、開發區、名勝古跡、橋梁、泉、山峰、

山脈、水庫、水渠、隧道、體育設施、鐵路、政區、住宅區、自然村等。

3.13

地址address

對某一特定空間位置上自然或人文地理實體位置名稱的結構化描述。

示例：深圳市福田區紅荔路8009號。

3.14

標準地址standardaddress

符合特定地址標準、按照指定規則進行描述的地址，包含行政區劃信息、村區信息、街路巷、小

區信息、建筑物及單元、樓層、戶室等信息。

3.15

數據集dataset

同一類要素數據組成的集合。

4縮略語

API：應用程序編程接口(ApplicationProgrammingInterface)

B3DM：批處理三維模型(Batched3DModel)

JSON：JavaScript對象簡譜(JavaScriptObjectNotation)

PNG：便攜式網絡圖形(PortableNetworkGraphicFormat)

OGC：開放地理空間信息聯盟(OpenGeospatialConsortium)

WFS：網絡要素服務(WebFeatureService)

WMS：網絡地圖服務(WebMapService)

WMTS：網絡地圖切片服務(WebMapTileService)

SLPK：場景圖層包(SceneLayerPackage)

S3M：空間三維模型(Spatial3DModel)

URL：統一資源定位符（UniformResourceLocator）

XML：可擴展標記語言（eXtensibleMarkupLanguage）

5服務分類

3

DB4403/T91—2020

按照服務的性質將地理空間信息服務劃分為數據服務和功能服務。數據服務通過相應API接口對外

提供，按實現技術上劃分為地圖數據API、專題數據API、三維數據API；功能服務劃分為空間分析API、

地址匹配API、場景圖層API、建筑信息查詢API。

服務分類見表1。

表1服務類目表

一級類目二級類目三級類目服務提供方式

地圖服務WMS

網絡地圖API（WebMapService）

按7.1.1的要求

地圖數據API

地圖切片服務WMTS

網絡地圖切片API（WebMapTileService）

按7.1.2的要求

數據服務網絡要素服務WFS

專題數據API網絡要素API（WebFeatureService）

按7.2的要求

三維元數據服務

三維元數據API

按7.3.1的要求

三維數據API

三維瓦片數據服務

三維瓦片數據API

按7.3.2的要求

緩沖區分析服務

緩沖區分析API

按7.4.1的要求

空間分析API

疊加分析服務

疊加分析API

按7.4.2的要求

地址正向匹配服務

地址正向匹配API

按7.5.1的要求

功能服務地址匹配API

地址逆向匹配服務

地址逆向匹配API

按7.5.2的要求

場景圖層目錄服務

場景圖層API場景圖層API

按7.6的要求

建筑信息查詢

建筑信息查詢API建筑信息查詢API

按7.7的要求

6接口基本規定

6.1請求協議

4

DB4403/91—2020

采用HTTP或HTTPS協議。

請求方式為GET或POST請求。

6.2交換格式

交換格式如表2所示。

表2交換格式

名稱說明

JSON空間分析API、地名地址API等采用此交換格式。

XMLWMS、WMTS、WFS等服務的元數據訪問接口返回此交換格式。

PNGWMS、WMTS等服務的地圖瓦片訪問接口返回此交換格式

B3DM三維數據服務(3DTiles)訪問接口返回此交換格式。

SLPK三維數據服務(I3S)訪問接口返回此交換格式。

S3MB三維數據服務(S3M)訪問接口返回此交換格式。

7服務接口要求

7.1地圖數據API

7.1.1網絡地圖API

網絡地圖API接口應符合OGC06-042要求。

7.1.2網絡地圖切片API

網絡地圖切片API接口應符合OGC07-057r7和GB/T35652要求。

7.2專題數據API

網絡要素API接口應符合OGC04-094和GB/T30169要求。

7.3三維數據API

7.3.1三維元數據API

三維元數據API可根據三維場景、圖層名稱、服務類型(其中服務類型包含3DTiles，I3S，S3M

等類型)查詢圖層元數據和配置等信息。

該接口通過GET方式請求場景名稱、圖層名稱和服務類型，服務接口返回接口訪問狀態、訪問說

明和服務地址等信息。請求參數及返回結果應遵照附錄A中A.1的要求。

7.3.2三維瓦片數據API

三維瓦片數據API可根據三維場景名稱、圖層名稱、服務類型、文件路徑得到對應的三維瓦片數

據文件信息，返回客戶端對應的服務文件。

5

DB4403/T91—2020

該接口通過GET方式請求，請求場景名稱、圖層名稱、服務類型、文件路徑，返回對應的文件

(B3DM，SLPK，S3MB等)。請求參數應遵照附錄A中A.2的要求。

7.4空間分析API

7.4.1緩沖區分析API

該服務提供緩沖區分析功能。緩沖區分析功能，支持用戶根據指定的距離，在點、線、面幾何對

象周圍自動建立一定寬度的區域。

該接口支持對指定的某個幾何對象做緩沖區分析，通過設置緩沖區半徑等參數，形成緩沖區面。

該接口通過POST方式請求分析對象坐標串、緩沖區半徑、單位等，服務接口返回接口訪問狀態、訪問

說明和結果集，結果集中包含分析結果。請求參數和返回結果應遵照附錄A中A.3的要求。

7.4.2疊加分析API

該服務提供疊加分析功能。疊加分析功能，支持用戶對點、線、面類型數據集進行集合運算，如

裁剪、合并、擦除、求交、同一、對稱差、更新等。

該接口支持對指定的某兩個幾何對象做疊加分析，通過參數設置可以指定要做疊加分析的幾何對

象、疊加操作類型。該接口通過POST方式請求疊加的幾何對象和疊加類型等，服務接口返回接口訪問

狀態、訪問說明、空間參考系統和結果集，結果集中包含分析結果。請求參數和返回結果應遵照附錄A

中A.4的要求。

7.5地名地址API

7.5.1地址正向匹配API

該接口支持將結構化地址(省/市/區/街道/門牌號)解析為對應的位置坐標同時也支持模糊的查詢

方式。該接口通過POST方式請求待匹配的地址等信息，服務接口返回接口訪問狀態、訪問說明、狀態

碼和結果集，結果集中包含匹配坐標、匹配度、地址空間面信息、匹配層級等信息。請求參數和返回結

果應遵照附錄A中A.5的要求。

7.5.2地址逆向匹配API

該接口支持將位置坐標解析成對應的地址信息。該接口通過POST方式請求待匹配的坐標和返回記

錄條數，服務接口返回接口訪問狀態、訪問說明和結果集，結果集中包含匹配地址和匹配度。請求參

數和返回結果應遵照附錄A中A.6的要求。

7.6場景圖層API

該接口支持通過圖層的分組和場景類型過濾出應用場景所需要的圖層目錄樹。該接口通過GET或

POST方式請求場景類型等信息，返回接口訪問狀態、訪問說明、狀態碼和結果集，結果集包含編碼、

所屬父編碼、圖層名稱、圖層別名、服務地址、空間參考系統、服務類型等信息。請求參數和返回結果

應遵照附錄A中A.7的要求。

6

DB4403/91—2020

7.7建筑信息查詢API

該接口支持通過地理位置(經緯度)和模型屬性查詢。該接口通過GET或POST方式請求緯度值、經度

值等信息，返回接口訪問狀態、訪問說明、狀態碼和結果集，結果集中包含模型編碼、模型名稱、所屬

區域、模型地址、狀態、模型高度等信息。請求參數和返回結果應遵照附錄A中A.8的要求。

7

DB4403/T91—2020

附錄A

（規范性附錄）

服務接口規范

A.1三維元數據API參數

A.1.1請求參數

請求參數如表A.1。

表A.1三維元數據API請求參數

請求參數是否必須類型參數說明

sceneName是String場景名稱

layerName是String圖層名稱

serviceType是String服務類型(3DTiles、I3S、S3M等)

token否String認證token

A.1.2返回結果

返回結果參數如表A.2。

表A.2三維元數據API返回參數

返回參數類型參數說明

msgString訪問說明，請求結果描述

codeInt狀態碼，請求結果編碼，0表示成功，其它數字為錯誤編碼

successBoolen訪問狀態，請求是否成功

srsString坐標參考系統

dataUrlString服務地址

extendString用戶擴展信息

A.2三維瓦片數據API參數

A.2.1請求參數

請求參數如表A.3。

表A.3三維瓦片數據API請求參數

請求參數是否必須類型參數說明

sceneName是String場景名稱

layerName是String圖層名稱

serviceType是String服務類型

8

DB4403/91—2020

表A.3（續）

請求參數是否必須類型參數說明

path是String文件路徑(B3DM、SLPK、S3M等)

token否String認證token

A.2.2返回結果

返回結果為三維瓦片數據。

A.3緩沖區分析API參數

A.3.1請求參數

請求參數如表A.4。

表A.4緩沖區分析API請求參數

請求參數是否必須類型參數說明

endType否String緩沖區端點枚舉值默認值：FLAT

可選值：FLAT、ROUND

leftDistance否Float左側緩沖距離，默認值：100

rightDistance否Float右側緩沖距離，默認值：100

semicircleLineSegment否Int圓頭緩沖圓弧處線段的個數。默認值：4

radiusUnit否String緩沖半徑單位，默認值：METER

可選值：CENTIMETER，DECIMETER，KILOMETER，

METER

sourceGeometry是Array<Object>分析對象坐標串

token否String認證token

A.3.2返回結果

返回結果參數如表A.5。

表A.5緩沖區分析API返回參數

返回參數類型參數說明

msgString訪問說明，請求結果描述

codeInt狀態碼，請求結果編碼，0表示成功，其它數字為錯誤編碼

successBoolen訪問狀態，請求是否成功

srsString坐標參考系統

listsArray<Object>結果集，參數詳見表A.6

A.3.3lists參數

lists參數如表A.6。

9

DB4403/T91—2020

表A.6lists參數樣例

返回參數類型參數說明

latFloat緯度值

lngFloat經度值

extendString用戶擴展信息

A.4疊加分析API參數

A.4.1請求參數

請求參數如表A.7。

表A.7疊加分析API請求參數

請求參數是否必須類型參數說明

operateGeometry是String疊加分析的操作幾何對象，分析對象坐標

串

sourceGeometry是Array<Object>疊加分析的源幾何對象，分析對象坐標串

operateGeometries否Array<operateGeometry>批量疊加分析的操作幾何對象數組

sourceGeometries否Array<sourceGeometry>批量疊加分析的源幾何對象數組

operation否String疊加操作枚舉值，可選值為：

CLIP，ERASE，INDENTITY，INTERSECT，

UNION，UPDATE，XOR

token否String認證token

A.4.2返回結果

返回結果參數如表A.8。

表A.8疊加分析API返回參數

返回參數類型參數說明

msgString訪問說明，請求結果描述

codeInt狀態碼，請求結果編碼，0表示成功，其它數字為錯誤編碼

successBoolen訪問狀態，請求是否成功

srsString坐標參考系統

listsArray<Object>結果集，參數詳見表A.9

A.4.3lists參數

lists參數如表A.9。

表A.9lists參數樣例

返回參數類型參數說明

fieldNamesFloat字段名

10

DB4403/91—2020

表A.9（續）

返回參數類型參數說明

fieldValuesArray<String>字段值，順序與fieldNames一致

pointsString幾何體點串

extendString用戶擴展信息

A.5地址正向匹配API參數

A.5.1請求參數

請求參數如表A.10。

表A.10地址正向匹配API請求參數

請求參數是否必須類型參數說明

token是String認證token

addr是String待匹配的地址

page否Int結果分頁參數，分頁頁碼，默認值：1

limit否Int結果分頁參數，每頁結果數，默認值：10

fuzzy否Boolen是否模糊匹配，false精確匹配，要求待匹配地址每個字都出

現在結果中，true模糊匹配，不要求待匹配地址每個字都出

現在結果中。和equal參數不可同時使用

equal否Boolen是否完全匹配，false不要求完全匹配，true要求完全匹配。

如果為true，只會返回與地址完全一致的結果。和fuzzy參

數不可同時使用

where否Array<Object>自定義查詢條件參數

A.5.2返回結果

返回結果參數如表A.11。

表A.11地址正向匹配API返回參數樣例

返回參數類型參數說明

msgString訪問說明，請求結果描述

codeInt狀態碼，請求結果編碼，0表示成功，其它數字為錯誤編碼

successBoolen訪問狀態，請求是否成功

dataJsonObject返回的結果數據

countInt搜索結果總數

addrListArray<Object>結果列表

codeString結果地址對應的標準地址編碼

addrString結果地址

lvInt地址層級(1.省2.市3.區4.街道5.社區6.道路7.門牌8.小

區9.樓棟10.單元11.房間)

scoreFloat匹配度，分值越大，服務對地址理解程度越高

11

DB4403/T91—2020

表A.11（續）

返回參數類型參數說明

srsString坐標參考系統

locgeojson匹配坐標

shapegeojson地址空間面信息

provinceString省

cityString市

districtString區

streetString街道

communityString社區

roadString道路

road_numString門牌

villageString小區

buildingString樓棟

building_numString單元

house_numString房間

room_floorInt房間所屬樓層

extendString用戶擴展信息

A.6地址逆向匹配API參數

A.6.1請求參數

請求參數如表A.12。

表A.12逆向匹配API請求參數

請求參數是否必須類型參數說明

token是String認證token

lat是Float緯度值

lng是Float經度值

top否Int返回結果條數，按匹配度排序前多

少條進行返回，默認值：1

A.6.2返回結果

返回結果參數如表A.13。

表A.13逆向匹配API返回參數

返回參數類型參數說明

msgString訪問說明，請求結果描述

codeInt狀態碼，請求結果編碼，0表示成功，其它數字為錯誤編碼

successBoolen訪問狀態，請求是否成功

listsArray<Object>結果集，參數詳見表A.14

12

DB4403/91—2020

A.6.3lists參數

lists參數如表A.14。

表A.14lists參數樣例

返回參數類型參數說明

addressString匹配地址

scoreFloat匹配度，分值越大，服務對地址理解程

度越高

A.7場景圖層API參數

A.7.1請求參數

請求參數如表A.15。

表A.15場景圖層API請求參數

請求參數是否必須類型參數說明

groupType是Int分組類型

sceneType是String場景類型(2D，3D，地下空間等)

token否String認證token

A.7.2返回結果

返回結果參數如表A.16。

表A.16場景圖層API返回參數

返回參數類型參數說明

msgString訪問說明，請求結果描述

codeInt狀態碼，請求結果編碼，0表示成功，其它數字為錯誤編碼

successBoolen訪問狀態，請求是否成功

dataArray<Object>返回的結果數據，參數詳見表A.17

A.7.3data參數

data參數如表A.17。

表A.17data參數樣例

返回參數類型參數說明

idInt編碼

parentIdInt所屬父編碼

nameString圖層名稱

aliasNameString圖層別名

targetUrlString服務地址

srsString空間參考系統

13

DB4403/T91—2020