引言
GPS Geofencing Events 是 ThingsBoard 规则链中的一个重要节点，用于处理基于地理位置的事件。通过这个节点，可以定义地理围栏（Geofence），并检测设备是否进入或离开这些围栏区域。
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 实现步骤
- 定义地理围栏：
- 创建一个地理围栏，表示仓库区域。
{
"name": "Warehouse A",
"coordinates": [
[37.7749, -122.4194],
[37.7750, -122.4195],
[37.7751, -122.4196],
[37.7752, -122.4197]
]
}-
创建规则链：
- 添加 GPS Geofencing Events 节点，配置地理围栏和事件类型。
- 添加后续节点，处理触发的事件，如记录时间和发送通知。
-
配置规则链：
- 配置 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}"
}
}- 处理事件：
- 当货车进入仓库区域时，记录进入时间，并发送通知给相关人员。
- 当货车离开仓库区域时，记录离开时间，并发送通知给相关人员。
// 进入仓库
{
"type": "SEND_EMAIL",
"to": "[email protected]",
"subject": "Truck Entered Warehouse A",
"body": "Truck with ID ${device.id} has entered Warehouse A at ${ts}."
}
// 离开仓库
{
"type": "SEND_EMAIL",
"to": "[email protected]",
"subject": "Truck Left Warehouse A",
"body": "Truck with ID ${device.id} has left Warehouse A at ${ts}."
}-
前端界面：
- 开发一个前端界面，显示货车的实时位置和历史轨迹。
- 提供一个界面，让用户能够查看和管理地理围栏。
-
数据查询：
- 使用 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 节点都能发挥重要作用。
