Meteo.lt API

Meteo.lt API (angl. Application programming interface) įgalina gauti ir naudotis viešai teikiamais Lietuvos hidrometeorologijos tarnybos prie Aplinkos ministerijos (toliau – LHMT) hidrologijos ir meteorologijos stočių išmatuotais duomenimis bei sudarytomis orų prognozėmis. Naudodamiesi Meteo.lt API, Jūs galite integruoti LHMT teikiamus hidrometeorologinius duomenis į savo kuriamas programas.

Naudojimosi sąlygos

Duomenų naudojimo sąlygos

Meteo.lt API pavadinimas ir visos intelektinės nuosavybės teisės priklauso LHMT ir yra neperduodamos.

Per Meteo.lt API teikiami duomenys (toliau – duomenys) yra viešai prieinami ir nemokami visuomeniniam naudojimui, platinimui ir tolimesniam apdorojimui, laikantis šių duomenų naudojimo sąlygų:

1) duomenys, jeigu nenustatyta kitaip, teikiami pagal Creative Commons Attribution-ShareAlike 4.0 (CC BY-SA 4.0) tarptautinę duomenų naudojimo licenciją, būtina susipažinti su licencijos sąlygomis;
2) duomenys gali būti naudojami tik teisėtiems ir apibrėžtiems tikslams;
3) duomenys pateikiami tokie, kokie yra, be jokių garantijų ir LHMT neatsako dėl tinkamos duomenų kokybės užtikrinimo, jų tinkamumo konkrečiam tikslui;
4) LHMT neatsako už jokius nuostolius ar žalą, susijusius su duomenų naudojimu ar negalėjimu jų naudoti, nepriklausomai nuo priežasties;
5) publikuojant, pakartotinai atkartojant ar kitaip naudojant duomenis, būtina nurodyti, kad duomenų šaltinis yra LHMT. Nenurodant duomenų šaltinio, gali būti nutraukta prieiga prie duomenų.

Užklausų ribojimas

Užklausų kiekis iš vieno IP adreso ribojamas iki 180 užklausų per minutę. Prašome negeneruoti daugiau kaip 20.000 užklausų per vieną parą iš vieno IP adreso, nes viršijus nurodytą limitą Jūsų IP adresas gali būti užblokuotas be įspėjimo.

API naudojimas

API prieigos adresas: https://api.meteo.lt/v1/

Orų prognozės

Vietovių sąrašas

Aprašymas: Grąžinamas vietovių, kurioms teikiami orų prognozės duomenys, sąrašas.

Užklausa: GET /places

Užklausos parametrai: -

Užklausos pavyzdys: https://api.meteo.lt/v1/places

Atsakymo parametrai:

code - vietovės kodas.
name - vietovės pavadinimas.
administrativeDivision - administracinis vienetas, kuriam priklauso vietovė.
countryCode - šalies, kuriai priklauso vietovė, kodas (ISO 3166-1 alpha-2).
coordinates - vietovės koordinatės (WGS 84 dešimtainiais laipsniais).

Informacija apie vietovę

Aprašymas: Nurodžius vietovės kodą, grąžinama detali informacija apie vietovę.

Užklausa: GET /places/{place-code}

Užklausos parametrai:

place-code - vietovės kodas.

Užklausos pavyzdys: https://api.meteo.lt/v1/places/vilnius

Atsakymo parametrai:

code - vietovės kodas.
name - vietovės pavadinimas.
administrativeDivision - administracinis vienetas, kuriam priklauso vietovė.
country - šalies, kuriai priklauso vietovė, pavadinimas.
countryCode - šalies, kuriai priklauso vietovė, kodas (ISO 3166-1 alpha-2).
coordinates - vietovės koordinatės (WGS 84 dešimtainiais laipsniais).

Vietovės prognozių sąrašas

Aprašymas: Nurodžius vietovės kodą, grąžinamas vietovei teikiamų orų prognozių sąrašas.

Užklausa: GET /places/{place-code}/forecasts

Užklausos parametrai:

place-code - vietovės kodas.

Užklausos pavyzdys: https://api.meteo.lt/v1/places/vilnius/forecasts

Atsakymo parametrai:

