ThingsBoard规则链节点：GPS Geofencing Events节点详解

引言

1. GPS Geofencing Events 节点简介

2. 节点配置

3. 使用场景

3.1 物流跟踪

3.2 资产管理

3.3 安全监控

3.4 农业监测

4. 实际项目中的应用

4.1 项目背景

4.2 项目需求

4.3 实现步骤

5. 总结

---

引言

GPS Geofencing Events 是 ThingsBoard 规则链中的一个重要节点，用于处理基于地理位置的事件。通过这个节点，可以定义地理围栏（Geofence），并检测设备是否进入或离开这些围栏区域。

ThingsBoard从入门到实战课程，深入透析底层原理，快速搭建自己的IOT平台_哔哩哔哩_bilibiliThingsBoard从入门到实战课程，深入透析底层原理，快速搭建自己的IOT平台共计33条视频，包括：1、ThingsBoard项目介绍、2、ThingsBoard前端Vue版本代码编译、3、ThingsBoard本地后端源码编译等，UP主更多精彩视频，请关注UP账号。https://www.bilibili.com/video/BV1CH36egEDM/?spm_id_from=333.999.0.0 

1. GPS Geofencing Events 节点简介

GPS Geofencing Events 节点的主要作用是根据设备的位置数据，判断设备是否进入或离开预定义的地理围栏区域，并触发相应的事件。这种功能在物流跟踪、资产管理、安全监控等领域非常有用。

2. 节点配置

• Geofences：定义一个或多个地理围栏区域。每个地理围栏由一个名称和一组多边形坐标组成。
• Event Types：选择需要触发的事件类型，如 ENTER 和 LEAVE。
• Device ID or Device Attribute：指定用于获取设备位置信息的设备ID或设备属性。
• Output Metadata：设置输出消息的元数据，以便后续节点使用。

3. 使用场景

GPS Geofencing Events 节点在多种场景下都非常有用，特别是在需要基于地理位置进行监控和管理时。以下是一些具体的应用场景：

3.1 物流跟踪

在物流行业中，可以通过地理围栏来监控货物的运输情况。例如：

• 当货车进入某个仓库区域时，触发入库事件。
• 当货车离开某个仓库区域时，触发出库事件。

{"geofences": [{"name": "Warehouse A","coordinates": [[37.7749, -122.4194],[37.7750, -122.4195],[37.7751, -122.4196],[37.7752, -122.4197]]}],"eventTypes": ["ENTER", "LEAVE"],"deviceId": "${device.id}","outputMetadata": {"geofenceName": "${geofence.name}","eventType": "${event.type}"}
}

3.2 资产管理

在资产管理中，可以通过地理围栏来监控重要资产的位置。例如：

• 当贵重设备被移动到未经授权的区域时，触发警报。
• 当设备从维修区域返回到正常工作区域时，记录维护完成事件。

{"geofences": [{"name": "Authorized Area","coordinates": [[37.7749, -122.4194],[37.7750, -122.4195],[37.7751, -122.4196],[37.7752, -122.4197]]},{"name": "Maintenance Area","coordinates": [[37.7755, -122.4198],[37.7756, -122.4199],[37.7757, -122.4200],[37.7758, -122.4201]]}],"eventTypes": ["ENTER", "LEAVE"],"deviceId": "${device.id}","outputMetadata": {"geofenceName": "${geofence.name}","eventType": "${event.type}"}
}

3.3 安全监控

在安全监控中，可以通过地理围栏来监控人员或车辆的活动。例如：

• 当有人进入禁区时，触发警报。
• 当有车辆离开停车场时，记录离场时间。

{"geofences": [{"name": "Restricted Area","coordinates": [[37.7749, -122.4194],[37.7750, -122.4195],[37.7751, -122.4196],[37.7752, -122.4197]]},{"name": "Parking Lot","coordinates": [[37.7755, -122.4198],[37.7756, -122.4199],[37.7757, -122.4200],[37.7758, -122.4201]]}],"eventTypes": ["ENTER", "LEAVE"],"deviceId": "${device.id}","outputMetadata": {"geofenceName": "${geofence.name}","eventType": "${event.type}"}
}

