Publication d’observations météo¶

Ce web-service permet de publier des observations élaborées de température te hauteur de neige.

Les cumuls de pluie ne sont pas considérés comme des observations météo élaborées qui peuvent être récupérés par les web-services de publication d’observations météo.

Paramètres HTTP¶

Paramètre	Valeur
Route	obssmeteoelab
Méthode	POST

Paramètres¶

Les paramètres doivent être transmis dans le contenu de la requête au format format JSON.

Nom	Description	Type	O/F
cdsitesmeteo	Liste de codes de sites météo	list(str)	O
grandeurs	liste de grandeurs météo élaboréeq	list(str)	O
dtdebut	Date de début	datetime	F
dtfin	Date de fin	datetime	F

Codes des sites météo¶

La PHyC vérifie que les codes des sites météo sont bien de longueur de 8 ou 9 caractères et qu’ils soient constitués uniquement de chiffres.

Grandeurs météo¶

Les grandeurs météo élaborées autorisées sont:

Grandeur	Description
TAmJ	Moyenne journalière des température
TANJ, TAXJ	Mininum, maximum journalier des températures
HNmJ	Moyenne des hauteurs de neige
HNXJ, HNNJ	Minimun, maximum des hauteurs de neige

Droits de publication¶

Les droits de publication du web-service dépendent du caractère public des sites météo.

Pour un site météo public, il n’est pas nécessaire d’être authentifié pour publier les observations du site.

Pour publier des observations d’uns site météo privé, il faut être authentifié et avoir le profil institutionnel ou posséder un rôle sur le site météo.

Limite de publication¶

Avant de récupérer les observations élaborées, la PHyC calcule le nombre théorique de données renvoyées qui correspond au produit du nombre de sites météo, du nombre de grandeurs météo et du nombre de jours compris entre date de début et de fin.

\[N_{obs} = N_{sites} \times N_{grds} \times N_{jours}\]

La limite maximale de publication correspond à la limite de publication des observations hydro élaborées.

Performance¶

Les données fournies par la web-service sont calculées et stockées lors de l’insertion d’observations météo élémentaires.

Lors de l’appel du web-service, la PHyC ne réalise pas de calculs et récupère directement les données en base de données.

Réponse du web-service¶

Le web-service renvoie un json hydrométrie contenant les observations météo élaborées à publier.

Le json hydrométrie contient les deux propriétés Scenario et Donnees.

Données¶

L’objet Données contiendra l’unique propriété SeriesObsMeteo.

SeriesObsElaborMeteo est une liste non vide d’objets SerieObsElaborMeteo.

SerieObsElaborMeteo¶

Propriétés de l’objet SerieObsElaborMeteo:

CdSiteMeteo
CdGrdSerieObsElaborMeteo
DtDebSerieObsElaborMeteo
DtFinSerieObsElaborMeteo
DureeSerieObsElaborMeteo = 86400
ObssElaborMeteo : liste non vide d’objets ObsElaborMeteo

ObsElaborMeteo¶

Propriétés de l’objet ObsElaborMeteo:

DtObsElaborMeteo
ResObsElaborMeteo
IndiceQualObsElaborMeteo
QualifObsElaborMeteo
MethObsElaborMeteo
StObsElaborMeteo

Exemple¶

Observations météo élaborées au format json¶

{
  "Scenario": {},
  "Donnnees": {
    "SerieObsElaborMeteo": [
      {
        "CdSiteMeteo" : "012345678",
        "CdGrdSerieObsElaborMeteo" : "TAmJ",
        "DtDebSerieObsElaborMeteo": "2015-01-01T00:00:00",
        "DtFinSerieObsElaborMeteo": "2015-01-01T00:00:00",
        "DureeSerieObsElaborMeteo": 86400,
        "ObssElaborMeteo": [
          {
            "DtObsElaborMeteo" : "2015-01-01T00:00:00",
            "ResObsElaborMeteo" : 18.5,
            "IndiceQualObsElaborMeteo" : 100,
            "QualifObsElaborMeteo" : 16,
            "MethObsElaborMeteo" : 8,
            "StObsElaborMeteo" : 4
          }
        ]
      }
    ]
  }
}