引言
GPS Geofencing Events 是 ThingsBoard 规则链中的一个重要节点,用于处理基于地理位置的事件。通过这个节点,可以定义地理围栏(Geofence),并检测设备是否进入或离开这些围栏区域。
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. 总结
标签:name,Geofencing,Events,围栏,ThingsBoard,节点,GPS From: https://blog.csdn.net/2401_85648342/article/details/143359096GPS Geofencing Events 节点在 ThingsBoard 规则链中是一个非常强大的工具,可以帮助你基于地理位置进行监控和管理。通过合理地使用这个节点,你可以更好地管理和自动化系统中的各种操作。无论是在物流跟踪、资产管理、安全监控还是农业监测等方面,GPS Geofencing Events 节点都能发挥重要作用。