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) pateikiami tokie, kokie yra, be jokių garantijų. LHMT neatsako dėl tinkamos duomenų kokybės užtikrinimo, jų tinkamumo konkrečiam tikslui. LHMT negarantuoja Meteo.lt API nepertraukiamo veikimo arba veikimo be klaidų ir neatsako už netinkamą Meteo.lt API veikimą, klaidas, neveikimą, pertrūkius, defektus, uždelstą veikimą ir panašiai. LHMT neatsako už jokius nuostolius ar žalą, susijusius su duomenų naudojimu ar negalėjimu jų naudoti, nepriklausomai nuo priežasties.
LHMT netikrina duomenis naudojančių interneto svetainių ir programų skelbiamos informacijos kokybės ir neatsako už LHMT ribų esantį turinį.
Teikiant duomenis naudotojams, prašome nurodyti, kad duomenų šaltinis yra LHMT. Panaudojant duomenis ir sukuriant naują rezultatą prašome nurodyti, kad rezultatui pasiekti buvo naudojami pirminiai duomenys iš 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
Stebėjimų duomenys
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). 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 - 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.