Adatok és API

Az oldal nem futtat lekérdezést oldalletöltéskor: minden szám egy előre kirenderelt JSON-fájlból jön, amit a gyűjtő 15 percenként újraír. Ezek a fájlok nyilvánosak, és közvetlenül is lekérhetők — ha valamit be akarsz építeni, ne az oldalt scrape-eld, hanem ezeket használd.

Nincs kulcs, nincs regisztráció, nincs CORS-korlátozás. Nincs viszont SLA sem: ez egy hobbiprojekt, a végpontok alakja változhat. Ha valamire építesz, számolj ezzel.

Végpontok

VégpontMit ad
/data/latest.jsonAz oldal aktuális állapota egy kérésből: minden mérce mostani értéke, a felvízi mércék változása, a paksi teljesítmény — most és negyedóránként az elmúlt két hétre —, a paksi vízállás elmúlt hete félóránként, a paksi hivatalos előrejelzés a szolgálat tűréshatárával, valamint a vízgyűjtő várható napi csapadéka.
/data/latest.csvUgyanez táblázatként: mércénként egy sor, aktuális vízállás, 24 órás változás, vízhozam és vízhő. Táblázatkezelőbe, dataframe-be közvetlenül beolvasható.
/data/stations.jsonMércetörzsadat: nullpont, folyamkilométer, koordináta, eddigi szélsőértékek, árvízi készültségi szintek.
/data/meta.jsonAttribúció, jogi figyelmeztetés, és mércénként az archívum kiterjedése (első nap, utolsó nap, napok száma).
/data/station/{station_id}/daily.jsonNapi bontás az elmúlt öt évre: minimum, maximum, átlag, napzáró érték. Ezt tölti le minden oldalmegnyitás, ezért van korlátozva; az `archive_from` mező mondja meg, hol kezdődik a teljes sor.
/data/station/{station_id}/daily.csvA teljes archívum CSV-ben, korlátozás nélkül, soronként a station_id-vel — a huszonöt fájl egymás után fűzve is értelmes marad.
/data/station/{station_id}/{ÉÉÉÉ-HH-NN}.jsonEgy nap 15 perces felbontásban, vízállás, vízhozam és vízhő.
/data/station/{station_id}/recent.jsonAz elmúlt hét nap vízállása legfeljebb félóránként (a mérce saját lépését a `step_minutes` mező adja meg) — a grafikon alapértelmezett nézete egyetlen kérésből. Minden pont mért érték, nem átlag.
/data/station/{station_id}/alert.jsonA mérce mai reggeli ritka híre, ugyanaz, amit az értesítés visz: átlépte az árvízi készültségi vagy a rekordszintet, a hivatalos előrejelzés most először vár ilyen átlépést, vagy a vízállás az évnek ebben a szakaszában egyetlen korábbi évben sem volt ilyen. A `last_change` üres, ha a reggel nem hozott ilyet; ha nem üres, az `id`-je a reggelt nevezi meg, és minden újrarajzolásnál ugyanaz marad.
/data/forecast/{station_id}/latest.jsonA legfrissebb hivatalos előrejelzési pálya, pontonként a kiadó szolgálat tűréshatárával (lower/upper).
/data/forecast/{station_id}/runs.jsonA korábbi előrejelzési kiadások indexe.
/data/energy/recent.jsonPaks bruttó teljesítménye a nyolc turbina összegeként, a rendszerterhelés és az import-export, MW-ban.
/data/precipitation/latest.jsonA vízgyűjtő várható napi csapadéka, átlagban és mintapontonként. Minden mintaponti érték mellett ott van, melyik előrejelzési kiadásból van.
/data/paks/blocks.jsonMit csinál épp a négy blokk a legfrissebb közölt időpontban, és mikor változott ez utoljára. A `units_reporting` és a `running_units` a `state` mögötti bizonyíték, és ettől olvasható a `partial`: ha kettő jelent és egy termel, az fél blokk; ha csak egy jelent, az fél blokknyi hallgatás. A `last_change` addig üres, amíg egy turbina el nem indul vagy le nem áll; ha nem üres, az `id`-je addig ugyanaz, amíg ez a legutolsó változás — ebből lehet megkülönböztetni az új eseményt ugyanannak az újrarenderelésétől.
/data/paks/history.jsonNapi bontású történeti sor: blokkonkénti bruttó termelés (MW) és a paksi vízállás, vízhozam, vízhő napi minimuma, maximuma, átlaga — mindegyik mellett a nap mintaszáma.
/data/paks/last-year.jsonA `paks/history.json` utolsó éve, ugyanabban a szerkezetben: ezzel nyit az erőmű lapjának grafikonja. A `first_day` a teljes sor első napja marad, így a kliens tudja, mit tartalmaz a teljes fájl.
/data/paks/events.jsonA Paks-oldal eseményjelölői: dátum, típus, egy mondat és a forrás. A `derived` mező mondja meg, hogy saját mérésből származik-e vagy bejelentésből; az `archive_url` a hivatkozott oldal webarchívumi mentése.

Mérceazonosítók

A station_id az OVF törzsszáma. Ugyanez az azonosító működik az előrejelzés-végpontokon is.
Mércestation_idFolyamkilométer
Rajka11848,3
Doborgaz45151839,5
Dunaremete21825,5
Nagybajcs31801,0
Gönyű41790,5
Komárom51768,3
Dunaalmás61751,8
Lábatlan13261737,8
Esztergom81718,7
Szob10191707,2
Nagymaros10201694,6
Vác10211679,5
Göd1200531671,0
Óbuda1210251654,5
Budapest10261646,5
Kvassay zsilip10271642,2
Budafok10291636,9
Adony5461598,1
Dunaújváros5471580,6
Dunaföldvár5481560,6
Paks5491531,3
Dombori5501506,8
Baja13441478,7
Dunaszekcső8321460,0
Mohács8311446,9

Licenc, felhasználás és hivatkozás

Az archívum mint összeállítás, a napi aggregátumok, a származtatott sorozatok, a grafikonok és a szövegek az oldal saját munkái, és Creative Commons Nevezd meg! 4.0 (CC BY 4.0) licenc alatt szabadon felhasználhatók, továbbadhatók és módosíthatók, kereskedelmi célra is. Egyetlen feltétel a forrás megjelölése.

A magukat a méréseket ez a licenc nem érinti és nem is érintheti: egy mért vízállás tény, nem szerzői mű, és az eredeti adatokat az alább felsorolt hatóságok állítják elő, az ő közzétételi feltételeik szerint. Ha az adatot továbbadod, őket is nevezd meg — a lista a lap alján, gépi formában pedig a /data/meta.json attribution mezőjében van.

Javasolt hivatkozás:

Duna vízállás (dunavizallas.hu), CC BY 4.0. Mért adat: OVF Vízrajzi Adattár; előrejelzés: Országos Vízjelző Szolgálat.

A licenc teljes szövege (CC BY 4.0)

Vízállás-doboz más honlapokra

Egy mérce mostani vízállását saját honlapra is be lehet tenni, egy sor kóddal.

Vízállás a saját honlapon