3D Fence 空间计算实战:在火山引擎实时流上搭建立体围栏检测链路

传统 2D 地理围栏只校验 XY 平面经纬度,缺少高度维度,在无人机、低空飞行器、塔吊立体管控场景误报很高。本文介绍 3D Fence 三维电子围栏的原理,基于火山引擎实时计算 Flink 版、ByteHouse、IoT 平台搭建一套带 Z 轴高度约束的立体围栏实时检测方案,包含三维围栏建模、空间相交判断、轨迹降噪、告警防抖,同时探索如何把这套空间能力封装成可复用的 Agent 工具,供业务侧调用。适合低空管控、智慧工地、立体仓储等场景。 关键词:3D Fence、三维地理围栏、空间计算、实时计算、低空感知、Agent 工具

一、什么是 3D Fence(三维电子围栏)

普通 GeoFence(二维围栏):划定平面多边形,仅判断目标经纬度是否落在区域内,没有高度信息。 3D Fence(三维电子围栏):在平面多边形基础上增加 Z 轴上下限,形成一个封闭立体空间(垂直棱柱、不规则多面体)。 判定规则:目标点位 (x,y,z) 同时满足平面在围栏内 + 高度落在设定区间,才判定闯入围栏。

举业务例子:园区低空禁飞区,平面范围固定,限制高度 0–100m;无人机飞到平面内 120m 高度,不会触发告警;无人机在范围内、高度 60m,触发告警。

区分:3D Fence 是软件定义的空间边界,不是实体物理围栏。

二、2D 围栏的痛点,为什么需要 3D Fence

  1. 无法区分高低空,飞鸟、高空飞行器会大量产生无效告警,误报率高
  2. 塔吊、高层楼宇、山地场站、低空试飞场景天然需要三维空间约束
  3. 普通数据库缺少原生三维空间算子,高频轨迹下实时相交计算性能差
  4. 业务侧需要把围栏能力封装成工具,给 Agent 调用,实现自然语言查询围栏、动态修改围栏

三、整体架构(火山引擎产品栈,社区加分项)

链路:IoT 终端上报 GNSS + 高度数据 → 火山引擎 IoT 平台接入、协议解析 → 实时计算 Flink 消费流数据,做轨迹清洗、滤波、缓存围栏模型 → ByteHouse 存储围栏模型、执行三维空间相交判断 → 消息队列 VolcMQ 分发告警 → 可视化(DataWind)展示围栏与轨迹;额外:将围栏查询、告警能力封装成 Agent 工具,接入火山方舟。

  • 火山引擎 IoT 平台:设备接入、时序位置上报、设备状态管理
  • 实时计算 Flink 版:流式轨迹处理、去抖动、告警防抖、围栏缓存(State),避免每一条轨迹都查库
  • ByteHouse:存储三维围栏、轨迹数据,支持空间函数,适合海量时序 + 空间数据
  • VolcMQ:告警消息解耦,推送业务系统
  • 火山方舟:把 3D 围栏能力封装成 Agent 工具,支持自然语言:“查询 A 园区当前告警”“把西区围栏高度改成 150m”
  • DataWind:三维可视化,渲染围栏、设备点位、告警事件

合规声明:本方案仅为技术实现演示,低空飞行器管控业务落地前,需要遵守民航、地方低空管理法规,完成相关备案;涉及人员轨迹采集,需要满足个人信息保护法规,做好脱敏。

四、3D Fence 建模与核心判断逻辑

4.1 两种建模方式

  1. 垂直棱柱围栏(优先推荐,工程最常用):底面是 2D 多边形,设置 z_min、z_max,向上拉伸成柱体,适合园区、机场、工地。
  2. 不规则多面体围栏:每个顶点独立 XYZ,适合山地、异形建筑、复杂地形。

4.2 核心判断逻辑

目标轨迹点:Point(x,y,z) 围栏立体对象:3D Polyhedron 判断:三维相交函数,判断点位是否在立体围栏内部。

2D 只做 XY 平面相交;3D 同时校验 XYZ 三维空间。

4.3 简化 SQL 示例(ByteHouse 空间函数演示)

-- 示例:构造一个多边形底面,高度区间0~100m的垂直围栏,判断点位是否在围栏内
SELECT 
    pointInPolygon3D(
        (116.40,39.90,70),
        [(116.39,39.89,0), (116.41,39.89,0), (116.41,39.91,0), (116.39,39.91,0), (116.39,39.89,0)],
        0,
        100
    ) AS is_alert;

注意:坐标坑点,必须统一坐标系(WGS84/GCJ02),轨迹和围栏坐标系不一致,直接导致计算失效。

五、Flink 实时链路优化要点

  1. 轨迹降噪:GNSS 点位抖动,增加速度过滤、距离滤波,过滤漂移点
  2. 围栏本地缓存:围栏配置变更频率很低,放到 Flink State 缓存,减少 ByteHouse 查询压力
  3. 告警防抖:单点闯入不告警,连续 N 个采样点都命中围栏才输出告警,降低误报
  4. 流量分流:正常轨迹、告警轨迹分开输出,控制下游吞吐

六、Agent 工具封装(适配火山引擎 Agent 社区特色,这是和阿里云版本最大区别)

这是本篇文章重点亮点,非常贴合 Agent 赛道: 我们可以把 3D Fence 能力封装成 Function Call 工具,注册到火山方舟 Agent:

  • 工具 1:create_3d_fence,创建三维围栏(传入多边形点位、高度区间、围栏名称)
  • 工具 2:query_fence_alert,查询指定围栏实时告警
  • 工具 3:modify_fence_z_range,修改围栏高度上下限
  • 工具 4:check_point_in_3d_fence,输入点位 XYZ,判断是否在围栏内

业务人员直接用自然语言和 Agent 交互,不需要写 SQL、调接口。

示例对话: 用户:帮我看一下一号园区今天有没有无人机闯入 3D 围栏告警 Agent:调用 query_fence_alert 工具,查询一号园区告警,返回结果并整理成自然语言回答

七、落地踩坑总结(社区最喜欢的干货部分)

  1. 坐标系不统一:轨迹和围栏用不同坐标系,三维计算完全不准,建议入库统一转换
  2. GPS 高度误差:低成本 GNSS 高度误差大,单纯 Z 轴不可靠,优先 RTK 或者融合气压计
  3. 实时性能瓶颈:高频上报场景,不要每条轨迹都查库,优先 Flink State 缓存围栏
  4. Agent 工具边界:围栏属于管控能力,工具增加权限校验,不是所有人都能修改围栏参数
  5. 时序数据冷热分离:历史轨迹归档,实时告警热数据单独存储,降低查询成本

八、适用场景

园区低空无人机管控、智慧工地塔吊禁入区、光伏场站立体安防、无人机试飞试验区、立体仓储区域管控。

九、总结

3D Fence 补齐了传统地理围栏缺少高度维度的短板,是低空空间感知的核心能力。依托火山引擎实时计算 Flink、ByteHouse 空间能力,同时把围栏能力封装成可调用的 Agent 工具,让业务可以通过自然语言交互管理立体围栏,不用重复开发空间计算逻辑。在低空经济快速发展的背景下,这类空间感知 Agent 工具会有更多落地空间。

文末

本文为技术方案分享,欢迎大家在评论区交流空间计算、实时围栏、火山方舟 Agent 工具调用的落地经验。

0
0
0
0
评论
未登录
暂无评论