DB44∕T 2649-2025 实景三维广东在线服务接口规范

ICS35.080

CCSL70

44

广东省地方标准

DB44/T2649—2025

实景三维广东在线服务接口规范

3Drealsceneguangdongonlineserviceinterfacespecification

2025-04-11发布2025-07-11实施

广东省市场监督管理局发布

DB44/T2649—2025

目次

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

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

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

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

4缩略语.............................................................................2

5基本规定...........................................................................2

6数据服务接口.......................................................................3

7访问控制...........................................................................5

附录A（规范性）矢量瓦片服务接口参数与示例...........................................7

附录B（规范性）影像动态服务接口参数与示例..........................................11

附录C（规范性）三维地形服务接口参数与示例..........................................13

附录D（规范性）三维模型服务接口参数与示例..........................................16

参考文献.............................................................................17

I

DB44/T2649—2025

前言

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

起草。

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

本文件由广东省自然资源厅提出并组织实施。

本文件由广东省地理信息标准化技术委员会（GD/TC117）归口。

本文件起草单位：广东省国土资源技术中心、中山市自然资源信息中心、广州市城市规划勘测设计

研究院有限公司、北京吉威数源信息技术有限公司。

本文件主要起草人：吴锦超、俞建、周国新、陈鑫祥、冷海芹、刘洋、胡应龙、刘阳、谭耀华、梁

飞龙、曹坤杰、陈聪、王璇、邓广然、唐巍、魏然。

II

DB44/T2649—2025

实景三维广东在线服务接口规范

1范围

本文件规定了矢量瓦片服务、影像动态服务、三维地形服务和三维模型服务的基本规定、数据服务

接口、访问控制等技术要求。

本文件适用于实景三维广东在线服务共享发布和访问，可为二次开发提供参考。

2规范性引用文件

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

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

文件。

CH/T9028—2018地理信息公共服务平台网络地理信息服务分类与命名规范

DB44/T2214—2019地理信息公共服务平台服务接口规范

IETFRFC3986：2005统一资源标识符(URI)：通用语法[UniformResourceIdentifier(URI):Generic

Syntax]

3术语和定义

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

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

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

地理场景geo-sence

一定区域范围内连续成片、反映现实世界地理空间位置和形态的地理信息数据。

地理实体geo-entity

现实世界中占据一定且连续空间位置和范围、单独具有同一属性或完整功能的地理对象。

基础地理实体fundamentalgeo-entity

通过基础测绘采集和表达的地理实体，是其他地理实体和相关信息的定位框架与承载基础。

Mesh三维模型mesh3Dmodel

利用点云、影像等数据源制作的可量测的、具备几何形态和表面纹理信息的连续三角网格模型。

地质体geologicalbody

通常是指地壳内占有一定的空间和有其固有成分并可以与周围物质相区别的地质作用的产物。

1

DB44/T2649—2025

4缩略语

下列缩略语适用于本文件。

API：应用编程接口（ApplicationProgrammingInterface）

DEM：数字高程模型（DigitalElevationModel）

DOM：数字正射影像（DigitalOrthophotoMap）

TDOM：真正射影像（TrueDigitalOrthophotoMap）

DSM：数字表面模型（DigitalSurfaceModel）

W3TS：三维模型服务（Web3DTileService）

WMS：网络地图服务（WebMapService）

WMTS：网络地图瓦片服务（WebMapTileService）

WVTS：矢量瓦片服务（WebVectorTileService）

WIMS：影像动态服务（WebImageMapService）

WTTS：三维地形服务（WebTerrainTileService）

JSON：JavaScript对象表示法（JavascriptObjectNotation）

HTTP：超文本传输协议（HypertextTransferProtocol）

HTTPS：超文本传输安全协议（HypertextTransferProtocolSecure）

KVP：键值对(Key-ValuePair)

REST：表述性状态传递（RepresentationalStateTransfer）

URI：统一资源标识符（UniformResourceIdentifier）

URL：统一资源定位符（UniformResourceLocator）

PNG：便携式网络图形（PortableNetworkGraphics）

5基本规定

实景三维数据范围

实景三维数据主要指基础地理实体数据和地理场景数据。基础地理实体数据包括地形级和城市级

基础地理实体数据、城市三维模型数据等；地理场景数据包括DOM、DEM、DSM、Mesh三维模型等。

