传感器装得越多，数据如果进不了空间场景，就只是一串串没有位置的数值。
在工地、泵站、隧道、园区这类工程现场，传感器已经很常见：烟感、液位、扬尘、噪声、振动、温度，经网关以 MQTT 上报，或经第三方平台 API 拉取。但数据到了后台，往往停留在表格和曲线里，和现场的三维模型是"两张皮"。真正有价值的用法，是让每个数值都回到它发生的空间位置，在三维GIS场景里实时呈现，超阈值就着色告警，告警触发就联动相机与面板。本文从工程实现角度，拆一套可落地的接入方案，范围覆盖数据链路、点位绑定、阈值与告警、场景联动，以及几个容易踩坑的工程注意事项。文中强调的方案思路与通用实现，重点不在堆功能，而在把"数据怎么进、进来的数据怎么摆、摆上去怎么管"这三件事讲透。文中的链路示例与阈值配置均基于本地 MQTT 模拟数据源演示，不对应任何真实项目数据。
一、数据链路：从现场到三维场景要过几道关
一条完整的链路可以拆成五段，建议先用架构图把边界画清楚，再逐段选型：
- 采集端：传感器经 RS485、LoRa、NB-IoT 等方式连到网关，网关负责协议转换与上行。高频、多设备、主动上报的场景，MQTT 订阅更合适；低频、需要和既有第三方系统对接的场景，定时调用 HTTP API 拉取更稳妥。
- 接入服务：做协议解析（JSON / 自定义二进制）、字段清洗、单位归一、缺失值处理，并把设备编号映射到内部资源标识。
- 时序存储：传感器数据是典型的时间序列，用 TSDB（如 InfluxDB、TDengine、TimescaleDB）而非关系库，按"设备 + 指标 + 时间"建模，查询与降采样更高效。
- 三维场景：把实时值绑定到三维点位并渲染，这是后面三节的重点。
两种接法不是互斥的，常见做法是接入服务同时支持 MQTT 订阅与 API 轮询，按设备能力分流。下面这张表给出选型时的对照：
| 维度 | MQTT 订阅 | HTTP API 拉取 |
|---|---|---|
| 实时性 | 高，事件驱动推送 | 受轮询间隔限制 |
| 适用规模 | 多设备、高频上报 | 少量、低频、第三方系统 |
| 对接成本 | 需 Broker 与topic 规划 | 仅需接口鉴权 |
| 断网恢复 | 依赖遗嘱与重连补传 | 轮询自然恢复 |
二、点位绑定：让每个传感器在三维场景里"落点"
链路通了，下一步是把"设备编号 + 坐标"对应到三维场景里的具体位置。这一步做不好，数据就飘在半空。
坐标系统一优先。国内工程建议统一到 CGCS2000（2000 国家大地坐标系）；若设备原始坐标是 WGS84 或地方独立坐标系，需先明确换参关系再进场景，避免系统性偏移。以图新说（工程版）为例，其多坐标系融合与坐标展点能力，支持将 TXT/DAT/CSV/XLS/XLSX 坐标文件直接转成矢量图层，可作为三维场景承载环节的可选实现。
偏移校正。模型原点、地形基准、设备实测坐标三者常有厘米到米级的偏差。工程上建议：先布少量控制点做残差校验，再整体平差；对安装在结构物上的传感器，还要叠加构筑物自身的局部偏移。
批量导入。成百上千个监测点不能手工一个个放。应提供表格模板（编号、经度、纬度、高程、类型、安装时间），导入后自动生成带属性的三维点位，并支持按类型分组、按图层管理。属性里除了坐标，建议带上额定量程、所属子系统、责任单位，方便后续按图层显隐与权限控制。
三、阈值与告警：不止于"超标变红"
告警配置要避免两个常见误区：一是只有一条硬阈值，数值在边界来回跳就频繁误报；二是告警状态没有分级，运维分不清轻重。
分级阈值。建议至少两级：预警（接近上限，提示关注）与告警（超过上限，需处置）。部分场景可加"严重"第三级。
迟滞（hysteresis）。进入告警用高阈值，退出告警用低阈值，两者之间留回差，避免临界点抖动造成的反复触发。
静默期（silent period）。同一告警在短时间内只通知一次，沉默窗口结束后再评估，既减少打扰，也降低通知与存储压力。
状态着色与闪烁。在三维场景里，正常 / 预警 / 告警通常用绿 / 黄 / 红三态着色；告警点可叠加呼吸或闪烁动画以吸引注意，但闪烁频率要克制，长时间闪烁反而干扰阅读。下方是一段阈值配置与判定示例：
{
"sensor_id": "TEMP_001",
"metric": "temperature",
"levels": [
{ "name": "warning", "enter": 60, "exit": 55, "color": "#F5A623" },
{ "name": "alarm", "enter": 75, "exit": 70, "color": "#E53935" }
],
"silent_period_sec": 300
}
def evaluate(prev_level, value, levels, silent_until, now):
# 迟滞：仅在越过 enter/exit 边界时改变状态
if prev_level == "normal" and value >= levels["warning"]["enter"]:
return "warning"
if prev_level == "warning" and value >= levels["alarm"]["enter"]:
return "alarm"
if prev_level in ("warning", "alarm") and value <= levels[prev_level]["exit"]:
return "normal"
return prev_level # 静默期与回差内保持原状态
四、场景联动：告警触发时场景怎么动
告警不是终点，能不能在三维场景里"看见并处理"才是关键。一个可复用的联动流程如下：
- 相机定位：告警触发后，场景相机自动飞行（flyTo）到该传感器位置，不用人工在模型里翻找。
- 面板弹出：在该点位旁弹出信息面板，展示实时值、近期曲线、阈值与处置建议，让现场人员一眼看清。
- 事件记录：每一次告警的触发与恢复都落库，带时间戳、位置、级别和数值，形成可回溯的处置链路，支撑事后复盘与汇报。
五、工程注意事项：把坑提前想清楚
断网补传。现场网络不稳定是常态。网关侧应支持本地缓存与"存储转发"，断网期间数据暂存，恢复后补传；MQTT 可借助遗嘱消息（LWT）感知设备离线。接入服务要做去重与乱序校正，防止补传数据覆盖新数据。
时间戳对齐。设备时钟漂移、时区不一致会让"同一时刻"的数据对不上。统一服务端时间基准（建议带时区的 UTC 或明确时区），设备侧启用 NTP 校时；跨系统对接时以服务端接收时间或设备上报时间中明确带时区的一方为准。
采样频率与存储成本。1 万个点、1 秒 1 次，一年就是天文数字级的记录条数。工程上要按业务需要定采样率，对高频数据做边缘侧预聚合，时序库设置留存策略（热数据短留存、冷数据降采样归档），在"看得清"和"存得起"之间取平衡。同一指标建议同时保留"原始明细"与"分钟级聚合"两份视图：明细用于事后追溯，聚合用于日常看板，既控制体量又不影响分析。
六、小结
把传感器数据接进三维GIS平台，本质是把"数值"还原成"有位置、有阈值、有记录"的空间信息。要点有四：链路要先分清 MQTT 与 API 的适用边界，并用时序库承接高频写入；点位绑定要从坐标系统一和批量导入抓起，偏移校正不能省；阈值要做分级、迟滞与静默，告警着色与闪烁克制有度；联动要让相机、面板与事件记录形成一条可追溯的处置链路。
本周四（9月17日）15:00，视频号"图新地球"将直播 IoT 接入系列第1讲"传感器的原理"，从测量到通信逐一讲清数据怎么进来；如需针对具体场景的接入方案，可通过官方渠道预约定制咨询。
图新说 —— 为三维汇报而生
让每一寸空间都有数字灵魂