place - informacija apie vietovę.
- code - vietovės kodas.
- name - vietovės pavadinimas.
- administrativeDivision - administracinis vienetas, kuriam priklauso vietovė.
- country - šalies, kuriai priklauso vietovė, pavadinimas.
- countryCode - šalies, kuriai priklauso vietovė, kodas (ISO 3166-1 alpha-2).
- coordinates - vietovės koordinatės (WGS 84 dešimtainiais laipsniais).
forecastTypes - vietovei teikiamų orų prognozių sąrašas.
- type - orų prognozės tipas.
  Galimos reikšmės:
  - long-term - ilgalaikė skaitmeninė orų prognozė. Orų prognozės duomenys atnaujinami 8 kartus per parą, apytiksliai kas 3 valandas.
- description - orų prognozės tipo aprašymas.

Orų prognozė vietovei

Aprašymas: Nurodžius vietovės kodą ir orų prognozės tipą, grąžinama vietovei skirta orų prognozė.

Užklausa: GET /places/{place-code}/forecasts/{forecast-type}

Užklausos parametrai:

place-code - vietovės kodas.
forecast-type - orų prognozės tipas.

Užklausos pavyzdys: https://api.meteo.lt/v1/places/vilnius/forecasts/long-term

Atsakymo parametrai:

place - informacija apie vietovę.
- code - vietovės kodas.
- name - vietovės pavadinimas.
- administrativeDivision - administracinis vienetas, kuriam priklauso vietovė.
- country - šalies, kuriai priklauso vietovė, pavadinimas.
- countryCode - šalies, kuriai priklauso vietovė, kodas (ISO 3166-1 alpha-2).
- coordinates - vietovės koordinatės (WGS 84 dešimtainiais laipsniais).
forecastType - orų prognozės tipas.
forecastCreationTimeUtc - orų prognozės sudarymo laikas (UTC laiko juosta).
forecastTimestamps - prognozės laiko žymos.
- forecastTimeUtc - orų prognozės laikas (UTC laiko juosta).
- airTemperature - oro temperatūra, °C.
- feelsLikeTemperature - juntamoji temperatūra, °C.
- windSpeed - vėjo greitis, m/s.
- windGust - vėjo gūsis, m/s. Maksimalus gūsis per 1 val., kai prognozės laiko žingsnis 1 val., maksimalus per 3 val., kai laiko žingsnis 3 val. ir t.t.
- windDirection - vėjo kryptis, °. Reikšmės: 0 - iš šiaurės, 180 - iš pietų ir t. t.
- cloudCover - debesuotumas, %. Reikšmės: 0 - giedra, 100 - debesuota.
- seaLevelPressure - slėgis jūros lygyje, hPa.
- relativeHumidity - santykinis oro drėgnis, %.
- totalPrecipitation - kritulių kiekis, mm. Kritulių suma per 1 val., kai prognozės laiko žingsnis 1 val., suma per 3 val., kai laiko žingsnis 3 val. ir t.t.
- conditionCode - orų sąlygos, kodas.
  Galimos reikšmės:
  - clear - giedra;
  - partly-cloudy - mažai debesuota;
  - cloudy-with-sunny-intervals - debesuota su pragiedruliais;
  - cloudy - debesuota;
  - light-rain - nedidelis lietus;
  - rain - lietus;
  - heavy-rain - smarkus lietus;
  - thunder - perkūnija;
  - isolated-thunderstorms - trumpas lietus su perkūnija;
  - thunderstorms - lietus su perkūnija;
  - heavy-rain-with-thunderstorms - smarkus lietus su perkūnija;
  - light-sleet - nedidelė šlapdriba;
  - sleet - šlapdriba;
  - freezing-rain - lijundra;
  - hail - kruša;
  - light-snow - nedidelis sniegas;
  - snow - sniegas;
  - heavy-snow - smarkus sniegas;
  - fog - rūkas;
  - null - oro sąlygos nenustatytos.

Meteorologiniai stebėjimai

Stočių sąrašas

Aprašymas: Grąžinamas meteorologijos stočių, kurių stebėjimų duomenys teikiami, sąrašas.

Užklausa: GET /stations

