DB3713∕T 340-2024 实景三维数据接口及服务发布技术规范

ICS07.040

CCSA75

3713

临沂市地方标准

DB3713/T340—2024

实景三维数据接口及服务发布技术规范

Specificationfordatainterfaceandservicepublishingtechnologyof3Drealscene

文稿版次选择

2024-09-25发布2024-10-25实施

临沂市市场监督管理局发布

DB3713/T340—2024

目次

前言................................................................................II

1范围..............................................................................1

2规范性引用文件....................................................................1

3术语和定义........................................................................1

4一般规定..........................................................................1

4.1数据范围......................................................................1

4.2标准条件......................................................................1

5实景三维数据服务框架..............................................................3

5.1服务框架内容..................................................................3

5.2浏览功能说明..................................................................3

6实景三维数据服务接口..............................................................4

6.1服务接口URI格式..............................................................4

6.2服务接口GET请求参数..........................................................4

6.3多类型数据访问方式............................................................5

6.4服务接口请求响应..............................................................6

7实景三维数据服务发布..............................................................6

7.1发布流程......................................................................6

7.2轻量化处理....................................................................6

7.3服务发布......................................................................7

8服务部署和安全访问................................................................7

8.1实景三维数据服务部署要求......................................................7

8.2实景三维数据安全访问要求......................................................7

附录A（资料性）实景三维数据服务请求方式说明........................................9

附录B（资料性）实景三维数据服务接口示例...........................................11

I

DB3713/T340—2024

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定

起草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由临沂市自然资源和规划局提出、归口并组织实施。

II

DB3713/T340—2024

实景三维数据接口及服务发布技术规范

1范围

本文件规定了实景三维数据服务接口、服务发布、服务部署和安全访问的规定和基本要求，并提供

了数据服务框架的内容和服务接口示例。

本文件适用于桌面端、Web端、移动端等系统通过实景三维数据服务接口获取和使用实景三维数据。

2规范性引用文件

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

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

文件。

GB/T35634公共服务电子地图瓦片数据规范

IETFRFC2616超文本传输协议--HTTP/1.1（HypertextTransferProtocol--HTTP/1.1）

IETFRFC3986统一资源标识符：通用语法（UniformResourceIdentifier(URI):GenericSyntax）

IETFRFC7159JSON数据交换格式（TheJavaScriptObjectNotation(JSON)DataInterchange

Format）

3术语和定义

下列术语和定义适用于本文件。

3.1

轻量化lightweightprocessing

对实景三维数据进行多细节层次构建、几何结构概化等处理的过程。

3.2

实景三维数据服务接口3Drealscenedataserviceinterface

具备实景三维数据访问能力的应用编程接口。

4一般规定

4.1数据范围

本文件涉及的实景三维数据，包括地理实体数据和地理场景数据。其中，地理实体数据包括基础地

理实体和部件级地理实体等；地理场景数据包括数字正射影像（DOM）、真正射影像（TDOM）、数字高

程模型（DEM）、数字表面模型（DSM）、Mesh三维模型、点云数据等。

4.2标准条件

1

DB3713/T340—2024

4.2.1接口说明

本文件在严格遵循开放地理空间信息联盟（OGC）标准的基础上，对地理实体数据服务（WGES）类

型、三维数据服务（W3TS）类型、矢量瓦片数据服务（WVTS）类型进行了扩充。通过扩展实景三维数据

服务接口，实现了对多种类型实景三维数据的在线访问，扩充的服务类型说明见附录A中表A.3。

4.2.2请求参数描述

请求参数的描述及规定见表1。

表1请求参数中的符号含义

符号含义

[]代表可选参数，出现0或1次

{}代表可选参数，出现0或多次

<>代表必选参数

4.2.3服务请求返回格式

采用的服务请求返回格式见表2。

表2服务请求返回格式

名称说明

JSON接口描述等采用此返回格式

XML适用于WMS、WMTS等服务的元数据访问接口

PNG/JPG适用于WMS、WMTS等服务类型

MVT/PNG/JPEG/TIFF/

适用于矢量瓦片数据服务类型

NETCDF/GeoJSON

BIL/TERRAIN适用于三维地形瓦片数据服务类型

B3DM/I3DM/PNTS/VCTR/CMPT适用于三维数据服务类型(3DTiles)

S3M适用于三维数据服务类型(S3M)

SLPK适用于三维数据服务类型(I3S)

GLTF适用于三维模型数据服务类型