3.4 农业监测

在农业领域，可以通过地理围栏来监控牲畜的活动范围。例如：

• 当牲畜进入或离开特定区域时，记录其活动轨迹。
• 当牲畜离开放牧区域时，发送通知给农场主。

{"geofences": [{"name": "Grazing Area","coordinates": [[37.7749, -122.4194],[37.7750, -122.4195],[37.7751, -122.4196],[37.7752, -122.4197]]}],"eventTypes": ["ENTER", "LEAVE"],"deviceId": "${device.id}","outputMetadata": {"geofenceName": "${geofence.name}","eventType": "${event.type}"}
}

4. 实际项目中的应用

下面是一个实际项目中的例子，展示如何在智能物流系统中使用 GPS Geofencing Events 节点。

4.1 项目背景

假设我们正在开发一个智能物流系统，该系统需要实时监控货车的位置，并在货车进入或离开仓库区域时触发相应的事件。此外，还需要记录货车的进出时间，并发送通知给相关人员。

4.2 项目需求

• 监控货车的位置。
• 当货车进入或离开仓库区域时，触发相应事件。
• 记录货车的进出时间。
• 发送通知给相关人员。

4.3 实现步骤

1. 定义地理围栏：
   • 创建一个地理围栏，表示仓库区域。

{"name": "Warehouse A","coordinates": [[37.7749, -122.4194],[37.7750, -122.4195],[37.7751, -122.4196],[37.7752, -122.4197]]
}

1. 创建规则链：

   • 添加 GPS Geofencing Events 节点，配置地理围栏和事件类型。
   • 添加后续节点，处理触发的事件，如记录时间和发送通知。

2. 配置规则链：

   • 配置 GPS Geofencing Events 节点，设置地理围栏和事件类型。

{"geofences": [{"name": "Warehouse A","coordinates": [[37.7749, -122.4194],[37.7750, -122.4195],[37.7751, -122.4196],[37.7752, -122.4197]]}],"eventTypes": ["ENTER", "LEAVE"],"deviceId": "${device.id}","outputMetadata": {"geofenceName": "${geofence.name}","eventType": "${event.type}"}
}

1. 处理事件：
   • 当货车进入仓库区域时，记录进入时间，并发送通知给相关人员。
   • 当货车离开仓库区域时，记录离开时间，并发送通知给相关人员。

// 进入仓库
{"type": "SEND_EMAIL","to": "[e-mail]","subject": "Truck Entered Warehouse A","body": "Truck with ID ${device.id} has entered Warehouse A at ${ts}."
}// 离开仓库
{"type": "SEND_EMAIL","to": "[e-mail]","subject": "Truck Left Warehouse A","body": "Truck with ID ${device.id} has left Warehouse A at ${ts}."
}

1. 前端界面：

   • 开发一个前端界面，显示货车的实时位置和历史轨迹。
   • 提供一个界面，让用户能够查看和管理地理围栏。

2. 数据查询：

   • 使用 ThingsBoard 的 REST API 或 GraphQL 查询，获取货车的历史轨迹和进出记录。

GET /api/plugins/telemetry/DEVICE/{deviceId}/values/timeseries?keys=latitude,longitude&startTs={startTimestamp}&endTs={endTimestamp}

5. 总结

GPS Geofencing Events 节点在 ThingsBoard 规则链中是一个非常强大的工具，可以帮助你基于地理位置进行监控和管理。通过合理地使用这个节点，你可以更好地管理和自动化系统中的各种操作。无论是在物流跟踪、资产管理、安全监控还是农业监测等方面，GPS Geofencing Events 节点都能发挥重要作用。