GeoApp 地图应用#

版本号： 0.01 版权所有： 深圳市英特吉欧创新科技有限公司

更新日期：2026-02-28

版权与免责声明#

1. 本软件的所有权和相关知识产权均属于深圳市英特吉欧创新科技有限公司单独所有。
2. 用户应通过合法途径获得软件使用权，并按相关约定合法使用。
3. 用户在使用本软件过程中，因非深圳市英特吉欧创新科技有限公司原因发生的侵权或违法行为，由用户自行承担全部法律责任，深圳市英特吉欧创新科技有限公司不承担任何连带责任。
4. 未经深圳市英特吉欧创新科技有限公司书面同意或授权，任何主体不得对本软件进行改编、翻译、注释、整理、汇编、再许可、再授权等任何形式的修改或衍生操作。
5. 本手册内容如有更新或变更，恕不另行通知，深圳市英特吉欧创新科技有限公司对此不承担相关义务。

商标声明#

"GeoTwin"、"深圳市英特吉欧创新科技有限公司"等均为深圳市英特吉欧创新科技有限公司的注册商标，受法律保护。未经深圳市英特吉欧创新科技有限公司书面同意或授权，不得以任何方式侵犯注册商标专用权，违者必究。

目录#

1. 新增功能/优化项
2. 使用须知
3. 软件概述
4. 格式支持
5. 软件介绍
6. 相关概念
7. 技术支持

1. 新增功能/优化项#

1.1 版本更新内容（V3.4.0）#

• 功能优化：

  • 大屏编辑器界面交互优化，拖拽响应更流畅
  • 3D 场景组件性能提升，场景图增量更新机制（triggerSceneGraphDelta）稳定性增强
  • 表格组件支持排序、筛选、列宽拖拽调整
  • 矢量图层要素高亮控制（vectorHighlight）新增批量操作支持

• 新增功能：

  • 本地历史记录：基于 IndexedDB 存储编辑操作历史，支持本地多版本回滚

• 其他变更：

  • Scene API 文档更新至 v1.1.0，新增 translateCoord 坐标转换接口
  • @gt-viewer/sdk 升级至 1.1.26，@gt-viewer/engine 升级至 1.1.34

1.2 版本迭代记录#

2. 使用须知#

2.1 软件运行要求#

2.1.1 操作系统#

• 支持系统：Windows 10/11（x64）、Windows Server 2016 及以上、主流 Linux 发行版（Ubuntu 20.04+）
• 系统配置：64 位操作系统，建议安装最新版本浏览器（Chrome 100+ / Edge 100+）

2.1.2 硬件要求#

• 显卡：建议 NVIDIA 独立显卡，显存 ≥ 4GB，驱动版本支持 WebGL 2.0（服务端渲染场景建议 CUDA 驱动 ≥ 11.x）
• 处理器：建议四核及以上 CPU，主频 ≥ 2.5GHz
• 内存：建议 ≥ 16GB，大型场景建议 ≥ 32GB
• 其他：建议使用支持 WebGL 2.0 及 WebAssembly 的现代浏览器访问

2.1.3 存储和网络要求#

• 存储：建议系统盘剩余空间 ≥ 20GB，三维场景数据（点云/3D Tiles/GeoTiff 等）建议存储于高速固态硬盘或 NAS
• 网络：访问后端 GeoTwin 服务建议千兆及以上内网连接；使用 MQTT 物联网接入时建议专用网络通道

2.1.4 硬件推荐配置#

2.2 软件安装与启动#

1. 访问 GeoTwin 数据可视化平台官网，获取安装程序；
2. 双击安装程序，按照安装向导完成安装（建议使用默认路径，或自定义非中文路径）；
3. 安装完成后，桌面将生成快捷方式，双击即可启动软件；
4. 首次启动后，可通过浏览器访问本地服务地址进入平台主界面。

2.3 获取授权#