4.2.4数据类型

数据类型应符合IETFRFC7159的规定。

4.2.5接口返回内容的表述格式

实景三维数据服务接口的MIME类型与服务请求返回格式对照表见表3。

2

DB3713/T340—2024

表3服务请求返回内容的表述格式与MIME类型对应关系

MIME类型表述格式

APPLICATION/JSONJSON/MCJ

APPLICATION/XMLXML

IMAGE/PNGPNG

IMAGE/JPGJPG

IMAGE/JPEGJPEG

IMAGE/WEBPWEBP

IMAGE/TIFFTIFF

IMAGE/VND-MSDDS

IMAGE/KTXKTX

APPLICATION/MVTMVT

APPLICATION/X-PROTOBUFPBF

APPLICATION/OCTET-STREAMB3DM/I3DM/PNTS/VCTR/CMPT/SLPK/GLTF/M3D

APPLICATION/OCTET-STREAMBIN/DRACO

APPLICATION/OCTET-STREAMBIN/GLB/GLBX

APPLICATION/S3MBS3MB

5实景三维数据服务框架

5.1服务框架内容

服务框架内容包含数据资源目录、地理场景数据浏览功能、地理实体数据浏览功能、物联感知数据

浏览功能、实景三维数据产品浏览功能。

5.2浏览功能说明

5.2.1地理场景数据浏览功能

提供数字正射影像（DOM）、真正射影像（TDOM）、数字高程模型（DEM）、数字表面模型（DSM）、

Mesh三维模型、点云数据等地理场景数据的在线浏览和集成展现能力。

5.2.2地理实体数据浏览功能

地理实体数据浏览功能应包含以下内容：

a)地理实体标识展示:以完整的空间范围或代替标签对地理实体进行展示；

b)地理实体属性浏览:提供地理实体、部件三维模型以及其他实体在内的地理实体的基本属性信

息查询和展现能力；

c)地理实体关系浏览:提供地理实体空间关系、类属关系、时间关联关系和几何构成关系的在线

浏览和关联查询能力。具体描述如下:

1)空间关系浏览：在浏览地理实体本身信息的同时，可关联浏览与其具有相邻、相交、相等、

包含、重叠关系的地理实体数据，并可参数化设置容限值、空间关系类型等过滤条件；

2)关系属性浏览：通过地理实体的空间身份编码或其他关联字段，可关联浏览与其存在等级

关系、依赖关系、等同关系的地理实体，并可参数化设置地理实体空间范围等过滤条件，

3

DB3713/T340—2024

支持按照可视范围动态加载不同精度层级的地理实体数据，以实现轻量化浏览，提高浏览

性能；

3)时间关联关系浏览：通过地理实体的时间关联字段，可关联浏览与其具有时间演变关系的

地理实体，并可参数化设置地理实体时间范围、空间范围等过滤条件；

4)几何构成关系浏览：通过地理实体的空间身份编码可关联浏览该地理实体不同形态的几何

信息，并可实现地理实体不同形态几何信息的动态切换。

5.2.3物联感知数据浏览功能

提供物联感知数据的在线检索、与地理实体关联查询以及物联感知数据可视化呈现能力。

5.2.4实景三维数据产品浏览功能

根据空间范围或类别、粒度、模态和属性结构等，抽取相关的地理实体及地理场景数据进行适配组

装，形成实景三维数据产品，为其提供在线浏览能力。

6实景三维数据服务接口

6.1服务接口URI格式

实景三维数据服务接口的URI由网络协议名称、主机地址、端口、路径、参数等构成，并符合IETFRFC

3986的规定，其表述格式应为基于服务基地址{BaseURL}的相对路径，ServiceIdentifier为自定义的服

务标识符，应唯一表达实景三维数据服务。示例如下：{BaseURL}/Services/{ServiceIdentifier}

6.2服务接口GET请求参数

接口执行GET请求，返回对应的查询结果，主要参数结构见表4。

表4接口GET请求参数结构

是否

参数名参数含义类型示例备注

必选

SERVICE服务类型StringWVTSO—

REQUEST请求名称StringGetCapabilitiesM参照表A.2

OUTPUTFORMAT返回数据类型StringJsonOJson或Xml

VERSION请求版本号String1.0.0O—

LAYER图层名StringJzw_fwCWMTS适用

MODELTYPE模型类型StringS3M/3DTiles/I3SCW3TS适用

ROOTTILE三维瓦片根节点StringTile_-7404_21605_0000CW3TS适用

