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) meteorologiniais duomenimis. Naudodamiesi Meteo.lt API, Jūs galite integruoti mūsų 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 1 parą iš vieno IP adreso, nes, viršijus nurodytą limitą, be atskiro įspėjimo gali būti užblokuotas Jūsų IP adresas.
API naudojimas
API prieiga
Prieigos adresas: https://api.meteo.lt/v1
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.
- windSpeed - vėjo greitis, m/s.
- windGust - vėjo gūsiai, m/s.
- windDirection - vėjo kryptis, °. Reikšmės: 0 - iš šiaurės, 180 - iš pietų ir t. t.
- cloudCover - debesuotumas, %. Reikšmės: 100 - debesuota, 0 - giedra.
- 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;
- isolated-clouds - mažai debesuota;
- scattered-clouds - debesuota su pragiedruliais;
- overcast - debesuota;
- light-rain - nedidelis lietus;
- moderate-rain - lietus;
- heavy-rain - smarkus lietus;
- sleet - šlapdriba;
- light-snow - nedidelis sniegas;
- moderate-snow - sniegas;
- heavy-snow - smarkus sniegas;
- fog - rūkas;
- na - oro sąlygos nenustatytos.