实景三维数据服务类型

按照CH/T9028-2018的网络地理信息服务分类，实景三维数据在线服务接口按照服务类型，主要包

括WMS、WMTS、WVTS、WIMS、WTTS、W3TS等，见表1。

表1服务类型说明表

中文名称英文名称英文简称说明

遵循DB44/T2214—2019的动态地图服务规范。支持基

网络地图服务WebMapServiceWMS

础地理实体、数字正射影像等数据的共享服务。

遵循DB44/T2214—2019的瓦片地图服务规范。支持基

网络地图瓦片服务WebMapTileServiceWMTS

础地理实体、数字正射影像等瓦片数据的共享服务。

以矢量瓦片的形式提供矢量数据地图服务，支持自定义

矢量瓦片服务WebVectorTileServiceWVTS地图样式、要素拾取、要素查询、服务浏览等能力。支

持基础地理实体数据的共享服务。

2

DB44/T2649—2025

表1服务类型说明表（续）

中文名称英文名称英文简称说明

以免切片的形式提供影像地图服务，支持渲染参数配

影像动态服务WebImageMapServiceWIMS置、波段组织等，符合DB44/T2214—2019的瓦片地图

服务规范。支持数字正射影像的共享服务。

以瓦片形式提供表征地表高程变化信息的服务。支持数

三维地形服务WebTerrainTileServiceWTTS

字高程模型和数字表面模型的共享服务。

以瓦片形式提供三维模型数据的服务。支持Mesh三维模

三维模型服务Web3DTileServiceW3TS

型、城市三维模型等数据的共享服务。

6数据服务接口

数据要求

6.1.1请求协议

遵循HTTP或HTTPS协议标准。

6.1.2请求操作

通过GET或POST方法请求。

6.1.3状态码

本规范采用的状态码及其含义应符合HTTP及HTTPS协议规定，涉及的主要状态码如表2所示，其他

状态码可参考IETFRFC2616中6.1.1章节的规范定义。

表2状态码值说明表

状态码值描述

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

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

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

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

403表示未经授权的请求，客户端没有内容的访问权限。与401不同，客户端的身份为服务器所知。

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

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

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

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

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

服务接口访问方式

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

RFC3986的规定。URI格式为：{BaseURL}/Services/{ServiceIdentifier}，{BaseURL}为相对服务基地址的

相对路径，{ServiceIdentifier}为自定义的服务标识符，应唯一标识实景三维数据服务。

服务接口说明

3

DB44/T2649—2025

6.3.1矢量瓦片服务

矢量瓦片服务（WVTS）是支持配置动态渲染样式的矢量数据在线地图服务，具备对矢量数据查询、

浏览、要素显隐、要素高亮、分析等能力，符合DB44/T2214—2019的瓦片地图服务规范，基本接口如

表3所示。服务接口参数和示例见附录A。

表3矢量瓦片服务接口表

接口名称功能描述URL

底图瓦片接口：根据请求，将对应地图的瓦

GetMAPvmap/{ServiceName}/getMAP

片数据返回给用户终端的服务

底图数据接口：根据请求，将对应地图的底

GetDatadata/{ServiceName}/getData

图数据返回给用户终端的服务

注记数据接口：根据请求，将对应地图的注

GetImglabel/{ServiceName}/getImg

记数据返回给用户终端的服务

注记瓦片接口：根据请求，将对应地图的注

GetDataslabel/{ServiceName}/getDatas

记瓦片返回给用户终端的服务

元数据信息接口：查询指定服务、指定图层

GetInfo{ServiceName}/{LayerName}/getInfo.json

的原始数据(区别于切片数据)的元数据信息

要素拾取接口：依据前端请求输入地图层级

Pickup{ServiceName}/{StyleId}/pickup

和经纬度，提供图元要素的在线拾取功能

图例接口：获取指定服务、样式、层级的图

GetLegendstyleInfo/{ServiceName}/{StyleId}/{Level}/legend.json

例信息

GetStyle服务样式接口：获取指定服务样式json信息styleInfo/{ServiceName}/{StyleId}/style.json

6.3.2影像动态服务

影像动态服务（WIMS）是渲染样式动态可配置的影像数据在线地图服务，具备像元值查询、波段

组合、影像压盖顺序调整等能力，符合DB44/T2214—2019的瓦片地图服务规范，基本接口如表4所示。

