Publication d'observations météo (**déprécié**)
===============================================

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     obsmeteoelab
Méthode   GET
========= ============

Paramètres
----------

============== ===================================== ========= ===
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.

.. math::

   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
^^^^^^^

.. code-block:: json
   :caption: 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
             }
           ]
         }
       ]
     }
   }
