ICS 35.240.99 DB3708
CCS L 67
济
宁 市 地 方 标 准
DB3708/T 58—2024
三维地图平台应用接口规范
Specification for application interface of the 3D map platform
2024- 12 - 05 发布
2025 - 01 -05 实施
济宁市市场监督管理局 发 布
DB3708/T 58—2024
目
次
前言....................................................................................................................................................................... II
1 范围..................................................................................................................................................................... 1
2 规范性引用文件.................................................................................................................................................1
3 术语和定义......................................................................................................................................................... 1
4 缩略语................................................................................................................................................................. 1
5 基本规定............................................................................................................................................................. 2
6 接口服务内容..................................................................................................................................................... 2
6.1 接口服务内容分类.....................................................................................................................................2
6.2 管理类服务接口.........................................................................................................................................2
6.3 二维地图类服务接口.................................................................................................................................2
6.4 三维地图类服务接口.................................................................................................................................2
6.5 空间分析类服务接口.................................................................................................................................3
7 接口使用流程..................................................................................................................................................... 3
7.1 概述............................................................................................................................................................. 3
7.2 接口发现..................................................................................................................................................... 3
7.3 接口申请..................................................................................................................................................... 3
7.4 接口调用..................................................................................................................................................... 3
8 接口调用规范..................................................................................................................................................... 4
8.1 基本要求..................................................................................................................................................... 4
8.2 接口规范..................................................................................................................................................... 4
8.3 接口操作..................................................................................................................................................... 4
8.4 响应格式..................................................................................................................................................... 5
8.5 返回码......................................................................................................................................................... 5
9 接口安全要求..................................................................................................................................................... 5
附录 A （资料性） 三维地图平台接口服务......................................................................................................6
附录 B （资料性） 三维地图平台应用接口代码示例................................................................................... 10
参考文献............................................................................................................................................................... 19
I
DB3708/T 58—2024
前
言
本文件按照GB/T 1.1—2020《标准化工作导则
起草。
第1部分：标准化文件的结构和起草规则》的规定
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。
本文件由济宁市大数据局提出、归口并组织实施。
II
DB3708/T 58—2024
三维地图平台应用接口规范
1
范围
本文件规定了三维地图平台应用接口的服务内容、使用流程、调用规范和安全要求。
本文件适用于基于三维地图平台的接口进行应用开发。
2
规范性引用文件
下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，
仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本
文件。
3 GB/T 25530—2010 地理信息 服务
GB/T 25597—2010 地理信息 万维网地图服务接口
GB/T 22239 信息安全技术 网络安全等级保护基本要求
GB/T 22240 信息安全技术 网络安全等级保护定级指南
GB/T 39477 信息安全技术 政务信息共享 数据安全技术要求
术语和定义
下列术语和定义适用于本文件。
3.1
三维地图平台
3D map platform
面向济宁市提供统一的三维地图数据管理、展示应用、接口发布与安全访问管控的系统平台。
3.2
接口
interface
描述实体行为特征的命名操作集合。
[来源：GB/T 25530—2010,4.2]
3.3
操作
operation
对象可以被调用执行的转换和查询的规范。
[来源：GB/T 25530—2010,4.3]
3.4
服务
service
实体通过接口（3.2）提供的功能性的独特角色。
[来源：GB/T 25597—2010,4.13]
4
缩略语
1
DB3708/T 58—2024
下列缩略语适用于本文件。
B3DM：批处理三维模型（Batched 3D Model)
GLTF：图形语言传输格式（Graphics LanguageTransmission Format）
I3DM：实例化三维模型（Instanced 3D Model）
JSON：一种轻量级的数据交换格式（JavaScript Object Notation）
M3D：三维数据模型（Model of 3D Data）
MVT：矢量瓦片（Mapbox Vector Tile）
NETCDF：通用的网络数据格式（Network Common Data Form)
OGC：开放地理信息系统协会（Open GIS Consortium）
XML：可扩展标记语言（Extensible Markup Language）
PBF：协议缓冲区（Protocol Buffers）
PNTS：点云（POINTS）
REST：表述性状态转移（Representation State Transfer）
S3M：空间三维模型数据格式（spatial 3D model）
SLPK：场景图层包（SceneLayer Package）
SOAP：简单对象访问协议（Simple Object Access Protocol）
TMS：切片地图服务(Tile map Servcie)
URL：统一资源定位符（Uniform Resource Locator）
VCTR：矢量数据（Vector Data）
WVTS：矢量瓦片数据服务（Web Vector Tile Service）
5 基本规定
5.1 坐标系统应采用 2000 国家大地坐标系（CGCS2000）。
5.2 高程基准应采用 1985 国家高程基准。
5.3 时间基准应日期采用公历纪元，时间采用北京时间。
6 接口服务内容
6.1 接口服务内容分类
三维地图平台应用接口包括管理类服务接口、二维地图类服务接口、三维地图类服务接口、空间分
析类服务接口。
6.2
管理类服务接口
提供接口资源查询搜索、接口元数据获取和接口访问授权的能力，包括目录服务接口、元数据服务
接口和授权服务接口，见附录A。
6.3
二维地图类服务接口
提供二维矢量、栅格地图数据的服务接口，包括地图服务、要素服务、覆盖服务，见附录A。
6.4
三维地图类服务接口
2
DB3708/T 58—2024
提供多种三维数据格式的地理信息场景服务接口，包括高程地形服务、建筑信息模型数据服务、倾
斜摄影模型数据服务、激光点云数据服务、三维手工建模数据服务、体元模型数据服务和三维数据切片
服务，见附录A。
6.5
空间分析类服务接口
提供二三维地理分析服务接口，包括地理分析服务、地名地址服务和时空分析服务,实现空间叠加、
要素提取、拓扑分析、栅格处理、地理编码等能力，见附录A。
7 接口使用流程
7.1 概述
三维地图平台接口的使用流程，包括接口发现、接口申请、接口调用环节，见图1。
接口使用方