服务接口参数和示例见附录B。

表4影像动态服务接口表

接口名称功能描述URL

元数据接口：获取服务实现规范描述自身能力的元

GetCapabilities/{ServiceName}/dtile/map/info

数据文档

影像图片导出接口：根据请求范围以及渲染参数导

Export/{ServiceName}/dtile/map/export

出影像数据的实时渲染结果

GetTileXYZXYZ形式获取瓦片接口：通过xyz形式获取瓦片/{ServiceName}/dtile/map/data

获取瓦片接口：根据请求范围以及渲染参数导出影

GetTileKVP像数据的实时渲染结果并实时切片，将瓦片数据返/{ServiceName}/dtile

回给用户，瓦片大小256*256像素。

6.3.3三维地形服务

4

DB44/T2649—2025

三维地形服务（WTTS）以瓦片形式提供表征地表高程变化信息的服务。通过DEM数据按照指定的

金字塔规则进行重采样，生成地形数据瓦片，提供三维地形分析能力，基本接口如表5所示。服务接口

参数和示例见附录C。

表5三维地形服务接口表

接口名称功能描述URL

元数据接口：获取服务实现规范描述自身能力的元数

GetCapabilities/{ServiceName}/terrain

据文档

行列号获取瓦片接口：根据行列号及级别相应获取瓦

GetTerrain/{ServiceName}/terrain/data

片

获取高程、坡度、坡向接口：获取坐标点的高程、坡

GetHeight/{ServiceName}/terrain/height

度、坡向

统计矩形范围的最大高程、最小高程、平均高程接

StatisticAna/{ServiceName}/terrain/statistic

口：统计矩形范围的最大高程、最小高程、平均高程

生成坡度、坡向分析图接口：对划定区域生成坡度、

SlopeAna/{ServiceName}/terrain/analyst

坡向分析图

6.3.4三维模型服务

三维模型服务（W3TS）以瓦片形式提供地质体、白模、倾斜摄影模型、三维精细模型等三维模型

数据的服务，瓦片格式采用开源标准的3DTiles格式，基本接口如表6所示。服务接口参数和示例见附录

D。

表6三维模型服务接口表

接口名称功能描述URL

GetTileset获取3DTiles瓦片数据集基本信息/{ServiceName}/3dtiles/tileset.json

7访问控制

实景三维数据在线访问应采取用户身份鉴别、数据安全等级标记、数据授权、强制访问控制等措施，

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

对实景三维数据的访问和破坏。具体措施如下：

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

户身份；

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

篡改；

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

权用户的访问；

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

e)授权管理：应建立数据授权管理机制，确保仅授权的用户能使用实景三维数据和服务，避免数

据被非法访问或滥用；

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

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

5

DB44/T2649—2025

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

威胁。

6

DB44/T2649—2025

A

A

附录A

（规范性）

矢量瓦片服务接口参数与示例

A.1底图瓦片接口

根据应用终端发送的http或https协议请求，将对应地图的瓦片数据返回给用户终端的服务，其中返

回的地图瓦片数据是被分割成相同大小如256*256或512*512像素的正方形栅格图片,具体参数和示例见

表A.1。

表A.1底图瓦片接口表

接口

GetMAPURLvmap/{ServiceName}/getMAP

名称

参数名描述是否必要默认值

ServiceName服务名称，如矢量电子地图服务名称为vmap是无

StyleId矢量瓦片电子地图样式id，可以为同一个服务提供多个样式是无

参Tilerow瓦片行号是无

数Tilecol瓦片列号是无

说Tilelevel瓦片层级是无

明Tilesize瓦片大小256/512像素，默认为256像素否256

Ratio是否高清，其中：0为非高清版本，1为高清版本，默认为0。否0

Control图层、要素的过滤、高亮设置否无

Mask要素裁剪设置否无

返回

png

说明

URLhttp://localhost:8091/mapserver/vmap/XZQ_DSJ/getMAP?Tilerow=213&Tilecol=42&Tilelevel=9&StyleId=ws&Rati

示例o=0&Tilesize=512

A.2底图数据接口

底图数据接口根据应用终端发送的http或https协议请求，将对应地图的底图数据返回给用户终端的

服务；支持256像素和512像素的标准格网请求。具体参数和示例见表A.2。

表A.2底图数据接口表