1. 访问软件部署地址，进入登录界面；
2. 输入 GeoTwin 平台账号及密码，点击"登录"；
3. 登录成功后系统自动完成鉴权，进入应用主页。

3. 软件概述#

3.1 核心定位#

GeoTwin App Builder 是一款低代码可视化大屏构建平台，深度集成 GeoTwin 三维 GIS 引擎，支持拖拽式编排可视化组件、绑定多源实时数据，并能在同一大屏画布中无缝融合二三维地理场景与业务数据看板。适用于智慧城市、数字孪生、应急指挥、工业监控、国土测绘等领域的大屏可视化展示与交互分析。

3.2 模块构成#

软件主要包含以下核心模块：

• 应用管理模块：负责大屏应用的创建、搜索、导入/导出、分页展示，支持按名称搜索和多屏尺寸选择（1920×1080 等）。

• App编辑器模块：核心拖拽式编辑器，左侧为组件库/图层面板，中间为可视化画布，右侧为属性配置面板，支持多组件叠加布局。

• 3D 地图场景模块：基于 @gt-viewer/sdk ECS 架构的三维场景容器，支持点云、3D Tiles、矢量、GeoTiff 等多源地理数据叠加渲染，并对外暴露 window.scene.api 接口。

• GIS 功能组件模块：包含图层管理、要素查询（Identify）、空间量测（11 种）、三维分析（11 种）、相机飞行动画、书签管理、2D/3D 切换、指北针、比例尺、截图录屏、天气效果等丰富地图功能组件。

• 数据绑定与配置模块：支持静态数据、HTTP/HTTPS 接口、WebSocket、MQTT 物联网、数据库直连等多种数据源，提供数据过滤器、全局变量、事件联动、条件判断等高级配置。

• 预览与发布模块：提供大屏实时预览，支持打包为独立 UMD 库文件 (index.umd.js) 或通过分享链接对外发布。

3.3 核心优势#

• 零代码门槛：拖拽即可完成大屏布局，配置即可绑定数据，非技术人员亦可快速上手。
• 深度 GIS 集成：内嵌企业级三维 GIS 引擎，二三维场景与业务数据看板无缝融合，支持 11 种空间分析与 11 种空间量测。
• 多源数据接入：支持 HTTP、WebSocket、MQTT、数据库等多种数据源，满足 IoT 实时监控场景需求。
• 开放集成能力：通过 window.scene.api 对外暴露完整场景控制接口，便于与第三方平台深度集成。
• 灵活部署方式：支持独立部署和库文件引用两种方式，适应不同集成场景。

4. 格式支持#

4.1 输入数据格式#

4.2 输出数据格式#

5. 软件介绍#

5.1 核心模块操作#

5.1.1 应用管理#

应用管理页面用于统一管理所有大屏应用，支持按应用类型（AppBuilder）分类查看。

核心功能：

• 新建应用：选择屏幕尺寸（Desktop 1920×1080 / 自定义宽高），设置应用名称后创建
• 搜索应用：支持按应用名称关键词搜索过滤
• 应用列表：分页展示，支持点击进入编辑器或预览页面
• 导入应用：上传 JSON 格式大屏配置文件导入已有应用

操作步骤：

1. 登录系统后进入应用主页，查看应用列表；
2. 点击"新建"按钮，选择屏幕尺寸，输入应用名称；
3. 确认后自动跳转至大屏编辑器。

【截图占位符 图5-1-1】 应用管理主页，展示应用列表及新建入口

5.1.2 大屏编辑器#

大屏编辑器是软件核心操作界面，采用三栏布局：左侧为组件/图层面板，中间为画布区域，右侧为属性配置面板。

核心功能：

操作步骤：

1. 从左侧组件库拖拽组件（如图表、3D 地图、文字标签等）到画布；
2. 选中组件后，在右侧属性面板配置数据来源（静态/HTTP/WebSocket/MQTT）；
3. 设置组件样式（颜色、字体、边框、背景等）；
4. 配置组件事件（点击触发飞行/弹窗/数据刷新等联动动作）；
5. 点击顶部"预览"按钮查看效果；
6. 确认无误后保存并发布。

