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) meteorologinių stočių išmatuotais duomenimis ir sudarytomis orų prognozėmis. Naudodamiesi Meteo.lt API, Jūs galite integruoti LHMT teikiamus meteorologinius 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) 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
Prašome negeneruoti daugiau kaip 20.000 užklausų per vieną parą iš vieno IP adreso. 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
Meteorologiniai stebėjimai
Stočių sąrašas
Aprašymas: Grąžinamas meteorologinių 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į.
Adresas: 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.
Adresas: 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:
- code - stoties kodas.
- 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.
Adresas: 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). Teikiami paskutinių 12 mėnesių meteorologinių stebėjimų duomenys. Nurodžius raktažodį latest, gražinami paskutinių 24 valandų duomenys.
Užklausos pavyzdžiai:
https://api.meteo.lt/v1/stations/vilniaus-ams/observations/latest
https://api.meteo.lt/v1/stations/vilniaus-ams/observations/2022-12-31
Atsakymo parametrai:
- code - stoties kodas.
- name - stoties pavadinimas.
- coordinates - stoties koordinatės (WGS 84 dešimtainiais laipsniais).
- 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.
- 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), gražinama null reikšmė.
- seaLevelPressure - slėgis jūros lygyje, hPa.
- relativeHumidity - santykinė oro drėgmė, %.
- precipitation - kritulių kiekis, mm.
-
conditionCode - oro 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;
- thunder - perkūnija;
- isolated-thunderstorms - trumpas lietus su perkūnija;
- thunderstorms - lietus su perkūnija;
- light-rain - nedidelis lietus;
- rain - lietus;
- heavy-rain - smarkus lietus;
- rain-showers - trumpas lietus;
- light-rain-at-times - protarpiais nedidelis lietus;
- rain-at-times - protarpiais lietus;
- light-sleet - nedidelė šlapdriba;
- sleet - šlapdriba;
- sleet-at-times - protarpiais šlapdriba;
- sleet-showers - trumpa šlapdriba;
- freezing-rain - lijundra;
- hail - kruša;
- light-snow - nedidelis sniegas;
- snow - sniegas;
- heavy-snow - smarkus sniegas;
- snow-showers - trumpas sniegas;
- snow-at-times - protarpiais sniegas;
- light-snow-at-times - protarpiais nedidelis sniegas;
- snowstorm - pūga;
- mist - rūkana;
- fog - rūkas;
- squall - škvalas;
- null - oro sąlygos nenustatytos.
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).
Informacija apie vietovę
Aprašymas: Nurodžius vietovės kodą, grąžinama detali informacija apie vietovę.
Adresas: 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.
Adresas: 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:
-
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ė.
Adresas: 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:
- 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).
- 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.
- 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 - santykinė oro drėgmė, %.
- totalPrecipitation - kritulių kiekis, mm.
-
conditionCode - oro sąlygos, kodas.
Galimos reikšmės:- clear - giedra;
- partly-cloudy - mažai debesuota;
- cloudy-with-sunny-intervals - debesuota su pragiedruliais;
- cloudy - debesuota;
- 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-rain - nedidelis lietus;
- rain - lietus;
- heavy-rain - smarkus lietus;
- 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.