Publication de jaugeages hydro¶

Ce web-service permet de publier des jaugeages

Paramètres HTTP¶

Paramètre	Valeur
Route	jaugeages
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
cdentites	liste de codes de station et/ou de codes de site	list(str)	O
dtdebut	date de début	datetime	F
dtfin	date de fin	datetime	F
dtmaj	date de mise à jour	datetime	F

Droit de publication¶

Les droits de publication appliqués pour ce service web sont liés aux entités hydro.

Pour publier un jaugeage dans son intégralité, il doit avoir les bons droits sur le site de jaugeage et les bons droits sur les stations associées aux hauteurs de jaugeage.

Si l’entité est un site hydrométrique :¶

Les jaugeages d’un site hydro public sont publics. IL n’est pas nécessaires d’être authentifié pour les publier.

L’authentification est obligatoire pour les autres sites hydro.

Dans le cas d’un site restreint, l’utilisateur doit avoir le profil institutionnel ou posséder un rôle sur le site.

Et dans le cas d’un site privé, l’utilisateur doit posséder un rôle sur le site.

Si l’entité est une station hydrométrique:¶

L’utilisateur doit au préalable posséder des bons droits sur le site de la station.

Les hauteurs de jaugeage d’une station hydrométrique publique sont publics. Il n’est pas nécessaire de s’authentifier pour les publier.

pour les autres stations, l’authentification est obligatoire

Dans le cas d’une station restreinte, « H publique », « Q public » ou « publiques sans courbes », l’utilisateur doit avoir le profil institutionnel ou posséder un rôle sur la station pour publier des hauteurs de jaugeages.

Et dans le cas d’une station privée, l’utilisateur doit posséder un rôle sur la station.

Réponse du web-service¶

Le web-service renvoie un json hydrométrie contenant les jaugeages à publier.

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

Donnees¶

L’objet Donnees contiendra l’unique propriété Jaugeages.

Jaugeages est une liste d’objets Jaugeage non vide.

Jaugeage¶

L’objet Jaugeage contiendra les propriétés suivantes:

CdJaugeage
DtJaugeage
DebitJaugeage
DtDebJaugeage
DtFinJaugeage
SectionMouilJaugeage
PerimMouilleJaugeage
LargMiroirJaugeage
ModeJaugeage
ComJaugeage
VitesseMoyJaugeage
VitesseMaxJaugeage
VitesseMoySurfaceJaugeage
CdSiteHydro
HauteursJaugeage : liste non vide d’objets HauteurJaugeage
DtMajJaugeage
NumJaugeage
IncertCalJaugeage
IncertRetenueJaugeage
QualifJaugeage
ComPrivJaugeage
CourbesTarage : liste non vide d’objets CourbeTarage

HauteurJaugeage¶

CdStationHydro
SysAltiStationJaugeage
CoteRetenueStationJaugeage
CoteDebutStationJaugeage
CoteFinStationJaugeage
DnStationJaugeage
DistanceStationJaugeage
StationFille : objet StationFille
DtDebRefAlti

StationFille¶

L’objet StationFille contient l’unique propriété CdStationHydro.

CourbeTarage¶

Propriétés de l’objet CourbeTarage:

CdCourbeTarage
LbCourbeTarage

Exemple¶

Jaugeages au format json¶

{
  "Scenario": {},
  "Donnees": {
    "Jaugeages": [
      {
        "CdJaugeage": 0,
        "DtJaugeage": "2022-01-01T09:30:00",
        "DebitJaugeage": "2000",
        "DtDebJaugeage": "2022-01-01T09:00:00",
        "DtFinJaugeage": "2022-01-01T10:00:00",
        "SectionMouilJaugeage": 198.5,
        "PerimMouilleJaugeage": 205.3,
        "LargMiroirJaugeage": 156.4,
        "ModeJaugeage": 2,
        "ComJaugeage": "Cmnt",
        "VitesseMoyJaugeage": 0.86,
        "VitesseMaxJaugeage": 0.97,
        "VitesseMoySurfaceJaugeage": 0.91,
        "CdSiteHydro": "A1234567",
        "HauteursJaugeage" : [
          {
            "CdStationHydro":"A123456789",
            "SysAltiStationJaugeage": 31,
            "CoteRetenueStationJaugeage": 87.4,
            "CoteDebutStationJaugeage": 86.5,
            "CoteFinStationJaugeage": 88.9,
            "DnStationJaugeage": 841.2,
            "DistanceStationJaugeage": -54,
            "StationFille": "0"
          }
        ],
        "DtMajJaugeage": "2023-01-01T00:00:00",
        "NumJaugeage": 0,
        "IncertCalJaugeage": 15.6,
        "IncertRetenueJaugeage": 14.7,
        "QualifJaugeage": 1,
        "ComPrivJaugeage": "Cmnt privé",
        "CourbesTarage" : [
          {
            "CdCourbeTarage": 0,
            "LbCourbeTarage": "Lb"
          }
        ]
      }
    ]
  }
}