Tile_-7404_21605_0000_0001

TILEDATA三维瓦片子节点StringCW3TS适用

_0000

BBOX边界框StringBBOX=minx,miny,maxx,maxyCWMS适用

WGES、W3TS

ClASID地理实体分类代码String11010000C

等适用

MA1001NE104I3401411110XXXX

ENTITYID地理实体标识码StringCWGES适用

XXXXXX230101010003

点图元、线图元、面图元、体

PRIMITIVENAME实体图元名称StringCWGES适用

图元

4

DB3713/T340—2024

表4接口GET请求参数结构（续）

是否

参数名参数含义类型示例备注

必选

EntityRelation：基于地理实

体标识码的关联实体请求

SpatialRelation：基于空间关

SEARCHTYPE查询类型StringCWGES适用

系的关联实体请求

TimeRelation：基于时间关联

关系的关联实体请求

1：相邻2：相交3：相等4：

RELATIONTYPE关系查询类型IntCWGES适用

包含5：重叠

为空时表示关联字段为地理实

RELATIONFIELD实体关联字段StringCWGES适用

体空间身份编码

ENTITYTIME获取数据的时间点Date2021/12/1CWGES适用

点查询、线查询、面查询、体

GEOMETRY查询几何StringOWGES适用

查询

geometry空间查询的空间关拓扑关系、相邻关系、度量关

SPATIALRELStringOWGES适用

系类型系

请求结果返回的实体属性字

OUTFIELDSArrayAllOWGES适用

段，为空时默认返回全部字段

FILTER属性查询条件StringOrOWGES适用

SORTTYPE排序类型，值为asc/descStringAscOWGES适用

SORTFIELD排序字段Array1、2OWGES适用

分页起始下标查询起始记录

STARTRECORDInt1OWGES适用

位置

EXPECTCOUNT期望返回记录数Int1OWGES适用

是否返回数据总量，为空时默

SUMENTITYBooleanTRUEOWGES适用

认为false

指定要查询的图元标识，不指

LAYERIDSArrayPLOWGES适用

定的情况下，默认返回全部

PRIMITIVETYPE图元类型Array点、线、多边形、注记OWGES适用

是否包含实体分类信息，为空

ENTITYCLASSINFOBooleanTRUEOWGES适用

时默认为false

是否包含实体属性，为空时默

ENTITYPROPERTIESBooleanTRUEOWGES适用

认为false

是否包含实体字段信息，为空

ENTITYFIELDSBooleanTRUEOWGES适用

时默认为false

是否包含实体关系信息，为空

ENTITYRELATIONSBooleanTRUEOWGES适用

时默认为false

GetCapabil

SRS空间坐标参考系统StringEPSG:4527Cities中定

义SRS

注1：以上为实景三维数据服务接口的主要请求参数，对于WMS、WMTS等服务类型的其他OGC标准请求参数，本接口仍

兼容。

注2：“是否必选”属性项约束条件包括必选（M）、可选（O）和条件必选（C）。

6.3多类型数据访问方式

5

DB3713/T340—2024

对实景三维数据服务接口指定不同参数，能访问不同的服务类型，各类数据所对应的服务类型和请

求名称见表A.3。地形级、城市级及部件级的实景三维数据访问接口由若干实景三维数据服务接口聚合

而成，可根据其所含数据的数据类型和访问需求的不同指定不同参数。

6.4服务接口请求响应

接口根据不同请求名称，返回不同的请求响应结果，见表5。

表5请求名称与请求响应结果对照表

服务请求名称服务请求响应示例备注

GetCapabilities参照附录B中B.2—

GetMap—遵循OGCWMS请求规范

GetStyle参照附录B中B.3—

支持栅格瓦片、矢量瓦片、三维地形瓦片、

GetTile参照附录B中B.4

三维瓦片

GetEntity参照附录B中B.5扩充了地理实体及其关系查询

7实景三维数据服务发布

7.1发布流程

实景三维数据可以采用直接发布或采用轻量化技术处理、生成瓦片数据后发布。具体数据服务发布

流程见图1：

图1数据服务发布流程图

7.2轻量化处理

轻量化处理按照GB/T35634的规定执行。其中，地理实体数据可处理为矢量瓦片、栅格瓦片、三维

瓦片；DOM、TDOM、DEM、DSM等数据可处理为栅格瓦片；Mesh三维模型可处理为三维瓦片。具体宜符合

