历史版本

历史版本目录

发行版本	发行日期	下载	在线地址	更新说明
V5.0	预览中	TGApp_v5.0.zip	https://www.tuguan.net/public/tgapp5/TGApp.min.js	5.0 版本更新说明

5.0 版本更新说明

版本亮点

1. 场景观察能力：新增 getRuntimeInfo、getSceneGraph 接口，分别返回当前场景的运行时状态与结构化对象树。TGAPI 在此之前是一组单向控制接口，只能下发指令、无法读取场景实际状态；这两条补上了观察侧，上层 AI 应用可据此判断当前看得见什么、场景里有哪些对象，再决定下一步动作。新增「全局控制 / 场景感知」分类。
2. 行政边界图层：新增 addBoundaryLayer、updateBoundaryLayerStyle、updateBoundaryNameStyle、updateBoundaryLayerLOD、updateBoundaryLayerFilter、setBoundaryDisplayScope 六条接口，配套 highlightCity、setCityNameVisible，支持按行政层级绘制边界并逐级控制样式、名称与显示范围。
3. 地理层级聚焦：镜头控制新增 focusGeoLevel、focusUpperGeoLevel、focusLowerGeoLevel、focusPlace，可按行政层级向上、向下逐级定位，或直接聚焦到指定地点。

新增功能和改进

1. 全局，新增场景感知分类，包含获取运行时信息 getRuntimeInfo、获取场景图信息 getSceneGraph。
2. 全局，预置地图，新增添加行政边界图层 addBoundaryLayer、更新行政边界图层样式 updateBoundaryLayerStyle、更新行政边界名称样式 updateBoundaryNameStyle、更新行政边界图层层级 updateBoundaryLayerLOD、更新行政边界图层筛选 updateBoundaryLayerFilter、设置行政边界显示范围 setBoundaryDisplayScope。
3. 全局，预置地图，新增高亮城市 highlightCity、设置城市名称显隐 setCityNameVisible。
4. 全局，镜头控制，新增地理层级聚焦 focusGeoLevel、向上层级聚焦 focusUpperGeoLevel、向下层级聚焦 focusLowerGeoLevel、聚焦指定地点 focusPlace。

端渲染与流渲染的支持差异

5.0 端渲染对新能力的支持落后于流渲染。本版中行政边界与城市高亮、地理层级聚焦、场景图的地理信息部分仅流渲染支持，端渲染未支持的项计划于后续版本添加支持。各接口的具体支持情况见对应页面的「端渲染 / 流渲染」列与补充说明。

返回历史版本目录

---

此文档最后更新日期：2026 年 10 月 23 日