96b16aea-0c6e-42cf-8c99-bd7810d3737b

3ditles加载器用户操作手册

当前版本: 1.0.0

快速入门

第一步:加载数据

  1. 点击左侧面板 「添加数据」 按钮
  2. 选择数据类型(倾斜模型、点云、正射影像等)
  3. 在弹出的文件选择器中选择数据文件夹或文件
  4. 等待数据缓存和加载完成

第二步:浏览与标注

  • 使用鼠标拖拽旋转视角
  • 使用顶部工具栏选择标注工具进行绘制
  • 左侧面板管理数据源和标注

界面介绍

整体布局

┌─────────────────────────────────────────────────────────┐
│                      顶部工具栏                          │
├──────────┬──────────────────────────────────┬──────────┤
│          │                                  │          │
│  左侧面板 │          三维地图视图            │ 右侧面板 │
│          │                                  │ (选中时) │
│  数据/标注│                                  │          │
│          │                                  │          │
├──────────┴──────────────────────────────────┴──────────┤
│                      底部状态栏                          │
└─────────────────────────────────────────────────────────┘

顶部工具栏

工具分组 功能
选择 选择标注(点击选中,右键菜单)
点工具 点标注、图标点
线工具 线段、曲线、箭头、虚线、路径
面工具 矩形、多边形、圆形、范围圈
测量工具 测距、测面、测高
动画效果 闪烁、流动、脉冲(需先选中标注)
撤销/重做 操作历史管理
导入导出 JSON/KML 格式
样式配置 默认样式设置

左侧面板

数据标签页: - 坐标系切换(WGS84/GCJ02) - 添加数据按钮 - 数据源分类标签(模型/正射/地形) - 数据源列表(勾选显示、调整透明度、删除)

标注标签页: - 新建文件夹按钮 - 批量操作栏(全选、显示/隐藏、批量删除) - 标注树形列表(文件夹分层)

右侧面板

选中标注后显示: - 标注名称(可编辑) - 标注类型 - 所属文件夹 - 样式属性(颜色、线宽、填充等)

底部状态栏

显示信息: - 当前鼠标位置坐标(经度、纬度、海拔) - 相机姿态(方位角、俯仰角) - 比例尺 - 数据源数量、标注数量、动画数量 - 操作进度提示


数据加载

加载 3D Tiles 模型(倾斜摄影)

  1. 点击 「添加数据」
  2. 选择 「3D Tiles 模型」
  3. 选择包含 tileset.json 的文件夹
  4. 等待扫描和缓存完成

数据要求:

模型文件夹/
├── tileset.json    # 必须包含
├── *.b3dm          # 或 .glb/.gltf 文件
└── ...

加载 3D Tiles 点云

  1. 点击 「添加数据」
  2. 选择 「3D Tiles 点云」
  3. 选择包含 tileset.json.pnts 文件的文件夹

调整点大小: - 在数据源列表中找到该点云 - 使用「点大小」滑块调整(范围 1-20)

加载切片影像

  1. 点击 「添加数据」
  2. 选择 「切片影像」
  3. 选择影像切片文件夹

数据要求: - 方式一:包含 meta.jsontilemapresource.xml - 方式二:{z}/{x}/{y}.png 目录结构(自动识别)

加载 GeoTIFF 正射影像

  1. 点击 「添加数据」
  2. 在「选择文件」区域点击 「正射影像」
  3. 选择 .tif.tiff 文件(可多选)

自动识别: - 多波段(RGB/RGBA)→ 作为正射影像加载 - 单波段 → 自动转为地形数据

加载 GeoTIFF 地形数据

  1. 点击 「添加数据」
  2. 在「选择文件」区域点击 「地形高程」
  3. 选择单波段 GeoTIFF 文件

数据要求: - 单波段 TIFF - 每个像素值代表高程(海拔) - 包含地理参考信息(投影坐标系)


标注绘制

