Ctrl+K

Thing

Thing#

1. Définition#

Une Thing est comme 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.

Tip

Dans le cas d’un observatoire, tout dépend du grain de précision souhaité, une Thing peut faire référence à :

  • un point ou une zone de mesure,

  • une centrale de mesure,

  • un capteur,

  • …

2. Propriétés#

Une Thing possède des paramètres obligatoires et des propriétés optionnelles.

Nom

Définition

Format

Exigences

name

Étiquette correspondant à une Thing, généralement un nom descriptif court.

Chaine de caractères

Obligatoire

description

Courte description de la Thing.

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

Optionnel

2.1. name (obligatoire)#

Le champ name correspond à une étiquette ou à un identifiant de la Thing, généralement sous la forme d’un nom descriptif court.

Recommandations

Il est recommandé de faire apparaitre le type du capteur ainsi que le nom du site.

Exemples

  • Station météo Campbell EFELE

  • Naizin Kervidy Exutoire

2.2. description (obligatoire)#

Le champ description contient une courte description de la Thing.

Recommandations

  • Il est recommandé d’expliciter la Thing, pour éviter l’utilisattion d’acronymes.

Exemples

  • description”: “Station météo Campbell personnalisée, équipée du data logger Campbell CR1000”

  • Exutoire du bassin versant de Kervidy à Naizin

2.3. properties (optionnel)#

Le champ properties est un objet JSON (paires clé-valeur). Elles sont définies à la conception et permettent de mieux caractériser une Thing.

Recommandations

Note

Le standard SensorThings ne donne aucune indication concernant les noms des propriètés que l’on peut associer à l’objet Things. On peut donc considérer que le choix de ces noms de propriètés est totalement libre. Cependant, il y a un intérêt à opter pour des noms admis par la communauté du web. Par exemple, schema.org ou W3C proposent des vocabulaires couvrant les entités, les relations entre les entités et les actions pouvant être utlisés comme des propriètés des objets SensorThings.

Exemples

  • Observatoire urbain de Beauregard à Rennes

Pour cet observatoire, les propriètés elevation et image ont été choisies dans les vocabulaires décrits dans https://schema.org.

"properties": {
        "elevation": 55.6,
        "image": "https://geosas.fr/cityorchestra/img/pdm/ST1-1.jpg"
}

Dans les 2 exemples suivants, les noms de propriètés ont été choisis librement.

  • SOERE PRO EFELE

 "properties": {
  "projet": "https://geosas.fr/web/?page_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

 "properties": {
  "region": "B_Naizin",
  "domaine": "NAIZIN",
  "station": "KERVIDY_B_EXU"
}

3. Exemples#

Cet exemple montre le contenu intégral d’une thing après injection dans le service SensorThings. Seuls les champs name, description et proriètés ont été renseignés par l’opérateur. Tous les autres champs @iot.id, @iot.selfLink, Locations@iot.navigationLink, HistoricalLocations@iot.navigationLink, Datastreams@iot.navigationLink et Datastreams@iot.navigationLink ont été générés automatiquent par le service.

{
  "@iot.id": 1
  "@iot.selfLink": "https://sensorthings.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/?page_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://sensorthings.geosas.fr/efele/v1.0/Things(1)/Locations",
  "HistoricalLocations@iot.navigationLink": "https://sensorthings.geosas.fr/efele/v1.0/Things(1)/HistoricalLocations",
  "Datastreams@iot.navigationLink": "https://sensorthings.geosas.fr/efele/v1.0/Things(1)/Datastreams",
  "MultiDatastreams@iot.navigationLink": "https://sensorthings.geosas.fr/efele/v1.0/Things(1)/MultiDatastreams"
}
Contents