本篇完成什么以一个虚构站点和泵模型为例建立空间、设备和通道的映射排查位置偏移、着色错误、离线底图和发布版本问题。地图能加载、模型能旋转只证明空间资源可展示。要让它成为运行监视页还需要稳定设备身份、正确坐标、有效数据和清楚的未知状态。模型始终是绿色有时只因为默认材质是绿色。本文按本项目地图/三维扩展说明集成方法不同插件的工程格式、资源路径与发布方式不同。下面的 JSON 是映射设计示意不是可直接上传的.map或三维工程完整 schema。1. 空间位置与设备身份分别管理字段演示用途业务设备键DEMO-PUMP-A对应设备资产地图要素 IDfeature-pump-a在地图工程定位图形三维节点 IDnode-pump-a在模型或映射表定位对象状态通道4102运行反馈故障通道4103故障反馈权限对象项目配置的对象服务端限制可访问范围名称用于显示稳定 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. 验收从“位置正确”走到“状态可信”现象或用例检查全部站点偏移坐标体系、转换和底图单个点位置异常经纬顺序、原始数据和精度模型有动画却设备停机默认动画、通道映射、质量优先级模型升级后设备颜色串了节点 ID、名称和映射版本联网正常、断网空白在线依赖、离线包及字体/纹理资源保存后运行页没变化发布目标、加载方式和缓存版本管理员正常、普通账号异常对象权限、资源读取与 API 校验最后让一个状态通道依次经历运行、停止、故障和无效记录地图与三维是否给出一致解释再发布一次资源新版本并回滚。比单纯旋转模型更能证明这个页面具备可维护的监视能力。相关大屏批量数据与质量、图元与移动端。Rapid SCADA 中文网站rapidscada.com.cn。