三维地图平台



接口 发现




开始





查看服务接口 目录



















接口

申请


接入申请





接口开通授权




接口

调用


接入认证与接 口调用


结束



7.2 接口发现 图 1 接口使用流程图
接口使用方在三维地图平台查看接口资源列表，获取所需的接口及元数据信息，包括标识、名称、
摘要、关键字等，服务接口元数据项见附录A。
7.3
接口申请
接口使用方提出接口使用权限申请，三维地图平台通过身份识别和鉴权后，分配接口访问权限。
7.4
接口调用
接口使用方通过三维地图平台服务网关进行接口调用，服务网关负责身份鉴别和权限验证，鉴权通
过后将响应结果返回给接口使用方，未通过鉴权的拒绝调用请求。
3
DB3708/T 58—2024
8 接口调用规范
8.1 基本要求
8.1.1 接口形式
三维地图平台对外提供的接口调用的URI格式为：
{baseurl}/services/[catalogue]/{serviceName}
URI的表述格式应包括相对服务基地址｛baseurl｝的相对路径，URI由网络协议名称、主机地址、
端口、相对路径、服务参数等构成，catalogue为可选的分类编目，serviceName为服务名称。
8.1.2
请求协议
遵循HTTP或HTTPS协议标准。
8.1.3
请求方式
支持Restful、KVP或SOAP的接口请求方式。
8.1.4
请求操作
通过GET或POST方法获取三维地图平台接口资源。
8.1.5
安全认证
采取用户身份鉴别、数据安全等级标记、数据授权、强制访问控制等措施，通过三维地图平台实现
对用户认证、接口访问等权限的控制。
8.2
接口规范
管理类服务接口遵循WebService规范，支持Restfull；二维地图类、三维地图类、空间分析类服务
接口遵循OGC规范，见附录A。
8.3
接口操作
三维地图平台接口调用遵循的操作规范见表1，示例代码见附录B。
表 1
接口操作规范表
类型 接口操作规范
WMS OGC WMS规范
WMTS OGC WMTS规范
WFS OGC WFS规范
WFS-G OGC WFS-G规范
WCS OGC WCS规范
WPS OGC WPS规范
I3S OGC I3S规范
3D Tiles OGC 3D Tiles规范
S3M 《空间三维模型数据服务接口》（T/CAGIS 2—2020）
M3D 《全空间三维模型数据格式及服务接口规范》（T/CIIA 008—2021）
WebService WebService协议规范
4
DB3708/T 58—2024
8.4
响应格式
接口调用的响应结果数据格式见表2，示例代码见附录B。
表 2
接口返回数据格式
名称 说明
JSON 服务接口通用返回格式
XML 适用于WMS、WMTS等服务的元数据返回格式
BIN/PBF 适用于二进制流数据
PNG/JPG 适用WMS、WMTS等网络地图服务类型
MVT/PNG/JPEG/TIFF/NETCDF/GeoJSON 适用于矢量瓦片数据服务类型
B3DM/I3DM/PNTS/VCTR/CMPT 适用三维数据服务类型
SLPK 适用于三维数据服务类型
GLTF 适用三维模型数据服务类型
8.5
返回码
接口调用的响应结果返回码见表3。
表 3
接口返回数据格式
返回码 说明
200 请求成功，请求所希望的响应头或数据体将随此响应返回
300 请求失败，程序执行异常或失败，无法返回正确的响应结果
400 错误请求
403 请求成功，服务器已经理解请求，但无权限而拒绝执行它
404 请求失败，请求所希望的资源未在服务器上发现
500 请求失败，服务器遇到意外状况，导致无法完成对请求的处理
504 请求超时
9
接口安全要求
接口按照《测绘地理信息管理工作国家秘密范围的规定》的通知（自然资发〔2020〕95号）规定进
行数据分类分级使用，网络安全等级保护及政务信息共享安全应符合GB/T 22239、GB/T 22240、GB/T
39477要求。
5
DB3708/T 58—2024
附 录 A
（资料性）
三维地图平台接口服务
A.1
接口服务内容
接口服务内容见表A.1。
表A.1
接口服务内容
接口服务大类 接口服务项 接口规范 说明
管理类服务 目录服务 WebService 提供各类服务接口元数据的查询的 Web 访问功能
管理类服务 元数据服务 WebService 提供面向服务的注册信息查询能力，可根据服务编 码获取对应服务详细描述信息
管理类服务 授权服务 WebService 提供安全服务访问需要的权限认证信息，针对不同 访问权限要求的服务分发安全令牌或其他授权形 式，限定服务访问的用户、访问的期限、数据内容 和范围等
二维地图类服务 地图服务 WMS, WMTS, MVT 地图服务为 Web 端、桌面端和其他客户端应用程序 提供动态或缓存地图，应提供地理数据可视化、数 据查询、动态绘制等能力
二维地图类服务 要素服务 WFS, WVTS 提供地理要素数据和非空间表，提供对要素数据和 非空间表中的数据进行查询和编辑（包括插入、更 新、删除操作）、关联查询，支持对服务中的图层 执行地理分析
二维地图类服务 覆盖服务 WCS 提供栅格数据，提供显示和分析栅格数据，支持查 询、动态处理、轮廓获取、图像预览、数据和 添加等功能
三维地图类服务 高程地形服务 WMS, WMTS, TMS 提供地表高程表面数据，提供多种类型的高程表面 数据如数字高程模型、数字表面模型等
三维地图类服务 建筑信息模型服务 I3S, 3D Tiles, S3M, M3D 提供建筑信息模型数据，提供查询、展示建筑模型 全部构件以及对模型构建的属性进行查询，支持对 模型按建造阶段和按层级展示等多种方式进行筛选 展示
三维地图类服务 激光点云数据服务 I3S, 3D Tiles, S3M, M3D 提供倾斜摄影模型数据，提供浏览、查询、编辑和 数据提取的能力，支持准确的表面模型量测和全方 位多角度倾斜摄影表面模型数据可视化
三维地图类服务 手工模型服务 I3S, 3D Tiles, S3M, M3D 提供手工建模的精细三维模型数据，提供 对.obj,.dae,.wrl,.3ds 等多种精细模型数据格式 的服务发布，提供精细模型服务的浏览和查询能力， 支持 jpg/png/tif 的贴图格式以 及.webp、.dds、.ktx/.ktx2 等压缩纹理格式
三维地图类服务 体元模型服务 I3S, 3D Tiles, S3M, M3D 提供三维体元数据，提供多维数据的可视化，内部 空间单元剖分、创建等值面或截面等功能，支持指 定属性的连续变化特征空间可视化
6
DB3708/T 58—2024
接口服务大类 接口服务项 接口规范 说明
三维地图类服务 三维切片数据服务 I3S, 3D Tiles, S3M, M3D 供针对体元模型、三维矢量模型或多层 DEM 等真三 维模型进行水平、垂直、倾斜切片的数据服务，支 持真三维模型的内部非均匀数据场分布表达
空间分析类服务 地理分析服务 WPS 包含一系列地理数据处理的功能，如缓冲区分析、 叠加分析以及栅格数据处理等，以一种统一的规范 化的形式把面向空间的分析处理功能发布成应用接 口
空间分析类服务 地名地址服务 WFS-G 提供空间位置信息和语义化结构化信息的相互转换
空间分析类服务 时空分析服务 WPS 在三维地理信息场景立体空间内包含多个维度变量 的空间数据服务，如时空立方体服务
A.2
管理类服务-数据目录接口
管理类服务-数据目录接口见表A.2。
表A.2
管理类服务-数据目录接口
请求方法 输入参数 返回数据 约束条件 说明
getCatalogTree 接口资源目录节点 编码 资源目录级所包含接口的 信息 必选 获取接口资源目录的结构信息 和节点信息
searchTreeNode 接口资源目录节点 的编码 可选的查询条件 资源目录节点及符合要求 的接口信息 必选 从接口资源目录中搜索节点 信息
addTreeNode 接口资源的编码 接口资源级别 接口资源目录节点 信息 资源目录节点新增的结果 状态信息 必选 添加接口资源目录节点
deleteTreeNode 接口资源目录节点 的编码 资源目录节点删除结果状 态信息 必选 删除接口资源目录节点
updateTreeNode 接口资源目录节点 的编码； 接口资源节点更新 内容 数据项 资源目录节点修改的状态 信息 必选 更新接口资源目录节点
A.3
管理类服务-元数据接口
管理类服务-元数据接口见表A.3。
表A.3
管理类服务-元数据接口
请求方法 输入参数 返回数据 约束条件 说明
getServiceMetadata 接口的唯一编码 接口的元数据信息 必选 获取接口的所有元 数据
addServiceMetadata 接口唯一编码 增加接口元数据描述的执行状态信息 必选 添加接口元数据信息
7
DB3708/T 58—2024
请求方法 输入参数 返回数据 约束条件 说明
元数据项信息
updateServiceMetadata 接口唯一编码 更新的元数据项 更新接口元数据的执行状态信息 必选 更新接口的元数据信息
deleteServiceMetadata 接口唯一编码 删除接口元数据的执行状态信息 必选 删除接口元数据信息
A.4
管理类服务-授权管理接口
管理类服务-授权管理接口见表A.4。
表A.4
管理类服务-授权管理接口
请求方法 输入参数 返回数据 约束条件 说明
generateToken 用户信息 服务接口信息 生成的令牌 必选 申请接口授权令牌
verifyToken 令牌信息 服务接口信息 令牌验证的结果信息 必选 验证授权令牌是否有效
updateToken 用户信息 令牌信息内容 更新的令牌信息 可选 更改令牌的授权信息
cancelToken 原令牌的标识 取消令牌的结果信息 必选 取消授权令牌
A.5
服务接口元数据表
服务接口元数据表见表A.5。
表A.5
服务接口元数据表
大类 元数据项 字段名 约束条件 类型 说明
服务摘要 服务编码 identifier 必选 字符串 接口的唯一编码
服务摘要 服务名称 title 必选 字符串 接口的名称
服务摘要 服务别名 alias 可选 字符串 接口的别名
服务摘要 服务描述 description 可选 字符串 接口的摘要说明
服务摘要 服务标签 tags 可选 字符串 记录接口的关键信息的标签
服务摘要 服务地址 url 必选 字符串 接口的地址
服务摘要 服务缩略图 thumbnail 可选 文本 接口缩略图
服务摘要 服务编目分类 type 必选 字符串 接口编目分类
数据内容描述 坐标系 crs 必选 字符串 接口数据的空间坐标系，EPSG
数据内容描述 比例尺 scale 可选 数字 数据的比例尺精度
数据内容描述 精度 resolution 可选 数字 数据采集的空间分辨率
数据内容描述 空间范围 extent 可选 字符串 接口的空间覆盖范围
数据内容描述 中心点坐标 center 可选 字符串 接口空间范围的中心点坐标
数据内容描述 图层数量 layercount 必选 数字 接口包含的图层数量
数据内容描述 图层内容描述 layersdes 可选 文本 参考接口的数据内容项目
发布方信息 服务发布单位 publisher 必选 字符串 接口发布单位信息
发布方信息 联系人 contact 必选 字符串 接口发布方联系人
发布方信息 联系电话 tel 可选 字符串 接口发布方联系方式
发布方信息 联系人邮箱 email 可选 字符串 接口发布方者邮箱
8
DB3708/T 58—2024
大类 元数据项 字段名 约束条件 类型 说明
发布方信息 首次发布时间 publicationDate 必选 日期 接口首次发布时间，YYYYMMDD
发布方信息 最新发布时间 revisionDate 必选 日期 接口最后更新时间，YYYYMMDD
发布方信息 版本号 version 必选 字符串 接口更新的版本说明
安全管理 安全级别 securitylevel 必选 字符串 接口安全级别，私有、公开、安 全
安全管理 访问权限 constraints 必选 字符串 接口访问权限管理
扩充项 自定义 customizations 可选 自定义 可根据实际管理需求进行扩充
9
DB3708/T 58—2024
附 录 B
（资料性）
三维地图平台应用接口代码示例
B.1
管理类服务接口
a)元数据服务接口请求示例：
http://jnbigdata.cn:6080/services/manage/services/getServiceMetadata/?serviceid=5C4DF
7B29736&key=“密钥”
b)元数据服务接口返回示例：
{
"identifier":"A4EF5568-DA3F-4AAD-B3D5-5C4DF7B29736",
"title":"jiningDEM_LERC_IMG",
"alias":"济宁市高程地形服务",
"description":"济宁市 30 米分辨率高程地形",
"tags":"DEM,地形",
"url":"http://jnbigdata.cn:6081/geoscene/rest/services/jiningdem/ImageServer",
"thumbnail":"",
"type":"3DMap",
"crs":"4549",
"scale":"",
"resolution":"",
"extent":"[[12957136.7712000,4180572.7383000],[12997539.0672000,4241668.4038000]
]",
"center":"12977337.9192,4211120.57105",
"layercount":"1",
"layersdes":"jiningdem",
"publisher":"济宁市大数据局",
"contact":" ",
"tel":"",
"email":"",
"publicationDate":"2023-10-22",
"revisionDate":"2024-5-15",
"version":"1.1",
"securitylevel":"0",
"constraints":"anymous",
"customizations":""
}
B.2
二维地理图服务接口
a)二维要素服务 WFS 接口 GetFeature 操作请求参数示例：

