Définition
L’API SensorThings de l’OGC suit la définition de l’UIT-T, c’est-à-dire qu’en ce qui concerne l’Internet des objets, une « Things » est un objet du monde physique (objets physiques) ou du monde de l’information (objets virtuels) qui peut être identifié et intégré dans des réseaux de communication [UIT-T Y.2060].
Propriètés
Chaque « Things » DOIT avoir les propriétés obligatoires et PEUT avoir les propriétés optionnelles dans le tableau 1.
| Nom | Définition | Format | Cardinalité |
|---|---|---|---|
| name | Étiquette correspondant à une « Things », généralement un nom descriptif. | Chaine de caractères | Obligatoire |
| description | Courte description de la « Things ». | Chaine de caractères | Obligatoire |
| properties | Objet JSON contenant les propriétés annotées par l’utilisateur sous forme de paires clé-valeur. | Objet JSON | Optionnelle (0 ou 1) |
Propriété « name »
Le champ « name » correspond à une étiquette/un identifiant de la « Things », généralement sous la forme d’un nom descriptif.
Recommandations
- Il est recommandé de faire apparaitre le type du capteur ainsi que le nom du site.
Exemples à suivre
Propriété « description »
Le champ « description » contient une courte description de la « Things ».
Recommandations
- Il est recommandé de faire apparaitre …
Exemples à suivre
- Station météo Campbell personnalisée, équipée du data logger Campbell CR1000
- Exutoire du bassin versant du Puits
- Exutoir à Naizin Kervidy
Propriété « properties »
Le champ « properties » est un objet JSON contenant les propriétés annotées par l’utilisateur sous forme de paires clé-valeur.
Recommandations
- Il est recommandé de faire apparaitre …
Exemples à suivre
SOERE PRO EFELE
{
projet: "https://geosas.fr/web/$1page_id=2476",
"manuel d'utilisation": "https://s.campbellsci.com/documents/fr/product-brochures/b_cr1000.pdf",
"date de mise en place": "Septembre 2013"
}
ORE AgrHyS
{
region: "B_Naizin",
domaine: "NAIZIN",
station: "KERVIDY_B_EXU"
}
Relations
Une « Things » DOIT avoir des relations directes avec les autres d’entités énumérés dans le tableau 2. :
| Type d’entité | Relation | Description |
|---|---|---|
| Location | 1,1 | Une « Location » localise une « Things ». Plusieurs « Things » peuvent être situées sur une même « Location ». Une « Things » PEUT ne pas avoir de « Location ». Une « Things » DEVRAIT avoir un seule « Location ». |
| HistoricalLocation | 0,N | Une « Things » a de 0 à N « HistoricalLocations ». Une « HistoricalLocation » a une et une seule « Things ». |
| Datastream | 0,N | Une « Things » PEUT avoir de 0 à N « Datastreams ». |
Exemples de « Things »
{
@iot.id: 1
@iot.selfLink: "https://api.geosas.fr/efele/v1.0/Things(1)",
name: "Station météo Campbell EFELE",
description: "Station météo Campbell personnalisée, équipée du data logger Campbell CR1000 ",
properties: {
projet: "https://geosas.fr/web/$1page_id=2476",
"manuel d'utilisation": "https://s.campbellsci.com/documents/fr/product-brochures/b_cr1000.pdf",
"date de mise en place": "Septembre 2013"
}
Locations@iot.navigationLink: "https://api.geosas.fr/efele/v1.0/Things(1)/Locations",
HistoricalLocations@iot.navigationLink: "https://api.geosas.fr/efele/v1.0/Things(1)/HistoricalLocations",
Datastreams@iot.navigationLink: "https://api.geosas.fr/efele/v1.0/Things(1)/Datastreams",
MultiDatastreams@iot.navigationLink: "https://api.geosas.fr/efele/v1.0/Things(1)/MultiDatastreams"
}