Flusspegel und Abfluss in einer API

Jedes Land veröffentlicht seine Flusspegel in eigenem Format, mit eigenen IDs, Einheiten und Aktualisierungszeiten. Diese API liest sie und gibt Ihnen für alle eine einheitliche Form: den neuesten Wasserstand und Abfluss, die Änderung binnen eines Tages, den Warnzustand, wo ein Land einen veröffentlicht, und bis zu 30 Tage Verlauf.

Wo sie abdeckt

Rund 22.000 meldende Pegel in Deutschland (Bundeswasserstraßen und Nordrhein-Westfalen), Frankreich, England, Schottland, den Niederlanden, Flandern, Luxemburg, Tschechien, Irland, der Schweiz, Schweden, Finnland, Kanada und den USA sowie in Katalonien, im Einzugsgebiet des Guadalquivir, in der Lombardei, Venetien, der Emilia-Romagna und Südtirol. Die Wasserstände werden so oft aktualisiert, wie das jeweilige Land sie veröffentlicht, von alle 15 Minuten bis einmal am Tag. Schweden veröffentlicht nur den Abfluss.

Pegel in der Nähe eines Punkts

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
Wasserstand in cm über dem eigenen Nullpunkt des Pegels (in den Niederlanden über NAP, in der Schweiz über dem Meeresspiegel); vergleichen Sie ihn daher mit dem Verlauf desselben Pegels
dischargeM3s
Abfluss in m³/s, wo der Pegel ihn misst
change24hCm
Wie stark sich der Wasserstand in etwa einem Tag geändert hat
state
normal, warning oder alarm, wo das Land Schwellenwerte veröffentlicht, sonst null

In einer Box, entlang einer Route, im Zeitverlauf

  • GET /v1/rivers?bbox=west,south,east,north listet bis zu 1.000 Pegel in einer Box von bis zu 16 Quadratgrad auf, für eine Kartenebene.
  • POST /v1/route/rivers mit einer GeoJSON-Route liefert die Pegel im Abstand von 0,1 bis 20 km, für Paddeln, Rafting oder eine Fahrt entlang eines Flusses.
  • GET /v1/rivers/{id}/history?days=30 liefert die Messwerte eines Pegels für bis zu 30 Tage.

Warum eine API statt eines Dutzends

Jeder Dienst hat seine eigene Art, Stationen aufzulisten, Messwerte zu blättern und den Fluss zu benennen; manche antworten in Millimetern oder Litern pro Sekunde, manche in Ortszeit ohne Versatz. Hier hat jeder Pegel dieselben Felder, eine ID, die seine Quelle nennt, und Zeiten in UTC, und derselbe Key liefert das Wetter, die Luftqualität und die Kartendaten drumherum.

Preis

Jede Anfrage zählt als eine. Der kostenlose Tarif bietet 500 Anfragen pro Tag, auch für kommerzielle Apps; Developer kostet 14,99 $ im Monat für 5.000 pro Tag.

Quellenangaben: WSV PEGELONLINE (Deutschland, DL-DE Zero 2.0); LANUK Nordrhein-Westfalen (DL-DE Zero 2.0); Hub'Eau / eaufrance (Frankreich, Licence Ouverte 2.0); Environment Agency (England) und SEPA (Schottland), enthalten Informationen des öffentlichen Sektors, lizenziert unter der Open Government Licence v3.0; Rijkswaterstaat (Niederlande); Vlaamse Milieumaatschappij, waterinfo.be (Flandern); Administration de la gestion de l'eau (Luxemburg, CC0); FOEN / BAFU (Schweiz); SMHI (Schweden, CC BY 4.0); Syke, Finnisches Umweltinstitut (Finnland, CC BY 4.0); Environment and Climate Change Canada; U.S. Geological Survey (USA, gemeinfrei); Tschechisches Hydrometeorologisches Institut (CC BY 4.0); Office of Public Works, Irland, waterlevel.ie (CC BY 4.0); Agència Catalana de l'Aigua (Katalonien); Autonome Provinz Bozen – Südtirol (CC0); ARPA Lombardia (CC0); Arpae Emilia-Romagna (CC BY 4.0); ARPAV, Venetien (CC BY 4.0); Confederación Hidrográfica del Guadalquivir (SAIH) mit Pegelstandorten von MITECO (CC BY 4.0).

Der kostenlose Tarif bietet 500 Anfragen pro Tag, auch für kommerzielle Apps. Legen Sie ein Konto mit Google oder Ihrer E-Mail-Adresse an und erstellen Sie sofort Ihre Schlüssel.