【截图占位符 图5-1-2】 大屏编辑器三栏布局全景，含画布、组件库、属性面板

5.1.3 3D 地图场景组件#

3D 地图场景组件（map）是 GeoTwin App Builder 的核心 GIS 组件，内嵌 GeoTwin 三维引擎，支持多源地理数据叠加渲染。

核心功能：

• 场景初始化：自动连接后端 GeoTwin 服务，加载场景配置（sceneId）
• 图层渲染：支持点云、3D Tiles、矢量、GeoTiff、底图服务等多种图层类型
• 场景图管理：基于 ECS 架构，通过 window.scene.api 对外暴露完整控制接口
• 2D/3D 视图切换：支持平面与立体视图一键切换

基础配置参数：

操作步骤：

1. 从左侧组件库将"3D 地图"组件拖拽至画布；
2. 在右侧属性面板配置 server（后端服务地址）和 sceneId；
3. 画布中地图区域加载完成，场景就绪后触发 sceneReady 事件；
4. 可叠加添加图层管理、量测、分析等辅助 GIS 组件。

【截图占位符 图5-1-4】 3D 地图组件加载完成后的场景效果，含底图与三维模型

5.1.4 图层管理组件#

图层管理组件（layer）提供可视化图层树，支持对场景中各图层进行显示/隐藏、定位、搜索过滤。

核心功能：

• 图层树展示：树形结构展示所有图层（点云/3D Tiles/矢量/底图等）
• 显示/隐藏控制：点击图层前复选框切换可见状态
• 定位到图层：双击图层名称，相机自动飞行定位至该图层范围
• 关键词搜索：支持按图层名称快速过滤
• 展示模式：支持按钮弹出模式和内嵌模式两种显示形式

操作步骤：

1. 在画布中添加"图层管理"组件，并关联到地图组件；
2. 图层树自动加载当前场景的所有图层；
3. 点击复选框控制图层显隐；
4. 双击图层名称快速定位视角；
5. 在搜索框输入关键词过滤图层列表。

【截图占位符 图5-1-5】 图层管理组件展示树形图层列表及控制操作

5.1.5 空间量测组件#

空间量测组件（measurement）提供 11 种三维量测工具，用于对场景中的空间要素进行精确测量。

支持的量测类型：

操作步骤：

1. 在画布中添加"量测"组件，关联到地图组件；
2. 在量测工具栏中选择所需量测类型（如"距离量测"）；
3. 在三维场景中依次点击量测起止点；
4. 系统在场景中实时显示量测结果标注。

【截图占位符 图5-1-6】 量测工具栏及场景内量测结果标注展示

5.1.6 三维空间分析组件#

三维空间分析组件（analysis）提供 11 种三维空间分析工具，用于辅助决策分析与仿真模拟。

支持的分析类型：

操作步骤：

1. 在画布中添加"空间分析"组件，关联到地图组件；
2. 在分析工具栏中选择分析类型（如"洪水模拟"）；
3. 配置分析参数（如水位高程值）；
4. 点击"执行"，场景中实时渲染分析结果。

【截图占位符 图5-1-7】 空间分析工具栏及洪水模拟/通视分析结果展示

5.2 关键流程操作#

5.2.1 新建大屏应用流程#

1. 登录系统，进入应用主页；
2. 点击右上角"新建"按钮，弹出新建对话框；
3. 选择屏幕分辨率（如 Desktop 1920×1080）；
4. 输入应用名称，点击"确认"；
5. 系统自动创建应用并跳转至大屏编辑器。

【截图占位符 图5-2-1】 新建应用对话框，展示尺寸选择与名称输入

5.2.2 三维 GIS 大屏搭建流程#

