【V3DTILES API】说明文档

V3DTILES 是一款使用C/C++开发的高效的 GIS 数据切片软件，目前支持以下 6 种切片功能：

矢量数据(shp, gdb, gpkg, pg 等)转为3DTiles，主要用于生成房屋白模

倾斜摄影数据(osgb)转为3DTiles

倾斜摄影模型裁切(多边形范围精确裁切)

点云转3DTiles

遥感影像按照XYZ或TMS格式切片

地形数据切片(quantized-mesh-1.0)

通用模型切片(OBJ模型转3DTiles)

同时，软件具有统计分析、数据服务分发和三维地图可视化等附加功能。
软件可运行在Windows和Linux操作系统下，可适配国产信创环境，支持内网(离线)环境运行。
软件有两种使用方式：

通过 Web 界面进行可视化操作。

通过 HTTP API 接口调用，实现自动化切片。

访问软件官网 v3dtiles.top
阅读用户手册飞书云文档 - V3DTILES软件用户手册

1. POST请求

对于 POST 请求，请求体统一为 JSON 格式。

Content-Type: application/json; charset=utf-8

Authorization: {{API_KEY}}

除登录接口外，其他接口需要在请求头中添加 Authorization 用于鉴权。

2. 如何创建 `API_KEY`

使用用户名密码或离线授权码登录系统后，点击左侧导航栏API集成，然后在右侧页面点击 生成API Key 按钮。

2. 响应内容模板

{
    "code": 0,
    "msg": "OK",
    "data": {
       //...
    }
}

部分接口可能不返回data字段。

3. 响应值`code`含义

状态码	描述
0	成功
-1	无效的请求路径
-2	无效的请求方法 (错误使用 GET/POST 方法)
-3	缺失请求参数 (无请求参数或缺少部分字段)
-4	无效的请求参数 (字段类型错误、字段逻辑错误)
-5	服务器内部错误
1002	权限不足
1005	非 VIP 或离线授权用户
1501	资源不存在
1601	工程配置无效
1602	任务配置无效
1611	目录/文件无读取权限
1612	目录/文件无写入权限
1900	其他错误
1901	重复项(例如工程名称重复)

4. 关于【切片工程】和【切片任务】

必须先创建【切片工程】，填写数据源和工程配置。然后执行该切片工程时会创建【切片任务】，执行多次会生成多个任务。

【切片任务】 = 【切片工程】 + 【任务参数】 + 【任务结果】

工程和任务通过 id 唯一标识。

同一类型下的所有工程中，工程名称也要唯一。

切片工程和切片任务的定义请参考本文档【数据模型】页面。

工程类型	枚举名称	描述	输入数据格式
1	kVectorProject	矢量数据转3DTiles，例如生成房屋白模	Shapefile, GeoPackage, PostGIS, FileGDB
2	kOsgbProject	倾斜模型转3DTiles	OSGB (Data + metadata.xml)
3	kImageryProject	遥感影像切片，输出`XYZ`或`TMS`格式图片瓦片	GeoTIFF, IMG, VRT
4	kTerrainProject	地形切片，输出`Quantized-Mesh`格式地形瓦片	GeoTIFF, IMG, VRT, ADF
5	kOsgbClipProject	倾斜模型裁切	OSGB (Data + metadata.xml) + 多边形范围 (shp, kml, geojson等)
6	kPointCloudProject	点云转3DTiles	LAS / LAZ 点云
7	kGeneralProject	通用模型切片	OBJ, (正在开发对FBX格式的支持)

4.1 矢量数据转3DTiles (Vector to 3DTiles)

+-- 矢量数据转3DTiles工程
    |-- 矢量数据源1
    |   |-- 矢量图层11
    |   |   |-- 图层字段111
    |   |   `-- 图层字段112
    |   |-- 矢量图层12
    |   |   |-- 图层字段121
    |   |   `-- 图层字段122
    `-- 矢量数据源2
        |-- 矢量图层21
        |   |-- 图层字段211
        |   |-- 图层字段212
        |   `-- 图层字段213
        `-- 矢量图层22
            |-- 图层字段221
            |-- 图层字段222
            `-- 图层字段223

4.2 倾斜模型转3DTiles (Osgb to 3DTiles)

只能有1个数据源

+-- 倾斜模型转3DTiles工程
    `-- 倾斜摄影模型数据源

4.3 遥感影像切片 (Image to XYZ / TMS Tiles)

+-- 遥感影像切片工程
    |-- 遥感影像数据源1
    |   |-- 影像文件11
    |   `-- 影像文件12
    `-- 遥感影像数据源2
        |-- 影像文件21
        `-- 影像文件22

4.4 地形切片 (DEM to Terrain Tiles)

+-- 地形切片工程
    |-- DEM 数据源1
    |   |-- DEM文件11
    |   `-- DEM文件12
    `-- DEM 数据源2
        |-- DEM文件21
        `-- DEM文件22

4.5 倾斜模型裁切 (Osgb Clip)

只能有1个数据源

+-- 倾斜模型转3DTiles工程
    `-- 倾斜摄影模型数据源

另外需要输入裁切多边形范围，读取输入文件中的第1个要素。

+-- 裁切范围(shp, kml, geojson)

4.6 点云转3DTiles (PointCloud to 3DTiles)

+-- 点云转3DTiles工程
    |-- 点云数据源1
    |   |-- 点云文件11
    |   `-- 点云文件12
    `-- 点云数据源2
        |-- 点云文件21
        `-- 点云文件22

4.7 通用模型切片 (GeneralModel to 3DTiles)

+-- 通用模型切片工程
    |-- 模型数据源1
    |   |-- 模型文件11
    |   `-- 模型文件12
    `-- 模型数据源2
        |-- 模型文件21
        `-- 模型文件22

5. 关于VIP和离线授权码

本软件免费开放基础功能，可无限制正常使用。

如果您觉得本软件对您有所帮助，且经济条件允许，可以考虑:

💰 开通VIP或购买离线授权【账户管理 - 个人中心页面】，解锁更多专业功能。

您的微小支持，是软件持续更新的最大动力！

END

感谢您对 V3DTILES 软件的支持！

发布于 2026-04-15
编辑于 2026-06-15

【V3DTILES API】说明文档

1. POST请求#

2. 如何创建 API_KEY#

2. 响应内容模板#

3. 响应值code含义#

4. 关于【切片工程】和【切片任务】#

4.1 矢量数据转3DTiles (Vector to 3DTiles)#

4.2 倾斜模型转3DTiles (Osgb to 3DTiles)#

4.3 遥感影像切片 (Image to XYZ / TMS Tiles)#

4.4 地形切片 (DEM to Terrain Tiles)#

4.5 倾斜模型裁切 (Osgb Clip)#

4.6 点云转3DTiles (PointCloud to 3DTiles)#

4.7 通用模型切片 (GeneralModel to 3DTiles)#

5. 关于VIP和离线授权码#

END#