Ctrl+K

Datastream

Datastream#

1. Définition#

Un datastream représente un flux de données regroupant une collection d’observations mesurant la même propriété observée et produites par le même capteur.

Tip

Dans le cas d’un observatoire, ce flux de données fait souvent référence à une valeur physique mesurée émise par un capteur ou une centrale de mesure.

2. Propriétés#

Un datastream possède des paramètres obligatoires et des propriétés optionnelles.

Nom

Définition

Format

Exigences

name

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

Chaine de caractères

Obligatoire

description

Courte description du datastream.

Chaine de caractères

Obligatoire

unitOfMeasurement

Un objet JSON contenant trois paires clé-valeur. La propriété name présente le nom complet de l’unité de mesure ; la propriété symbol indique la forme textuelle du symbole de l’unité ; et la propriété definition contient l’URI définissant l’unité de mesure.

JSON Object

Obligatoire

observationType

Le type d’observation (avec un type de résultat unique) utilisé par le service pour coder les observations.

ValueCode

Obligatoire

properties

Objet JSON contenant les propriétés annotées par l’utilisateur sous forme de paires clé-valeur.

Objet JSON

Optionnel

observedArea

Etendue spatiale de toutes les FeaturesOfInterest appartenant aux observations associées à ce flux de données. Zone géographique

GM_Envelope (GeoJSON Polygon)

Optionnel

phenomenonTime

Intervalle temporel des temps de phénomène de toutes les observations appartenant à ce flux de données.

TM_Period (ISO 8601 Time Interval)

Optionnel

resultTime

L’intervalle temporel des temps de résultat de toutes les observations appartenant à ce flux de données.

TM_Period (ISO 8601 Time Interval)

Optionnel

2.1. name (obligatoire)#

Le champ name décrit de façon unique et simple un flux de données.

Recommandations

Dans le cas d’un observatoire, il fait référence à la variation d’une variable d’observation (ex. : grandeur physique)

Exemples

  • Outlet Exutoire_OTT Thalimede_stream level, ici est fait référence au niveau d’eau mesuré par un capteur OTT Thalimed position sur un exutoire.

2.2. description (obligatoire)#

Le champ description contient une courte description le datastream.

Recommandations

  • Un peu à l’image de name mais plus détaillé.

2.3. unitOfMeasurement (obligatoire)#

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

Recommandations

  • L’ojet JSON peut comporter le nom de l’unité mesurée, le symbole en SI et un lien vers un thésaurus.

Exemples

  • ORE AgrHyS

{
"unitOfMeasurement": {
    "name": "mètre",
    "symbol": "m",
    "definition": "https://www.bipm.org/en/si-base-units/metre"
}

2.4. observationType (obligatoire)#

Le champ observationType est un code prédéfini du type d’observation (avec un type de résultat unique), qui est utilisé par le service pour coder les observations.

Recommandations

  • Dans le cas d’un observation, OM_Measurement et OM_Observation sont généralement utilisés. Voir tableau des codes.

2.5. properties (optionnel)#

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

2.6. observedArea (optionnel)#

Le champ observedArea permet de définir une zone géographique selon un polygone au format GeoJSON.

2.7. phenomenonTime (optionnel)#

Le champ phenomenonTime est un intervalle de temps.

2.8. resultTime** (optionnel)#

Le champ resultTime est un intervalle de temps.

3. Exemples de Datastream#

{
  "@iot.selfLink": "https://sensorthings.geosas.fr/agrhys/v1.1/Datastreams(1)",
  "@iot.id": 1,
  "name": "Outlet E30_OTT Thalimede_stream level",
  "description": "Outlet E30 stream level",
  "observationType": "http://www.opengis.net/def/observationType/OGC-OM/2.0/OM_Measurement",
  "unitOfMeasurement": {
    "name": "mètre",
    "symbol": "m",
    "definition": "https://www.bipm.org/en/si-base-units/metre"
  },
  "observedArea": null,
  "phenomenonTime": "2001-09-07T09:00:00Z/2024-06-26T12:00:00Z",
  "resultTime": "2001-09-07T09:00:00Z/2024-06-26T12:00:00Z",
  "properties": null,
  "Thing@iot.navigationLink": "https://sensorthings.geosas.fr/agrhys/v1.1/Datastreams(1)/Thing",
  "Sensor@iot.navigationLink": "https://sensorthings.geosas.fr/agrhys/v1.1/Datastreams(1)/Sensor",
  "ObservedProperty@iot.navigationLink": "https://sensorthings.geosas.fr/agrhys/v1.1/Datastreams(1)/ObservedProperty",
  "Observations@iot.navigationLink": "https://sensorthings.geosas.fr/agrhys/v1.1/Datastreams(1)/Observations",
  "FeatureOfInterest@iot.navigationLink": "https://sensorthings.geosas.fr/agrhys/v1.1/Datastreams(1)/FeatureOfInterest"
}
Contents