1. 进入大屏编辑器，从左侧组件库找到"3D 地图"组件；
2. 将"3D 地图"组件拖拽至画布，调整至合适位置和尺寸；
3. 在右侧属性面板填写 server（GeoTwin 后端服务地址）和 sceneId；
4. 等待场景加载完成，sceneReady 事件触发后场景就绪；
5. 根据需要从组件库拖拽叠加图层管理、量测、分析等 GIS 辅助组件；
6. 配置各 GIS 组件与地图的关联关系；
7. 添加业务数据图表组件（折线图、饼图、仪表盘等），配置数据源；
8. 调整各组件的层叠顺序和显示样式，完成大屏布局。

【截图占位符 图5-2-2】 三维 GIS 大屏搭建过程，含地图组件与图表组件叠加布局

【截图占位符 图5-2-3】 配置 sceneId 和 server 参数的属性面板

5.2.3 APP预览与发布流程#

1. 在编辑器顶部点击"保存"按钮，保存当前大屏配置；
2. 点击"预览"按钮，在新标签页打开大屏预览页面；
3. 验证大屏展示效果、数据加载、事件联动等功能；
4. 返回编辑器，如需调整继续编辑；
5. 确认效果后，点击"发布"或通过"分享"功能生成访问链接；
6. 如需独立部署，可通过"导出"功能导出 JSON 配置文件，或执行 pnpm lib 构建 UMD 包。

【截图占位符 图5-2-7】 大屏预览页面全屏展示效果

5.2.6 场景截图与录屏流程#

1. 在画布中添加"截图"或"录屏"组件，关联到地图组件；
2. 场景截图：
   • 点击截图按钮，系统自动捕获当前三维场景视图；
   • 截图以 PNG 格式自动下载保存至本地。
3. 场景录屏：
   • 点击"开始录制"按钮，系统开始录制三维场景操作过程；
   • 操作完成后点击"停止录制"，系统自动以 MP4 格式命名下载。

【截图占位符 图5-2-8】 截图录屏组件操作按钮及保存效果示意

5.3 Scene API 开发集成#

window.scene.api 是 GeoTwin App Builder 对外暴露的 JavaScript 接口，供外部平台或页面脚本控制三维场景。

使用前提： 监听 sceneReady 事件，确保 API 已就绪后再调用：

window.addEventListener('sceneReady', (event) => {
    console.log('场景已准备就绪');
    // 此时可安全使用 window.scene.api
});

主要 API 方法：

场景事件：

5.4 常见问题处理#

• 问题 1：3D 地图组件加载后场景空白

  • 解决方案：检查 server（后端服务地址）是否可访问；确认 sceneId 是否正确；检查浏览器是否支持 WebGL 2.0（访问 about:gpu 确认 GPU 加速已启用）。

• 问题 2：HTTP 数据源无法加载数据

  • 解决方案：检查接口地址是否正确，确认跨域（CORS）配置是否允许当前域名访问；检查请求方式（GET/POST）和请求头是否与接口匹配；在浏览器开发者工具 Network 面板查看具体报错。

• 问题 3：大屏编辑器拖拽卡顿

  • 解决方案：减少画布中高复杂度组件数量；关闭不必要的 3D 场景实时渲染；清理浏览器缓存后重新加载；检查本地历史记录（IndexedDB）存储空间是否充足。

• 问题 4：window.scene.api 调用报错 undefined

  • 解决方案：确保在 sceneReady 事件回调内调用 API，而非页面初始化时直接调用；检查地图组件 sceneId 和 server 配置是否完整。

• 问题 5：登录后无法访问大屏

  • 解决方案：检查账号权限是否包含目标大屏的访问权限；清除浏览器 localStorage 中的旧 Token 后重新登录；如使用分享链接，确认 Share Token 未过期。

6. 相关概念#

7. 技术支持#

• 官网地址： 待补充
• 手册下载： 待补充
• 联系邮箱： 待补充
• 技术支持： 如有技术问题，请通过上述联系方式与我们联系