Go地理围栏核心是用github.com/paulmach/go.geo判断点是否在多边形内，需注意球面几何、顶点顺序、坐标顺序、状态缓存、空间索引优化及跨日期变更线处理。
Go 用 github.com/paulmach/go.geo 判断点是否在多边形内
地理围栏最核心的逻辑是「点是否在指定区域（通常是多边形）内」，Go 标准库不提供地理空间计算，得靠第三方库。目前最稳定、轻量且支持 GeoJSON 的是 github.com/paulmach/go.geo，它不依赖 CGO，适合嵌入设备端或边缘服务。
常见错误是直接用经纬度做欧氏距离判断——地球是球面，跨经度（如东经179°到西经179°）或高纬度区域会严重偏移。必须用球面几何算法，比如射线法（Ray Casting）或球面三角剖分。
-
geo.NewPolygon构建围栏时，顶点顺序必须是顺时针或逆时针闭合（首尾点不必重复），否则p.ContainsPoint可能返回错误结果 - 输入点用
geo.Point{Lat: 39.9042, Lon: 116.4074}，注意参数顺序是Lat在前、Lon在后，和常见地图 API（如 Google Maps）一致，但和某些 GPS 原始数据（lon, lat）相反 - 若围栏是圆形，别强行转成 32 边形多边形；用
geo.Distance算球面距离更准、更快
设备上报位置后实时触发围栏进出事件
设备通常通过 MQTT 或 HTTP 上报经纬度，服务端需低延迟判定并触发动作（如发告警、启停传感器）。关键不是“查一次”，而是“状态变化检测”——同一设备连续多次在围栏内，不应重复触发“进入”事件。
建议用内存 map 缓存设备最新状态：map[string]struct{ InFence bool; LastPoint geo.Point }，每次新位置来临时先比对距离与状态：
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
if !last.InFence && fence.ContainsPoint(newPoint) {
// 触发 enter 事件
} else if last.InFence && !fence.ContainsPoint(newPoint) {
// 触发 exit 事件
}
- 不要在每次请求里重建
geo.Polygon——它内部做了边预处理，应初始化一次复用 - 若设备移动慢（如物流车），可加时间窗口去抖：两次触发间隔至少 30 秒，避免 GPS 漂移导致反复进出
- MQTT 场景下，用 QoS 1 保送达，但业务层仍需幂等设计：事件 ID 去重或用 Redis SETNX 记录已触发的
device_id:fence_id:enter:ts
处理跨国际日期变更线或极地的围栏边界
当围栏横跨 IDL（如从美国关岛画到新西兰）或多边形包含北极点时，普通射线法会失效——经度突变导致边线被错误解析为绕地球一圈。
go.geo 默认不处理这类情况，需手动归一化坐标：
- 检测多边形最大最小经度差是否 > 180°，若是，将所有
Lon 的点 +360，统一转到 [0, 360) 区间再构建 <code>Polygon - 极地场景（纬度 > 85°）建议改用圆形围栏 +
geo.HaversineDistance，比多边形更鲁棒 - 生产环境务必用真实设备轨迹回放测试：找一段含 IDL 穿越的日志，喂给围栏逻辑，验证进出事件是否唯一、及时
性能瓶颈常出在并发多围栏匹配上
单设备可能属于多个围栏（如公司园区 + 城市行政区 + 高速路段），每条上报要遍历所有围栏调用 ContainsPoint。实测 100 个围栏 + 1 万设备/秒上报时，CPU 会卡在几何计算上。
优化路径很明确：用空间索引降维，而不是暴力循环：
- 引入
github.com/tidwall/rtree，把每个围栏的外接矩形（geo.Bound）插入 R-tree，先快速筛出「可能相交」的围栏集合（耗时从 O(n) 降到 O(log n)） - 外接矩形不能替代精确判断，筛选后仍需用
ContainsPoint二次确认，但候选集通常只剩 1~3 个 - 避免在 HTTP handler 里同步做全部计算；高吞吐场景下，把位置点发到异步队列（如 channel 或 Kafka），由 worker 池处理，防止阻塞连接
真正麻烦的是围栏动态更新——R-tree 不支持热更新。如果围栏配置频繁变更（如运营后台实时画圈），得用带版本号的双 buffer 结构，或直接换用支持在线更新的 github.com/llgcode/draw2d + 自定义网格哈希（按经纬度切 0.1° 网格，每个格子存围栏 ID 列表）。