点标注

  1. 点击工具栏 点标注 按钮(或按 P
  2. 在地图上点击位置
  3. 标注自动创建完成

图标点

  1. 点击工具栏 图标点 按钮(或按 I
  2. 在地图上点击位置
  3. 创建带图标效果的点标注

线段

  1. 点击工具栏 线段 按钮(或按 L
  2. 在地图上依次点击各节点
  3. 双击或按 Esc 完成绘制

曲线

  1. 点击工具栏 曲线 按钮(或按 C
  2. 依次点击节点
  3. 自动生成平滑曲线
  4. 双击完成

箭头

  1. 点击工具栏 箭头 按钮(或按 A
  2. 点击起点
  3. 点击终点
  4. 自动添加箭头头部

虚线

  1. 点击工具栏 虚线 按钮(或按 D
  2. 依次点击节点
  3. 双击完成

路径

  1. 点击工具栏 路径 按钮
  2. 依次点击路径节点
  3. 双击完成

矩形

  1. 点击工具栏 矩形 按钮(或按 R
  2. 点击第一个角点
  3. 点击对角点
  4. 自动生成矩形

多边形

  1. 点击工具栏 多边形 按钮(或按 G
  2. 依次点击各顶点
  3. 双击完成(自动闭合)

圆形

  1. 点击工具栏 圆形 按钮(或按 O
  2. 点击圆心位置
  3. 点击边缘定义半径
  4. 自动生成圆形

范围圈

  1. 点击工具栏 范围圈 按钮
  2. 点击中心位置
  3. 点击定义半径
  4. 生成同心圆范围标注

测距

  1. 点击工具栏 测距 按钮(或按 M
  2. 依次点击测量点
  3. 自动显示各段距离和总距离
  4. 双击完成

注意: 测量结果贴合地形表面

测面

  1. 点击工具栏 测面 按钮(或按 S
  2. 依次点击多边形顶点
  3. 自动显示面积
  4. 双击完成

测高

  1. 点击工具栏 测高 按钮(或按 H
  2. 点击起点位置
  3. 点击终点位置
  4. 自动显示两点间的水平距离、垂直高差、空间距离

标注管理

选中标注

方式一:点击选择 - 使用「选择」工具(按 V) - 直接点击地图上的标注

方式二:列表选择 - 在左侧标注列表中点击标注名称

编辑标注属性

选中标注后,右侧面板显示属性: - 名称: 直接编辑 - 文件夹: 下拉选择所属文件夹 - 颜色: 点击颜色选择器 - 线宽: 滑块调整 - 填充: 是否填充、填充颜色、填充透明度

显示/隐藏标注

  • 标注列表中点击 👁 图标
  • 或在右侧面板取消勾选「显示」

删除标注

单个删除: - 列表中点击 ✕ 按钮 - 或选中后按 Delete 键 - 或右键菜单选择「删除」

批量删除: 1. 在标注列表中勾选多个标注 2. 点击「删除 N」按钮 3. 确认删除

移动标注位置

  1. 右键点击标注
  2. 选择「移动」
  3. 在地图上点击新位置
  4. 右键取消或点击确认

文件夹管理

新建文件夹: - 点击「+ 文件夹」按钮 - 输入文件夹名称

文件夹操作: - 点击文件夹名称选中 - 点击展开/折叠图标 - 点击 👁 显示/隐藏文件夹内所有标注 - 点击 ✕ 删除文件夹(标注移至上级)

拖拽整理: - 拖拽标注到文件夹内 - 拖拽文件夹调整层级 - 拖拽调整排序


数据源管理

显示/隐藏数据源

  • 数据源列表中勾选/取消勾选
  • 取消勾选后数据从视图中隐藏,但保留缓存

调整透明度

  • 模型/影像:使用「透明度」滑块(0-100%)
  • 点云:使用「点大小」滑块(1-20)

删除数据源

  • 点击 ✕ 按钮
  • 确认删除
  • 清除缓存数据

数据源排序

  • 拖拽数据源列表项调整顺序
  • 影响影像叠加层级(上层的影像覆盖下层)

定位到数据源

  • 点击数据源名称
  • 自动飞行到该数据源位置

动画效果

添加动画

  1. 选中一个标注(测量类标注不支持动画)
  2. 点击工具栏动画按钮:
  3. 闪烁: 标注周期性显示/隐藏
  4. 流动: 线/面标注上的流动效果
  5. 脉冲: 圆形扩散脉冲效果

取消动画

  • 再次点击相同动画按钮取消
  • 或在右侧面板选择「无动画」

导入导出

导出标注

  1. 点击工具栏 导出 按钮
  2. 选择格式:
  3. 导出 JSON: 包含所有标注和文件夹结构
  4. 导出 KML: Google Earth 格式(不含文件夹)

导入标注

  1. 点击工具栏 导入 按钮
  2. 选择格式:
  3. 导入 JSON: 恢复标注和文件夹
  4. 导入 KML: 从 KML 文件导入标注

注意: 导入会与现有标注合并,不会删除现有标注


快捷键

按键 功能
V 选择工具
P 点标注
I 图标点
L 线段
C 曲线
A 箭头
D 虚线
R 矩形
G 多边形
O 圆形
M 测距
S 测面
H 测高
Esc 取消当前绘制
Delete 删除选中标注
Ctrl+Z 撤销
Ctrl+Y 重做

常见问题

Q: 数据加载失败,提示「tileset.json 未找到」

原因: - 数据文件夹结构不正确 - 未包含 tileset.json 文件

解决: - 确认文件夹中有 tileset.json - 检查 JSON 文件格式是否正确

Q: GeoTIFF 加载后位置不对

原因: - GeoTIFF 缺少地理参考信息 - 坐标系不被支持

解决: - 确保 GeoTIFF 包含正确的投影信息 - 支持的坐标系:WGS84、UTM、Web Mercator 等

Q: 点云无地理参考,已隐藏

原因: - 点云数据缺少坐标定位信息 - boundingSphere 中心接近地球中心点

解决: - 使用有地理参考的点云数据 - 或在数据处理阶段添加坐标信息

Q: 数据加载很慢

原因: - 数据量过大 - 浏览器缓存空间不足

解决: - 清理浏览器缓存 - 分批次加载较小的数据集

Q: 页面刷新后数据消失

原因: - 浏览器清除了 Service Worker 缓存 - 文件访问权限过期

解决: - 点击数据源的显示复选框重新加载 - 或重新添加数据源

Q: 地形加载后看不到起伏

原因: - 地形 exaggeration( exaggeration )设置问题 - 高程范围过小

解决: - 等待地形数据完全加载 - 调整相机视角观察地形细节

Q: 坐标显示与预期不符

原因: - 坐标系设置问题

解决: - 检查左侧面板的坐标系设置(WGS84/GCJ02) - 国内地图数据可能需要 GCJ02 坐标系


技术支持

如有问题或建议,请联系开发团队或提交 Issue。

文档持续更新中,如有问题请联系 技术支持:13305108038