Module smartCORE Geofencing
Description
Le module « geofencing » vérifie en continu, à partir des données de position GPS, si le système se trouve dans une zone géographique contenue dans une configuration. Dès qu'il détecte que l'appareil se trouve à l'intérieur de coordonnées géographiques préalablement configurées, les données de cette zone (ID et nom de l'entrée de la configuration) sont enregistrées dans les données de mesure et peuvent être envoyées à un cloud. D'autres actions, comme l'envoi d'un e-mail ou d'un SMS, peuvent ainsi être déclenchées.
Le module n'enregistre pas lui-même de données GPS, mais accède aux données de signaux du pool de données smartCORE. Dans la configuration du module, il faut donc saisir les noms des signaux contenant les informations GPS (latitude, longitude). Les sources typiques de données GPS sont le module GPS ou des sources externes fournies via le CAN bus ou d'autres protocoles.
Configuration JSON
La section suivante décrit l'ensemble de la configuration JSON d'un module Geofence et explique les différentes zones et les différents paramètres.
Types de geofence
Il existe deux types de zones de geofence utilisables dans la configuration.
- Cercle
- Polygone
Les deux types ont trois paramètres communs qui doivent être renseignés :
- "id"
- "name"
- "description"
Lorsque le franchissement d'une limite géolocalisée est détecté, ces données sont enregistrées dans les données de mesure. Le module reconnaît, d'après le nombre de coordonnées, s'il s'agit d'un cercle ou d'un polygone. Un cercle n'a toujours qu'une seule coordonnée, un polygone en a toujours au moins trois. Des polygones comptant jusqu'à 20 coordonnées ont été testés. Si une entrée ne comporte que deux coordonnées, elle est ignorée et non prise en compte.
Cercle
Pour définir un cercle, il suffit de saisir la coordonnée GPS qui sert de centre du cercle. Le rayon (en km) peut être saisi comme paramètre supplémentaire. Si le rayon n'est pas indiqué, la valeur par défaut de 0.5 km (500 mètres) est utilisée.
Ci-après, une zone de geofence est définie comme un cercle d'un rayon de 900 mètres.
{
"id": 1,
"name": "AA",
"description": "Hmb-Altona",
"radius":0.9,
"choords": [
{
"latitude": 53.552695,
"longitude": 9.935175
}
]
}
Polygone
En saisissant plusieurs coordonnées (au moins trois !), on peut définir un polygone. L'ordre dans la configuration est très important, car chaque coordonnée est toujours reliée à la suivante. La première et la dernière coordonnée ne doivent pas être identiques ; le logiciel relie automatiquement ces deux points lors du calcul.
{
"id": 111103,
"name": "Bhbf",
"description": "Berlin",
"choords": [
{
"latitude": 53.552695,
"longitude": 9.935175
},
{
"latitude": 53.552691,
"longitude": 9.935172
},
{
"latitude": 53.552690,
"longitude": 9.935178
}
]
}
Exemple de configuration complète (minimale)
La configuration suivante utilise les réglages minimaux et deux geofences sont définis dans la zone « stations ».
{
"module": "Geofencing",
"factory": "geofencing",
"config": {
"timeoutMs": 2000,
"gpsSatCountName": [
"GPS.SatelliteCount",
"Colibri.SatelliteCount"
],
"minimalAvailableSatCount": 6,
"gpsLocationName": "GPS.Location",
"longitudeName": "DBC.longitude",
"latitudeName": "DBC.latitude",
"stations": [
{
"id": 1,
"name": "AA",
"description": "Hmb-Altona BP",
"radius":0.9,
"choords": [
{
"latitude": 53.552695,
"longitude": 9.935175
}
]
},
{
"id": 2,
"extNr": 8000011201,
"name": "AAG",
"description": "Ascheberg/Holst BP",
"choords": [
{
"latitude": 54.148462,
"longitude": 10.339481
}
]
}
]
}
}
Exemple de configuration complète avec fichier de geofence externe
Il est également possible de stocker les stations de geofence dans un fichier externe. Le chemin du fichier doit alors être saisi dans le champ « stationsFile » de la configuration.
{
"module": "Geofencing",
"factory": "geofencing",
"config": {
"timeoutMs": 2000,
"minimalAvailableSatCount": 6,
"gpsSatCountName": [
"GPS.SatelliteCount",
"Colibri.SatelliteCount"
],
"gpsLocationName": "GPS.Location",
"longitudeName": "DBC.longitude",
"latitudeName": "DBC.latitude",
"stationsFile":"/sdi/config/geofence_stations.json",
"stations": [
]
}
}
Structure du fichier externe
La structure du fichier externe, saisi dans le champ de configuration « stationsFile », est décrite ci-après. Le champ « file_version » permet de saisir une désignation de version, qui peut également être envoyée au cloud si nécessaire. Dans la zone « geofence_stations », on saisit les zones de geofence, comme dans le champ « stations » du fichier de configuration smartCORE.
{
"file_version":"Dateiversion 1.0",
"geofence_stations": [
{
"id": 111101,
"name": "AA",
"description": "Hmb-Altona",
"choords": [
{
"latitude": 53.552695,
"longitude": 9.935175
}
]
},
{
"id": 111103,
"name": "Bhbf",
"description": "Berlin",
"choords": [
{
"latitude": 53.552695,
"longitude": 9.935175
},
{
"latitude": 53.552691,
"longitude": 9.935172
},
{
"latitude": 53.552690,
"longitude": 9.935178
}
]
},
{
"id": 111104,
"name": "AEC",
"description": "Eckernfoerde Bstg",
"choords": [
{
"latitude": 54.4676,
"longitude": 9.835115
},
{
"latitude": 54.4675,
"longitude": 9.835114
},
{
"latitude": 54.4677,
"longitude": 9.835125
},
{
"latitude": 54.46761,
"longitude": 9.835112
},
{
"latitude": 54.4675,
"longitude": 9.835113
},
{
"latitude": 54.4678,
"longitude": 9.835112
}
]
}
]
}
Liste des paramètres
| Nom du paramètre | Requis | Type de données | Plage de valeurs pertinente | Défaut | Description |
|---|---|---|---|---|---|
| timeoutMs | Non | INT | 1000 - 10000 | 2000 | Intervalle d'exécution du contrôle visant à déterminer si les coordonnées GPS actuelles se trouvent dans une zone de geofence. |
| stations | Non | Array | - | - | Contient les définitions des zones de geofence. |
| stationsFile | Non | String | "" | "" | Chemin du fichier JSON externe contenant les zones de geofence. Permet de déporter les zones de geofence dans un fichier externe afin de garder la configuration smartCORE compacte et claire. |
| channelNameLocationID | Non | String | "" | [nom du module].LocationID | Ce paramètre permet de modifier le nom du signal contenant l'ID de la zone de geofence. Ce nom de signal apparaît tel quel dans les données de mesure. Il est recommandé d'utiliser les réglages par défaut. |
| channelNameLocationName | Non | String | "" | [nom du module].LocationName | Ce paramètre indique le nom du signal contenant la description (champ « description ») de la zone de geofence. Ce nom de signal apparaît tel quel dans les données de mesure. Il est recommandé d'utiliser les réglages par défaut. |
| gpsSatCountName | Oui | Array | - | - | Contient un ou plusieurs noms de signaux du pool de données qui contiennent le nombre actuel de satellites du signal GPS. Si plusieurs noms sont indiqués, le signal disponible et fournissant des données est utilisé. Le signal utilisé est donc déterminé automatiquement. |
| minimalAvailableSatCount | Non | INT | 3-15 | 5 | Nécessaire pour la plausibilisation du signal GPS. Nombre minimal de satellites devant être présents dans un signal de « gpsSatCountName » pour que les données GPS soient valides. |
Paramètres d'une station
| Nom du paramètre | Requis | Type de données | Plage de valeurs pertinente | Défaut | Description |
|---|---|---|---|---|---|
| id | Oui | INT | 1 - 10000 | - | Doit être unique dans la configuration. Ce numéro est écrit dans les données de mesure ou envoyé à un cloud. |
| name | Oui | String | "" | "" | Abréviation/forme courte du nom de la zone de geofence. |
| description | Oui | String | "" | "" | Nom complet de la zone de geofence. Est enregistré dans les données de mesure et transmis au cloud. |
| radius | Oui | Double | 0.1 - 10 | 0.5 | N'est pris en compte que pour les zones définies comme cercle. Le rayon est indiqué en km. |
| choords | Oui | Array | - | - | Zone contenant la coordonnée (cercle) ou les coordonnées (polygone). |
Signaux générés (Producer)
Les signaux suivants sont générés par le module Geofence et enregistrés dans le pool de données du smartCORE. Ces signaux peuvent ensuite être enregistrés dans les données de mesure et envoyés au cloud. Les noms des signaux peuvent être adaptés dans la configuration (champs « channelNameLocationID » et « channelNameLocationName »). Côté cloud, ces signaux peuvent ensuite être utilisés dans des tâches de surveillance et d'alerte.
| Nom du signal | Type de données | Description |
|---|---|---|
| [nom du module].LocationName | String | Ce signal enregistre la description (champ « description ») de la zone de geofence dès que les coordonnées GPS actuelles se trouvent dans l'une des zones de geofence. Si les coordonnées GPS actuelles ne se trouvent dans aucune zone, la valeur est une chaîne vide. |
| [nom du module].LocationID | INT | Ce signal enregistre l'ID (champ « id ») de la zone de geofence dans laquelle se trouvent les coordonnées GPS actuelles. Si les coordonnées GPS actuelles ne se trouvent dans aucune zone, la valeur est -1. |
| [nom du module].Valid | Bool | Indique si les coordonnées GPS actuelles sont valides ou non. |
| [nom du module].Fileversion | String | Ce signal contient le contenu de l'entrée « file_version » du fichier externe. |
Informations sur le module
| Information | Valeur |
|---|---|
| Auteur | optiMEAS GmbH |
| depuis smartCORE | 2.2 |
| Type de module | Producer et Consumer |
| Dépendances | AUCUNE |