Niveaux des rivières et débits dans une seule API

Ce qu'elle couvre

Environ 22 000 stations en service en Allemagne (voies navigables fédérales et Rhénanie-du-Nord-Westphalie), France, Angleterre, Écosse, Pays-Bas, Flandre, Luxembourg, Tchéquie, Irlande, Suisse, Suède, Finlande, Canada et États-Unis, ainsi qu'en Catalogne, dans le bassin du Guadalquivir, en Lombardie, en Vénétie, en Émilie-Romagne et dans le Tyrol du Sud. Les niveaux sont mis à jour aussi souvent que chaque pays les publie, de toutes les 15 minutes à une fois par jour. La Suède ne publie que le débit.

Stations près d'un point

curl "https://geo.runningcat.dev/v1/rivers?lon=6.869&lat=45.924&radiusKm=10&limit=5" \
  -H "Authorization: Bearer YOUR_KEY"

{
  "gauges": [
    { "id": "hubeau:V000201201", "name": "L'Arve à Chamonix-Mont-Blanc [Pont de l'Aiguille] - Station amont",
      "river": "L'Arve", "lon": 6.86815, "lat": 45.9199, "distanceKm": 0.46,
      "time": "2026-11-07T17:30:00.000Z", "levelCm": 13, "change24hCm": null,
      "dischargeM3s": 2.85, "warningCm": null, "alarmCm": null, "state": null }
  ]
}

levelCm

Hauteur d'eau en cm au-dessus du zéro propre à la station (aux Pays-Bas au-dessus du NAP, en Suisse au-dessus du niveau de la mer) ; comparez-la donc à l'historique de la même station

dischargeM3s

Débit en m³/s, quand la station le mesure

change24hCm

De combien le niveau a varié en environ un jour

state

normal, warning ou alarm quand le pays publie des seuils, sinon null

Dans un rectangle, le long d'un itinéraire, dans le temps

• GET /v1/rivers?bbox=west,south,east,north liste jusqu'à 1 000 stations dans un rectangle d'au plus 16 degrés carrés, pour une couche de carte.
• POST /v1/route/rivers avec un itinéraire GeoJSON renvoie les stations situées de 0,1 à 20 km de celui-ci, pour le paddle, le rafting ou une sortie le long d'une rivière.
• GET /v1/rivers/{id}/history?days=30 renvoie les relevés d'une station sur 30 jours au maximum.

Pourquoi une API plutôt qu'une douzaine

Chaque service a sa propre façon de lister les stations, de paginer les relevés et de nommer la rivière ; certains répondent en millimètres ou en litres par seconde, d'autres en heure locale sans décalage. Ici, chaque station a les mêmes champs, un identifiant qui nomme sa source et des heures en UTC, et la même clé donne la météo, la qualité de l'air et les données cartographiques alentour.

Tarifs

Chaque requête compte pour une. L'offre gratuite donne 500 requêtes par jour, y compris pour les applications commerciales ; Developer coûte 14,99 $ par mois pour 5 000 par jour.

Crédits : WSV PEGELONLINE (Allemagne, DL-DE Zero 2.0) ; LANUK Rhénanie-du-Nord-Westphalie (DL-DE Zero 2.0) ; Hub'Eau / eaufrance (France, Licence Ouverte 2.0) ; Environment Agency (Angleterre) et SEPA (Écosse), contenant des informations du secteur public sous Open Government Licence v3.0 ; Rijkswaterstaat (Pays-Bas) ; Vlaamse Milieumaatschappij, waterinfo.be (Flandre) ; Administration de la gestion de l'eau (Luxembourg, CC0) ; OFEV / BAFU (Suisse) ; SMHI (Suède, CC BY 4.0) ; Syke, Institut finlandais de l'environnement (Finlande, CC BY 4.0) ; Environment and Climate Change Canada ; U.S. Geological Survey (États-Unis, domaine public) ; Institut hydrométéorologique tchèque (CC BY 4.0) ; Office of Public Works, Irlande, waterlevel.ie (CC BY 4.0) ; Agència Catalana de l'Aigua (Catalogne) ; Province autonome de Bolzano – Tyrol du Sud (CC0) ; ARPA Lombardia (CC0) ; Arpae Emilia-Romagna (CC BY 4.0) ; ARPAV, Vénétie (CC BY 4.0) ; Confederación Hidrográfica del Guadalquivir (SAIH) avec l'emplacement des stations d'après le MITECO (CC BY 4.0).