以下要求：

6

DB3713/T340—2024

a)地理实体到矢量瓦片的轻量化处理，宜包括数据分层、网格划分、对象简化、属性编码、瓦片

压缩等；

b)地理实体到栅格瓦片的轻量化处理，宜包括数据分层、网格划分、对象简化、矢量对象栅格化、

瓦片压缩等；

c)DOM、TDOM、DEM、DSM到栅格瓦片的轻量化处理，宜包括数据分层、网格划分、金字塔计算、

算法拉伸、数据压缩等；

d)地理实体、Mesh三维模型到三维瓦片的轻量化处理，宜包括空间索引构建、几何结构处理、

纹理贴图处理、复用处理、设置调度参数、模型压缩输出等；

e)常用实景三维数据的瓦片数据格式见表6。

表6常用实景三维数据瓦片数据格式

数据类型瓦片数据格式

DEMTERRAIN

DOMPNG或JPG

TDOMPNG或JPG

DSMPNG或JPG

Mesh三维模型S3M或3DTILES

点云数据S3M或3DTILES

二维地理实体Png或Jpg或Mvt

7.3服务发布

应依托GIS服务引擎，通过数据选择、服务类型选择、服务元数据信息填写等，进行发布。

8服务部署和安全访问

8.1实景三维数据服务部署要求

实景三维数据服务部署应遵循“分布存储、逻辑集中、互联互通”的原则，具体要求如下：

a)应按需，按照国、省、市、县分级构建；

b)应支持分布式节点部署，支持集群部署与负载均衡；

c)应支持不同层级、不同系统之间实景三维数据服务的共享与互操作。

8.2实景三维数据安全访问要求

实景三维数据应遵循测绘地理信息安全管控的要求，采用国家认定的地理信息保密技术进行处理后

再进行服务发布。实景三维数据在线访问应采取用户身份鉴别、数据安全等级标记、数据授权，强制访

问控制等措施，需要完整记录用户认证、数据访问和修改、数据权限更改等与数据安全相关事件，能够

阻止非授权用户对实景三维数据的访问和破坏。其中具体要求如下：

a)用户身份鉴别：应建立身份验收机制，如通过用户名密码、密钥、生物特征识别等方式确认用

户身份；

b)数据加密传输：应采用安全通信协议对数据进行加密传输，确保数据在传输过程中不被窃取或

篡改；

c)强制访问控制：应根据用户角色和权限设置访问控制策略，仅允许授权用户访问，并限制非授

权用户的访问；

7

DB3713/T340—2024

d)数据安全等级标记：应建立安全等级标记，确保数据、服务按照国家密级要求进行使用；

e)数据授权管理：应建立数据授权管理机制，确保仅授权的用户能使用、修改或分享实景三维数

据、服务，避免数据被非法访问或滥用；

f)安全审计和监控：应记录用户认证、数据访问、修改以及数据权限更改等安全相关事件，并建

立安全审计和监控机制进行实时监测和报警；

g)安全漏洞修复和更新：应及时修复和更新系统中的安全漏洞，确保系统能够及时应对新型安全

威胁。

8

DB3713/T340—2024

A

附录A

（资料性）

实景三维数据服务请求方式说明

A.1状态码说明及列表

本文件采用的状态码及其含义应符合HTTP及HTTPS协议规定，并符合IETFRFC2616规范定义，涉及

的状态码如表A.1所示。

表A.1状态码及其含义

状态码值描述

200表示服务器成功执行了客户端的HTTP请求

表示被请求的资源有一系列可供选择的回馈信息，每个都有自己特定的地址和浏览器

300

驱动的商议信息，用户或浏览器能够自行选择一个首选的地址进行重定向

304表示客户端响应没有被修改，因此客户端可以继续使用相同的缓存版本的响应

400表示客户端的请求参数不合法或没有表达足够的信息

401表示请求需要用户认证信息，客户端可以使用合适的Authorization头域重复请求

表示未经授权的请求，客户端没有内容的访问权限。与401不同，客户端的身份

403

为服务器所知

404表示客户端请求的数据资源不存在，即URI无效

405表示数据资源不支持该操作

406表示数据资源不支持客户端请求的表述格式

500表示服务器端发生非预期情况，导致请求没有完成

表示作为网关或者代理工作的服务器尝试执行请求时，从上游服务器接收到无效

502

的响应

表示由于临时的服务器维护或者过载，服务器当前无法处理请求。这个状况是临时的，

