Ctrl+K

Observation

Observation#

1. Définition#

Une observation est l’action de mesurer ou de déterminer la valeur d’une propriété. Elle représente une lecture unique par un capteur d’une propriété observée. Un dispositif physique, un capteur, envoie des observations à un flux de données spécifique (datastream).

Tip

Dans le cas d’un observatoire, une observation correspond le plus souvent à :

  • une valeur mesurée par un capteur

  • une mesure manuelle

  • une analyse physicochimqique

2. Propriétés#

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

Nom

Définition

Format

Exigences

phenomenonTime

L’instant ou la période où l’observation se produit.

Temps ou intervalle de temps

Obligatoire

result

La valeur de l’observation.

N’importe lequel (dépend du type d’observation défini dans le flux de données associé)

Obligatoire

resultTime

L’heure à laquelle le résultat de l’observation a été généré.

Chaîne de temps ISO 8601

Obligatoire

resultQuality

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

Objet JSON

Optionel

validTime

La période pendant laquelle le résultat peut être utilisé.

Chaîne de temps ISO 8601

Optionel

parameters

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

Objet JSON

Optionel

2.1. phenomenonTime (obligatoire)#

Le champ phenomenonTime correspond au l’instant où la mesure a été effectuée.

Exemple

"phenomenonTime": "2001-09-07T09:06:00+02:00"

2.2. result (obligatoire)#

Le champ result contient la valeur de l’observation. Elle peut prendre n’importe quelle forme.

Recommandations

  • Dans le cas d’un observatoire c’est souvent une valeur numérique.

Exemple

"result": "0.231"

2.3. resultTime (obligatoire)#

Le champ resultTime est l’instant exact de la capture d’observation.

Exemple

{
  "resultTime": "2023-03-01T01:45:01+01:00"
}

2.4. resultQuality (optionnel)#

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

Recommandations

  • C’est l’endroit possible pour qualifier la mesure ou l’observation.

2.5. validTime (optionnel)#

Le champ validTime définit une période de validité de l’observation.

Exemple

{
  "validTime": "2024-12-14T11:58:27.330797+01:00"
}

2.6. parameters (optionnel)#

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

3. Exemple d’observation#

{
  "@iot.selfLink": "https://sensorthings.geosas.fr/test//v1.1/Observations(1)",
  "@iot.id": 1,
  "phenomenonTime": "2023-03-01T01:30:01+01:00",
  "result": 200,
  "resultTime": "2023-03-01T01:30:01+01:00",
  "resultQuality": null,
  "validTime": "2024-12-14T11:58:27.330797+01:00",
  "parameters": null,
  "Datastream@iot.navigationLink": "https://sensorthings.geosas.fr/test//v1.1/Observations(1)/Datastream",
  "MultiDatastream@iot.navigationLink": "https://sensorthings.geosas.fr/test//v1.1/Observations(1)/MultiDatastream",
  "FeatureOfInterest@iot.navigationLink": "https://sensorthings.geosas.fr/test//v1.1/Observations(1)/FeatureOfInterest"
}
Contents