接口

GetDataURLdata/{ServiceName}/getData

名称

参数名描述是否必要默认值

参ServiceName服务名称，如矢量电子地图服务名称为vmap是无

数StyleId矢量瓦片电子地图样式id，可以为同一个服务提供多个样式是无

说Tilerow瓦片行号是无

明Tilecol瓦片列号是无

Tilelevel瓦片层级是无

7

DB44/T2649—2025

表A.2底图数据接口表（续）

参数Tilesize瓦片大小256/512像素，默认为256像素否256

说明Ratio是否高清，其中：0为非高清版本，1为高清版本，默认为0否0

返回

json

说明

URLhttp://localhost:8091/mapserver/data/XZQ_DSJ/getData?Tilerow=213&Tilecol=42&Tilelevel=9&StyleId=ws&Ratio=

示例

0&Tilesize=512

A.3注记数据接口

注记数据接口根据应用终端发送的http或https协议请求，将对应地图的注记数据返回给用户终端的

服务；支持256像素和512像素的标准格网请求。具体参数和示例见表A.4。

表A.3注记数据接口表

接口

GetDatasURLlabel/{ServiceName}/getDatas

名称

参数名描述是否必要默认值

ServiceName服务名称，如矢量电子地图服务名称为vmap是无

参

StyleId矢量瓦片电子地图样式id，可以为同一个服务提供多个样式是无

数

Tilerow瓦片行号是无

说

Tilecol瓦片列号是无

明

Tilelevel瓦片层级是无

Tilesize瓦片大小256/512像素，默认为256像素否无

返回

json

说明

URL

http://localhost:8091/mapserver/label/SYJCDLST20230107/getDatas?Tilerow=109528&Tilecol=21831&Tilelevel=18

示例

A.4注记瓦片接口

注记瓦片接口根据应用终端发送的http或https协议请求，将对应地图的注记瓦片返回给用户终端的

服务；支持256像素和512像素的标准格网请求。具体参数和示例见表A.3。

表A.4注记瓦片接口表

接口

GetImgURLlabel/{ServiceName}/getImg

名称

参数名描述是否必要默认值

参ServiceName服务名称，如矢量电子地图服务名称为vmap是无

数StyleId矢量瓦片电子地图样式id，可以为同一个服务提供多个样式是无

说Tilerow瓦片行号是无

明Tilecol瓦片列号是无

Tilelevel瓦片层级是无

8

DB44/T2649—2025

表A.4注记瓦片接口表（续）

参数名描述是否必要默认值

参

Tilesize瓦片大小256/512像素，默认为256像素否256

数

Ratio是否高清，其中：1为非高清版本，2为高清版本，默认为1否1

说

Control图层、要素的过滤、无注记高亮设置否无

明

Mask按给定wkt范围裁剪注记并给剪半注记添加边框设置否无

返回

png

说明

URLhttp://localhost:8091/mapserver/label/SYJCDLST20230107/getImg?Tilerow=109528&Tilecol=21831&Tilelevel=18&

示例StyleId=SYJCDLST20230107&Ratio=1&Tilesize=512

A.5元数据接口

元数据接口获取指定的服务、图层的原始数据的元数据信息。具体参数和示例见表A.5。

表A.5元数据接口表

接口

GetInfoURL{ServiceName}/{LayerName}/getInfo.json

名称

参参数名描述是否必要默认值

数ServiceName服务名称，如矢量电子地图服务名称为vmap是无

说LayerName图层id是无

明Tilelevel瓦片层级否无

返回

json

说明

URL

http://localhost:8091/mapserver/SYJCDLST20230107/GQHA20230107/18/getInfo.json

示例

A.6要素拾取接口

要素拾取接口依据前端请求输入地图层级和经纬度，提供图元要素的在线拾取功能。具体参数和示

例见表A.6。

表A.6要素拾取接口表

接口

PickUpURL{ServiceName}/{StyleId}/pickup

名称

参数名描述是否必要默认值

ServiceName服务名称，如矢量电子地图服务名称为vmap是无

参StyleId矢量瓦片电子地图样式id，可以为同一个服务提供多个样式是无

数Maplevel地图层级是无

说Longitude经度是无

明Latitude纬度是无

Includelabel是否包含注记true/false默认为false否false

Control图层、要素的过滤、高亮设置否无

9

DB44/T2649—2025

