Poziomy rzek i przepływ w jednym API

Zasięg

Około 22 000 wodowskazów raportuje w Niemczech (drogi wodne federalne i Nadrenia Północna-Westfalia), Francji, Anglii, Szkocji, Holandii, Flandrii, Luksemburgu, Czechach, Irlandii, Szwajcarii, Szwecji, Finlandii, Kanadzie i USA oraz w Katalonii, dorzeczu Gwadalkiwiru, Lombardii, Wenecji Euganejskiej, Emilii-Romanii i Tyrolu Południowym. Poziomy aktualizują się tak często, jak publikuje je dany kraj, od co 15 minut do raz na dobę. Szwecja publikuje wyłącznie przepływ.

Wodowskazy w pobliżu punktu

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

Poziom wody w cm nad własnym zerem wodowskazu (w Holandii nad NAP, w Szwajcarii nad poziomem morza), więc porównuj go z historią tego samego wodowskazu

dischargeM3s

Przepływ w m³/s, tam gdzie wodowskaz go mierzy

change24hCm

O ile zmienił się poziom w ciągu około doby

state

normal, warning lub alarm, tam gdzie kraj publikuje progi, w pozostałych przypadkach null

W prostokącie, wzdłuż trasy, w czasie

• GET /v1/rivers?bbox=west,south,east,north wypisuje do 1000 wodowskazów w prostokącie do 16 stopni kwadratowych, do warstwy mapy.
• POST /v1/route/rivers z trasą GeoJSON zwraca wodowskazy w odległości od 0,1 do 20 km od niej, dla kajakarzy, spływów i przejazdów wzdłuż rzeki.
• GET /v1/rivers/{id}/history?days=30 zwraca odczyty jednego wodowskazu z maksymalnie 30 dni.

Dlaczego jedno API zamiast tuzina

Każda usługa inaczej wypisuje stacje, stronicuje odczyty i nazywa rzekę; niektóre odpowiadają w milimetrach lub litrach na sekundę, niektóre w czasie lokalnym bez przesunięcia. Tutaj każdy wodowskaz ma te same pola, identyfikator wskazujący jego źródło i czasy w UTC, a ten sam klucz daje pogodę, jakość powietrza i dane map wokół niego.

Cena

Każde żądanie liczy się jako jedno. Plan darmowy daje 500 żądań dziennie, także w aplikacjach komercyjnych; Developer kosztuje 14,99 USD miesięcznie za 5000 dziennie.

Źródła: WSV PEGELONLINE (Niemcy, DL-DE Zero 2.0); LANUK Nadrenia Północna-Westfalia (DL-DE Zero 2.0); Hub'Eau / eaufrance (Francja, Licence Ouverte 2.0); Environment Agency (Anglia) i SEPA (Szkocja), zawiera informacje sektora publicznego udostępnione na licencji Open Government Licence v3.0; Rijkswaterstaat (Holandia); Vlaamse Milieumaatschappij, waterinfo.be (Flandria); Administration de la gestion de l'eau (Luksemburg, CC0); FOEN / BAFU (Szwajcaria); SMHI (Szwecja, CC BY 4.0); Syke, Finnish Environment Institute (Finlandia, CC BY 4.0); Environment and Climate Change Canada; U.S. Geological Survey (USA, domena publiczna); Czech Hydrometeorological Institute (CC BY 4.0); Office of Public Works, Irlandia, waterlevel.ie (CC BY 4.0); Agència Catalana de l'Aigua (Katalonia); Autonomous Province of Bolzano – South Tyrol (CC0); ARPA Lombardia (CC0); Arpae Emilia-Romagna (CC BY 4.0); ARPAV, Wenecja Euganejska (CC BY 4.0); Confederación Hidrográfica del Guadalquivir (SAIH) z lokalizacjami wodowskazów z MITECO (CC BY 4.0).