并且将在一段时间以后恢复。如果能够预计延迟时间，那么响应中可以包含一个

503

Retry-After头用以标明这个延迟时间；如果没有给出这个Retry-After信息，那么

客户端应当以处理500响应的方式处理它

表示作为网关或者代理工作的服务器尝试执行请求时，未能及时从上游服务器或

504

者辅助服务器收到响应

A.2服务请求名称说明

服务请求名称说明如表A.2所示。

9

DB3713/T340—2024

表A.2服务请求名称说明

序号服务请求名称描述

1GetCapabilities获取服务对应服务类型的元数据信息。

2GetMap根据地理空间参数和图像大小获取地图图像。

3GetEntity根据查询条件获取地理实体及其扩展的地理实体关系信息。

根据预定义请求格式获取瓦片数据，支持矢量瓦片、栅格瓦片、三维地形瓦片、三

4GetTile

维瓦片。

5GetValues根据查询条件获取DSM/DEM等图层任意坐标点的数据信息。

6GetLegendGraphic获取DSM/DEM等图层的对应图例。

7GetStyle获取矢量瓦片地图风格样式。

A.3服务类型和请求名称对照表

不同类型的实景三维数据所支持的服务类型和服务请求对照表如表A.3所示。

表A.3实景三维数据服务类型和请求名称对照表

数据类型服务类型接口请求名称

WGESGetCapabilities、GetEntity、GetRelation、GetRelationData

WMSGetCapabilities、GetMap

地理实体

—WMTSGetCapabilities、GetTile

数据

WVTSGetCapabilities、GetTile

W3TSGetCapabilities、GetTile

DOM/TDOMWMTSGetCapabilities、GetTile

WMTSGetCapabilities、GetTile、GetValues、GetLegendGraphic

DEM/DSM

地理场景WTTSGetCapabilities、GetTile

数据Mesh三维模型W3TSGetCapabilities、GetTile

点云数据W3TSGetCapabilities、GetTile

其他地理场景数据——

注：各服务请求名称的详细说明见表A.2服务请求名称说明。

10

DB3713/T340—2024

BA

附录B

（资料性）

实景三维数据服务接口示例

B.1获取实景三维数据服务目录示例

B.1.1总体说明

获取实景三维数据服务目录，返回服务标识及支持的服务类型。

B.1.2请求格式

:8090/realscene/services

B.1.3返回结果

{

"code":"SUCCESS",

"data":[

{

"identifier":"demo",

"capabilities":["WMTS","W3TS","WGES"]

},

{

"identifier":"building",

"capabilities":["WGES"]

}

],

"message":"执行成功",

"state":200,

"success":true

}

B.2获取实景三维数据服务接口元数据（GetCapabilities）示例

B.2.1获取实景三维数据服务接口元数据示例:接口不指定服务类型（SERVICE）参数，并将请求名称

（REQUEST）参数指定为GetCapabilities，返回实景三维数据服务接口所有的元数据信息。具体示例如

下：

a)请求格式：

:8090/realscene/services/demo?request=GetCapabilities&outputForma

t=json&version=1.0.0

b)请求参数说明如表B.1所示：

11

DB3713/T340—2024

表B.1获取接口描述文件服务请求参数说明

参数名参数含义类型示例是否必选

REQUEST请求类型StringGetCapabilitiesM

OUTPUTFORMAT返回数据类型Stringjson或xmlO

VERSION请求版本号String1.0.0O

注：“是否必选”属性项约束条件包括必选（M）和可选（O）。

c)返回结果

{"code":"SUCCESS",

"data":{

"mapLayers":[

{"name":"STMAP",

"alias":"背景底图",

"serviceType":"WMTS",

"boundingBox":{

"maxX":"119.2115473344",

"maxY":"36.2201656170",

"minX":"117.3952481789",

"minY":"34.3636065421"}},

{"name":"fangwu",

"alias":"房屋地图",

"serviceType":"WMS",

"SRS":"EPSG:4490,

"boundingBox":{

"maxX":"118.2115475214",

"maxY":"35.2201656170",

"minX":"118.1916475214",

"minY":"35.1537065421"}},

{"name":"JZW_LOD3",

"alias":"房屋LOD3",

"serviceType":"W3TS",

"SRS":"EPSG:4490",

"boundingBox":{

"maxX":"118.2115475214",

"maxY":"35.2201656170",

"minX":"118.1916475214",

"minY":"35.1537065421"