version="2.0.0"
10
DB3708/T 58—2024
service="WFS"
xmlns="http://www.opengis.net/wfs/2.0"
xmlns:fes="http://www.opengis.net/fes/2.0"
xmlns:myns="http://www.someserver.com/myns"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.opengis.net/wfs/2.0
http://schemas.opengis.net/wfs/2.0/wfs.xsd">

myns:wkbGeom
myns:tileId







b)二维要素服务 WFS 接口 GetFeature 操作返回示例：

timeStamp="2010-02-01T22:56:09"
numberMatched="10"
numberReturned="10"
xmlns="http://www.someserver.com/myns"
xmlns:myns="http://www.someserver.com/myns"
xmlns:wfs="http://www.opengis.net/wfs/2.0"
xmlns:gml="http://www.opengis.net/gml/3.2"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.someserver.com/myns ./GetFeature_05.xsd
http://www.opengis.net/wfs/2.0
http://schemas.opengis.net/wfs/2.0/wfs.xsd
http://www.opengis.net/gml/3.2
http://schemas.opengis.net/gml/3.2.1/gml.xsd">


-31.27141761779785 115.001335144043
-30.10202789306641 117.9325866699219






11
DB3708/T 58—2024


-30.93597221374512 117.6290588378906
-30.94830513000489 117.6447219848633 -30.95219421386719 117.6465530395508
-30.95219421386719 117.6431121826172 -30.94802856445312 117.6386108398438