Hydrométrie Hub'Eau

Hub'Eau est le portail national d'accès aux données sur l'eau. Ses API donnent accès au référentiel hydrométrique (sites et stations du réseau français de mesures) et aux observations enregistrées dans la plateforme PHyC, opérée par le Service Central d'Hydrométéorologie et d'Appui à la Prévision des Inondations.

La plateforme en exploite deux familles de données, selon deux modes d'accès distincts :

• Observations temps réel : hauteur d'eau (H) et débit (Q), mesurés toutes les 5 à 60 minutes.
  • Collectées puis stockées en base
  • Historique limité à la durée de rétention
• Observations élaborées : débits moyens et valeurs extrêmes, journaliers et mensuels.
  • Non stockées : servies à la demande par un service proxy qui interroge Hub'Eau au moment de la requête.
  • Historique complet, depuis 1900.

Description technique

Trois collections sont exposées par le service KFS.

hubeau-hydro-stations

• Référentiel des stations, stocké dans MongoDB.
• Identifiant : code_station, préfixé par # (ex. #K055001010).
• Propriétés utiles : name, en_service, libelle_cours_eau, libelle_commune, altitude_ref_alti_station.

{
  "type": "Feature",
  "geometry": { "type": "Point", "coordinates": [-61.6589895969491, 16.1894024710321] },
  "properties": {
    "code_station": "#1011000101",
    "name": "[Barbotteau] à Petit-Bourg - Barbotteau",
    "code_site": "10110001",
    "en_service": true,
    "libelle_commune": "PETIT-BOURG"
  }
}

hubeau-hydro-observations

• Mesures temps réel, stockées dans MongoDB, horodatées par time.
• H : hauteur d'eau, en m.
• Q : débit, en m³/s.
• Une mesure porte une seule grandeur : deux documents distincts pour H et Q au même instant.

{
  "type": "Feature",
  "time": "2020-07-31T01:44:56.000Z",
  "geometry": { "type": "Point", "coordinates": [-54.4370262956598, 4.98628446712549] },
  "properties": {
    "code_station": "#5041000101",
    "name": "Le Maroni à Apatou [Langa Tabiki]",
    "H": 2.946
  }
}

hubeau-obs-elab

• Observations élaborées, non stockées : proxy vers Hub'Eau à chaque requête.
• Huit grandeurs, une seule par requête via grandeur_hydro_elab :
  • QmnJ / QmM : débit moyen journalier / mensuel.
  • QIXnJ / QIXM : débit instantané maximal journalier / mensuel.
  • QINnJ / QINM : débit instantané minimal journalier / mensuel.
  • HIXnJ / HIXM : hauteur instantanée maximale journalière / mensuelle.
• QmnJ s'applique par défaut.
• Valeurs dans l'unité de Hub'Eau, sans conversion : L/s pour les débits, mm pour les hauteurs.
• Pas de propriété name : le libellé de station se joint depuis hubeau-hydro-stations sur code_station.
• Identifiant de mesure déterministe : <grandeur>:<code station>:<date>.

{
  "id": "QmnJ:K055001010:2024-01-15",
  "type": "Feature",
  "time": "2024-01-15T00:00:00.000Z",
  "geometry": { "type": "Point", "coordinates": [4.117993226, 45.295231598] },
  "properties": {
    "code_station": "#K055001010",
    "date_obs_elab": "2024-01-15",
    "resultat_obs_elab": 20802,
    "grandeur_hydro_elab": "QmnJ",
    "libelle_statut": "Donnée validée"
  }
}

Cycle de vie des données

• hubeau-hydro-stations : référentiel synchronisé une fois par jour, conservé sans limite de durée.
• hubeau-hydro-observations : mesures synchronisées toutes les heures, rétention de 90 jours
• hubeau-obs-elab : aucune donnée conservée, chaque requête interroge Hub'Eau.
  • Une requête sans datetime ne renvoie que les sept derniers jours
  • Toute borne temporelle explicite atteint l'historique complet

Services d'accès

KANO KFS Geocoder