Meteo Arhiva HR
Meteo Arhiva HR

REST API

Svi podaci s ove stranice dostupni su i programski: besplatan javni REST API, JSON preko HTTPS-a, bez registracije i ključa.

Otvori Swagger — interaktivna dokumentacijaOpenAPI specifikacija (JSON)

Swagger sadrži sve krajnje točke, parametre i sheme odgovora; ovdje je samo osnovno.

Brzi početak

Zalijepite naredbu u terminal ili otvorite odgovor u pregledniku.

  1. Popis postaja (pretraga po imenu)Otvori odgovor ↗
    curl "https://meteo-arhiva.monachus-informatika.hr/api/data/stations?q=zagreb"
  2. Postaja najbliža točkiOtvori odgovor ↗
    curl "https://meteo-arhiva.monachus-informatika.hr/api/data/stations/nearest?lat=45.81&lon=15.97&limit=1"
  3. Satna opažanja za jedan dan (Zagreb-Grič)Otvori odgovor ↗
    curl "https://meteo-arhiva.monachus-informatika.hr/api/data/observations?station_id=2&from=2025-01-15&to=2025-01-16"
  4. Vremenski raspon arhiveOtvori odgovor ↗
    curl "https://meteo-arhiva.monachus-informatika.hr/api/data/range"
  5. Graf temperature kao PNG (zadnjih 7 dana)Otvori odgovor ↗
    curl "https://meteo-arhiva.monachus-informatika.hr/api/renderers/temperature?station_id=2&size=800"
  6. Ruža vjetrova kao podaci (format=json)Otvori odgovor ↗
    curl "https://meteo-arhiva.monachus-informatika.hr/api/renderers/wind-rose?station_id=2&from=2024-01-01&to=2025-01-01&format=json"

Osnovni pojmovi

  1. station_id je identifikator postaje iz /api/data/stations; umjesto njega možete zadati lat i lon pa se uzima najbliža postaja.
  2. Vremena su ISO 8601 u hrvatskom lokalnom vremenu (Europe/Zagreb); kao ulaz prihvaća se datum, lokalno vrijeme ili vrijeme s pomakom.
  3. Mjerenja koja nedostaju su null — DHMZ objavljuje jedno opažanje po satu, a pojedini sati ili parametri mogu izostati.
  4. Opažanja su straničena: page i page_size (najviše 1000), ukupan broj je u polju total.
  5. Rendereri (/api/renderers) vraćaju PNG; uz format=json vraćaju podatke iz kojih je slika nacrtana.
  6. Svaki odgovor slojeva data i renderers nosi zaglavlja X-Data-Source i X-Data-License; /api/about vraća istu atribuciju kao JSON.

Ograničenja

  1. 60 zahtjeva u minuti po IP adresi; prekoračenje vraća HTTP 429 Too Many Requests — pričekajte minutu i ponovite.
  2. Arhiva se osvježava svakih 15 minuta; servis se pruža bez jamstva dostupnosti.

Navođenje izvora

Pri objavi ili daljnjoj obradi podataka navedite DHMZ kao izvor (Otvorena dozvola Republike Hrvatske). Ovo je neovisan servis, ne službeni servis DHMZ-a.

Više o izvoru, licenci i ograničenjima: O podacima

Poveznice