表A.6要素拾取接口表（续）

返回

json

说明

URLhttp://localhost:8091/mapserver/SYJCDLST20230107/SYJCDLST20230107/pickup?Maplevel=18&Longitude=120.8

示例30&Latitude=30.038

A.7图例接口

图例接口获取指定服务、样式、层级的图例信息。具体参数和示例见表A.7。

表A.7图例接口表

接口

GetLegendURLstyleInfo/{ServiceName}/{StyleId}/{Tilelevel}/legend.json

名称

参参数名描述是否必要默认值

数ServiceName服务名称，如矢量电子地图服务名称为vmap是无

说StyleId矢量瓦片电子地图样式id，可以为同一个服务提供多个样式是无

明Tilelevel瓦片层级否无

返回

json

说明

URL

http://localhost:8091/mapserver/styleInfo/SYJCDLST20230107/SYJCDLST20230107/18/legend.json

示例

A.8服务样式接口

服务样式接口是获取指定服务的样式信息。具体参数和示例见表A.8。

表A.8服务样式接口表

接口

GetStyleURLstyleInfo/{ServiceName}/{StyleId}/style.json

名称

参参数名描述是否必要默认值

数ServiceName服务名称，如矢量电子地图服务名称为vmap是无

说

StyleId矢量瓦片电子地图样式id，可以为同一个服务提供多个样式是无

明

返回

json

说明

URL

http://localhost:8091/mapserver/styleInfo/SYJCDLST20230107/SYJCDLST20230107/style.json

示例

10

DB44/T2649—2025

B

B

附录B

（规范性）

影像动态服务接口参数与示例

B.1元数据接口

元数据接口获取指定的服务、图层的原始数据的元数据信息。具体参数和示例见表B.1。

表B.1元数据接口表

接口

GetinfoURL/{serviceName}/dtile/map/info

名称

参参数名描述是否必要默认值

数ServiceName发布的服务名称，必须为英文是无

说Format结果返回格式，json或xml否json

明Callbackformat为json时，指定callback返回jsonp否无

返回

json、xml

说明

URL

http://localhost:8084/ime-cloud/rest/GDEMV2_30M/dtile/map/info

示例

B.2影像图片导出接口

影像图片导出接口是获取影像动态服务指定地理范围、影像图片宽度、影像图片高度的图片。具体

参数和示例见表B.2。

表B.2影像图片导出接口表

接口

ExportURL/{ServiceName}/dtile/map/export

名称

参数名描述是否必要默认值

参

ServiceName发布的服务名称，必须为英文是无

数

Bbox地图导出地理范围，格式xmin,ymin,xmax,ymax是无

说

Width地图导出宽度是无

明

Height地图导出高度是无

返回

jpg、png

说明

URLhttp://localhost:8084/ime-

示例cloud/rest/GDEMV2_30M/dtile/map/export?Bbox=109.3277,28.1677,111.7776,29.7704&Width=800&Height=600

B.3XYZ形式获取瓦片接口

XYZ形式获取瓦片接口是获取指定服务、行列号、级别且默认瓦片大小为256像素的瓦片。具体参数

和示例见表B.3。

11

DB44/T2649—2025

表B.3XYZ获取瓦片接口表

接口

GetTileXYZURL/{ServiceName}/dtile/map/data

名称

参数名描述是否必要默认值

参ServiceName发布的服务名称，必须为英文是无

数Tilelevel瓦片级别是无

说Tilerow瓦片行号是无

明Tilecol瓦片列号是无

Tilesize生成瓦片大小，默认256像素否256

返回

jpg、png

说明

URL

http://localhost:8084/ime-cloud/rest/GDEMV2_30M/dtile/map/data?Tilelevel=11&Tilerow=349&Tilecol=1638

示例

B.4获取瓦片接口

获取瓦片接口是获取指定服务、瓦片数据集、行列号、级别的瓦片。具体参数和示例见表B.4。

表B.4获取瓦片接口表

接口

GetTileKVPURL/{ServiceName}/dtile

名称

参数名描述是否必要默认值

ServiceName发布的服务名称，必须为英文是无

Request固定为GetTile是无

参Service固定为wmts是无

数TilematrixSet瓦片数据集名称否无

说Tilelevel瓦片级别是无

明Tilerow瓦片行号是无

Tilecol瓦片列号是