《空间三维模型数据服务接口》T/CAGIS 2-2020

本规范规定了与《空间三维模型数据格式》配套的空间三维模型数据服务接口，旨在为 Web 环境下的三维模型数据发布与访问提供标准化支撑。本规范明确了基于 HTTP/1.1 协议的 REST 风格接口体系，涵盖数据资源范围、请求协议、状态码及返回格式等基本要求。在总体框架上，本规范将服务接口划分为服务信息、瓦片树集合列表和瓦片树集合三类，并围绕 S3M 标准的五类数据文件，定义了描述文件、瓦片数据、索引树、属性描述与属性数据等核心接口的访问路径及交互方式。通过统一的 URI 表述与参数设计，本规范为不同应用系统在云服务、边缘服务及桌面、移动端的空间三维模型互联互通奠定了技术基础。

接口体系与数据资源映射

本规范采用 REST 风格设计接口层次，将 S3M 格式中的描述文件、数据文件、索引树文件及属性文件分别映射为 config、tiledata、indextree、attributeinfo 和 attributedata 等数据资源，并统一归属于瓦片树集合资源之下。本规范定义了从服务信息获取到瓦片树集合访问、再到具体瓦片数据与属性数据调用的完整链路，各接口通过相对服务基地址的 URI 路径进行定位和操作。

核心接口与操作方式

本规范规定了通过 HTTP GET 方法获取数据资源及信息的基本操作，并对 HEAD 方法做了非强制性说明。服务信息接口提供整体服务描述，瓦片树集合列表接口返回所有可用数据集的清单，瓦片树集合接口则进一步定位到具体数据集。在此基础上，描述文件接口返回包含版本号、类型、坐标系和根节点路径的配置信息；瓦片数据接口支持逐级获取 LOD 瓦片文件；索引树接口允许按节点获取或子树访问；属性描述与属性数据接口则分别提供图层字段元信息和按对象与字段组合查询的二进制流数据。