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.
• 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.

2019 © Lietuvos hidrometeorologijos tarnyba prie Aplinkos ministerijos