Užklausos parametrai: -

Užklausos pavyzdys: https://api.meteo.lt/v1/stations

Atsakymo parametrai:

code - stoties kodas.
name - stoties pavadinimas.
coordinates - stoties koordinatės (WGS 84 dešimtainiais laipsniais).

Informacija apie stotį

Aprašymas: Nurodžius stoties kodą, grąžinama detali informacija apie stotį.

Užklausa: GET /stations/{station-code}

Užklausos parametrai:

station-code - stoties kodas.

Užklausos pavyzdys: https://api.meteo.lt/v1/stations/vilniaus-ams

Atsakymo parametrai:

code - stoties kodas.
name - stoties pavadinimas.
type - stoties tipas.
coordinates - stoties koordinatės (WGS 84 dešimtainiais laipsniais).

Informacija apie saugomus stoties duomenis

Aprašymas: Nurodžius stoties kodą, grąžinama informacija apie saugomus stoties stebėjimų duomenis.

Užklausa: GET /stations/{station-code}/observations

Užklausos parametrai:

station-code - stoties kodas.

Užklausos pavyzdys: https://api.meteo.lt/v1/stations/vilniaus-ams/observations

Atsakymo parametrai:

station - informacija apie stotį.
- code - stoties kodas.
- name - stoties pavadinimas.
- coordinates - stoties koordinatės (WGS 84 dešimtainiais laipsniais).
observationsDataRange - saugomų stoties stebėjimų duomenų laiko intervalas.
- startTimeUtc - saugomų stoties stebėjimų duomenų laiko intervalo pradžia (UTC laiko juosta).
- endTimeUtc - saugomų stoties stebėjimų duomenų laiko intervalo pabaiga (UTC laiko juosta).

Stoties stebėjimų duomenys

Aprašymas: Nurodžius stoties kodą ir datą, grąžinami stoties išmatuoti stebėjimų duomenys. Kai kurios stotys matuoja ne visus meteorologinius parametrus. Jei stotis nurodytu laiku neatliko tam tikro matavimo, tai tam matavimo parametrui grąžinama null reikšmė. Jei nurodytai datai nesaugomi jokie stoties matavimo duomenys, tai grąžinamas 404 Not Found atsakymas.

Užklausa: GET /stations/{station-code}/observations/{date}

Užklausos parametrai:

station-code - stoties kodas.
date - data, kurios stebėjimų duomenis pateikti, YYYY-MM-DD (naudojama UTC laiko juosta). Nurodžius raktažodį latest, grąžinami paskutinių 24 valandų duomenys. Teikiami paskutinių 10 metų meteorologinių stebėjimų duomenys. Jei stotis įdiegta vėliau nei prieš 10 metų, jos duomenys teikiami nuo stoties įdiegimo datos.

Užklausos pavyzdžiai:
https://api.meteo.lt/v1/stations/vilniaus-ams/observations/latest
https://api.meteo.lt/v1/stations/vilniaus-ams/observations/2024-11-20

Atsakymo parametrai:

station - informacija apie stotį.
- code - stoties kodas.
- name - stoties pavadinimas.
- coordinates - stoties koordinatės (WGS 84 dešimtainiais laipsniais).
observations - stoties stebėjimų duomenys.
- observationTimeUtc - atliktų stebėjimų laikas (UTC laiko juosta).
- airTemperature - oro temperatūra, °C.
- feelsLikeTemperature - juntamoji temperatūra, °C.
- windSpeed - vėjo greitis, m/s.
- windGust - vėjo gūsis, m/s. Maksimalus gūsis per valandą.
- windDirection - vėjo kryptis, °. Reikšmės: 0 - iš šiaurės, 180 - iš pietų ir t. t.
- cloudCover - debesuotumas, %. Reikšmės: 0 - giedra, 100 - debesuota. Nepavykus nustatyti debesuotumo (pavyzdžiui dėl rūko), grąžinama null reikšmė.
- seaLevelPressure - slėgis jūros lygyje, hPa.
- relativeHumidity - santykinis oro drėgnis, %.
- precipitation - kritulių kiekis, mm. Kritulių suma per valandą.
- conditionCode - orų sąlygos, kodas.
  Galimos reikšmės:
  - clear - giedra;
  - partly-cloudy - mažai debesuota;
  - variable-cloudiness - nepastoviai debesuota;
  - cloudy-with-sunny-intervals - debesuota su pragiedruliais;
  - cloudy - debesuota;
  - rain-showers - trumpas lietus;
  - light-rain-at-times - protarpiais nedidelis lietus;
  - rain-at-times - protarpiais lietus;
  - light-rain - nedidelis lietus;
  - rain - lietus;
  - heavy-rain - smarkus lietus;
  - thunder - perkūnija;
  - isolated-thunderstorms - trumpas lietus su perkūnija;
  - thunderstorms - lietus su perkūnija;
  - sleet-showers - trumpa šlapdriba;
  - sleet-at-times - protarpiais šlapdriba;
  - light-sleet - nedidelė šlapdriba;
  - sleet - šlapdriba;
  - freezing-rain - lijundra;
  - hail - kruša;
  - snow-showers - trumpas sniegas;
  - light-snow-at-times - protarpiais nedidelis sniegas;
  - snow-at-times - protarpiais sniegas;
  - light-snow - nedidelis sniegas;
  - snow - sniegas;
  - heavy-snow - smarkus sniegas;
  - snowstorm - pūga;
  - fog - rūkas;
  - squall - škvalas;
  - null - oro sąlygos nenustatytos.

Hidrologiniai stebėjimai

Stočių sąrašas

Aprašymas: Grąžinamas hidrologijos stočių, kurių stebėjimų duomenys teikiami, sąrašas.

Užklausa: GET /hydro-stations

Užklausos parametrai: -

Užklausos pavyzdys: https://api.meteo.lt/v1/hydro-stations

Atsakymo parametrai:

code - stoties kodas.
name - stoties pavadinimas.
waterBody - vandens telkinys.
coordinates - stoties koordinatės (WGS 84 dešimtainiais laipsniais).

Informacija apie stotį

Aprašymas: Nurodžius stoties kodą, grąžinama informacija apie stotį.

Užklausa: GET /hydro-stations/{station-code}

Užklausos parametrai:

station-code - stoties kodas.

Užklausos pavyzdys: https://api.meteo.lt/v1/hydro-stations/nemajunu-vms

Atsakymo parametrai:

code - stoties kodas.
name - stoties pavadinimas.
waterBody - vandens telkinys.
coordinates - stoties koordinatės (WGS 84 dešimtainiais laipsniais).

Stoties teikiamų hidrologinių duomenų sąrašas

Aprašymas: Nurodžius stoties kodą, grąžinamas soties teikiamų hidrologinių duomenų sąrašas.

Užklausa: GET /hydro-stations/{station-code}/observations

Užklausos parametrai:

station-code - stoties kodas.

Užklausos pavyzdys: https://api.meteo.lt/v1/hydro-stations/nemajunu-vms/observations

Atsakymo parametrai:

station - informacija apie stotį.
- code - stoties kodas.
- name - stoties pavadinimas.
- waterBody - vandens telkinys.
- coordinates - stoties koordinatės (WGS 84 dešimtainiais laipsniais).
observationTypes - stoties teikiamų hidrologinių duomenų sąrašas.
- type - hidrologinių duomenų tipas.
  Galimos reikšmės:
  - measured - einamųjų metų hidrologiniai duomenys;
  - historical - istoriniai hidrologiniai duomenys.
- description - hidrologinių duomenų tipo aprašymas.

Informacija apie saugomus stoties duomenis

Aprašymas: Nurodžius stoties kodą ir hidrologinių duomenų tipą, grąžinama informacija apie saugomus stoties stebėjimų duomenis.

Užklausa: GET /hydro-stations/{station-code}/observations/{observation-type}

Užklausos parametrai:

station-code - stoties kodas.
observation-type - hidrologinių duomenų tipas.

Užklausos pavyzdžiai:
https://api.meteo.lt/v1/hydro-stations/nemajunu-vms/observations/measured
https://api.meteo.lt/v1/hydro-stations/nemajunu-vms/observations/historical

Atsakymo parametrai:

station - informacija apie stotį.
- code - stoties kodas.
- name - stoties pavadinimas.
- waterBody - vandens telkinys.
- coordinates - stoties koordinatės (WGS 84 dešimtainiais laipsniais).
observationsDataRange - saugomų stoties stebėjimų duomenų laiko intervalas.
- startTimeUtc | startDateUtc - saugomų stoties stebėjimų duomenų laiko intervalo pradžia (UTC laiko juosta).
- endTimeUtc | endDateUtc - saugomų stoties stebėjimų duomenų laiko intervalo pabaiga (UTC laiko juosta).

Stoties einamųjų metų hidrologiniai duomenys

Aprašymas: Nurodžius stoties kodą, measured hidrologinių duomenų tipą ir datą, grąžinami stoties einamųjų metų hidrologiniai duomenys. Jei stotis nurodytu laiku neatliko tam tikro matavimo, tai tam matavimo parametrui grąžinama null reikšmė. Jei nurodytai datai nesaugomi jokie stoties matavimo duomenys, tai grąžinamas 404 Not Found atsakymas.

Užklausa: /hydro-stations/{station-code}/observations/measured/{date}

Užklausos parametrai:

station-code - stoties kodas.
date - data, kurios stebėjimų duomenis pateikti, YYYY-MM-DD (naudojama UTC laiko juosta). Nurodžius raktažodį latest, grąžinami paskutinių 24 valandų duomenys. Teikiami paskutinių 30 dienų hidrologinių stebėjimų duomenys.

Užklausos pavyzdžiai:
https://api.meteo.lt/v1/hydro-stations/nemajunu-vms/observations/measured/latest
https://api.meteo.lt/v1/hydro-stations/nemajunu-vms/observations/measured/2024-11-20

Atsakymo parametrai:

station - informacija apie stotį.
- code - stoties kodas.
- name - stoties pavadinimas.
- waterBody - vandens telkinys.
- coordinates - stoties koordinatės (WGS 84 dešimtainiais laipsniais).
observations - stoties stebėjimų duomenys.
- observationTimeUtc - atliktų stebėjimų laikas (UTC laiko juosta).
- waterLevel - vandens lygis, cm.
- waterTemperature - vandens temperatūra, °C. Esant ledo dangai, vandens temperatūra nematuojama.

Stoties istoriniai hidrologiniai duomenys

Aprašymas: Nurodžius stoties kodą, historical hidrologinių duomenų tipą ir datą, grąžinami stoties istoriniai hidrologiniai duomenys. Jei stotis nurodytą datą neatliko tam tikro matavimo, tai tam matavimo parametrui grąžinama null reikšmė. Jei nurodytai datai nesaugomi jokie stoties matavimo duomenys, tai grąžinamas 404 Not Found atsakymas.

Užklausa: /hydro-stations/{station-code}/observations/historical/{date}

Užklausos parametrai:

station-code - stoties kodas.
date - data, kurios stebėjimų duomenis pateikti, YYYY-MM arba YYYY-MM-DD (naudojama UTC laiko juosta). Nurodžius raktažodį latest, grąžinami paskutinių saugomų 31 parų duomenys. Istoriniai hidrologinių stebėjimų duomenys teikiami nuo 2000 metų. Duomenys už praėjusius metus pradedami teikti nuo einamųjų metų vidurio.

Užklausos pavyzdžiai:
https://api.meteo.lt/v1/hydro-stations/nemajunu-vms/observations/historical/latest
https://api.meteo.lt/v1/hydro-stations/nemajunu-vms/observations/historical/2023-12
https://api.meteo.lt/v1/hydro-stations/nemajunu-vms/observations/historical/2023-12-31

Atsakymo parametrai:

station - informacija apie stotį.
- code - stoties kodas.
- name - stoties pavadinimas.
- waterBody - vandens telkinys.
- coordinates - stoties koordinatės (WGS 84 dešimtainiais laipsniais).
observations - stoties stebėjimų duomenys.
- observationDateUtc - atliktų stebėjimų data (UTC laiko juosta).
- waterLevel - vandens lygis, cm. Vidurkis per parą.
- waterDischarge - vandens debitas, m³/s. Vidurkis per parą.