Rapid SCADA v6 地图与三维绑定：坐标、对象身份、状态质量与资源版本

地图能加载、模型能旋转，只证明空间资源可展示。要让它成为运行监视页，还需要稳定设备身份、正确坐标、有效数据和清楚的未知状态。模型始终是绿色，有时只因为默认材质是绿色。

本文按本项目地图/三维扩展说明集成方法；不同插件的工程格式、资源路径与发布方式不同。下面的 JSON 是映射设计示意，不是可直接上传的.map或三维工程完整 schema。

1. 空间位置与设备身份分别管理

名称用于显示，稳定 ID 用于关联。模型重新导出后节点名称可能改变，不能只按“第 3 个 mesh”绑定设备。资源升级应校验映射是否仍能解析到同一设备。

同一数据库通道号仍需唯一。多站独立实例汇聚时，应增加实例/站点身份，不能仅凭本地通道 4102 区分全国所有泵。

2. 地图偏移先查坐标体系和顺序

标准 GeoJSON 使用 WGS 84，位置数组前两项为经度、纬度。RFC 7946

{"type":"Feature","id":"feature-pump-a","geometry":{"type":"Point","coordinates":[120.0,30.0]},"properties":{"deviceKey":"DEMO-PUMP-A","runCnl":4102}}

这是虚构坐标与自定义属性示例。接入其他格式时，确认它的坐标顺序与坐标体系。底图使用的坐标体系和设备数据不同，不能仅用拖动图标补偿后就认为所有位置都正确。

地图边界、管线和站点若共同偏移，优先检查坐标转换；只有个别设备偏移，再查原始坐标、顺序和精度。三维还需说明模型长度单位、坐标原点、朝向和高度基准，不能把米与毫米混用。

3. 着色规则先判断质量，再解释状态

演示泵状态可以分成以下显示规则：

颜色同时配文字或图例，避免只靠红绿区分。运行与故障同时为真时采用明确优先级，不让不同组件各自解释。

若接口只有值和状态而没有逐点更新时间，就不能拿“页面请求时间”推算现场数据新鲜度。需先补齐可靠时间来源，或者如实只展示现有质量与连接状态。

4. 本项目离线地图的交付边界

本次核对的 PlgMapCustom 使用 MapLibre，支持工程网格、受控在线底图和离线地图包。当前实现将离线包内容与元数据保存在插件专用数据库中，工程引用包身份；交付不能只复制.map文件。

在线地图还依赖网络、服务商授权及资源地址。离线部署应在断网环境验证瓦片、字体、图标、脚本等所有资源，而不是只看浏览器已有缓存。保留地图署名与数据来源要求。

地图设计器保存与运行态加载也不是同一动作。本次实现有保存校验和文件变更检查，失败时应处理错误后重开；不能在两个会话之间盲目覆盖。源码已有能力不代表旧现场包已经部署，交付时记录插件版本。

5. 场景发布应保证工程与资源成套

发布包至少考虑工程文件、模型/材质/纹理、地图包、图标、绑定映射及适用插件版本。采用资源版本或内容摘要可以帮助判断缓存与不完整部署。

演示流程为：

测试环境导入资源 → 检查对象 ID 和通道映射 → 校验资源引用、质量和权限 → 发布完整版本 → 运行页面按支持方式重新加载 → 保留上一个可用版本

只修改场景通常不需要重启设备采集线路，但是否需要 Web 重启、页面重载或清理缓存，应按插件加载机制判断。不能将“采集不用停”扩大成“所有场景永远无感热更新”。

三维动画还需控制帧率、资源大小和页面卸载时的 WebGL/事件资源释放。模型越精细不一定越适合长时间值班监视，应在目标终端测试。

示意图用于说明空间呈现，不代表图中位置与数据属于本篇演示设备。

6. 验收从“位置正确”走到“状态可信”

最后让一个状态通道依次经历运行、停止、故障和无效，记录地图与三维是否给出一致解释；再发布一次资源新版本并回滚。比单纯旋转模型更能证明这个页面具备可维护的监视能力。

相关：大屏批量数据与质量、图元与移动端。

Rapid SCADA 中文网站：rapidscada.com.cn。