Plugin e1_ws_openmeteo

Plugin e1_ws_openmeteo sprístupňuje verejné API služby https://open-meteo.com/ ako dvojicu dátových poskytovateľov (read‑only). Umožňuje načítať buď hodinové meteorologické údaje, alebo denné agregované predpovede – oddelene, aby sa nemiešali rozličné dátové schémy. Dokumentácia k API, ktoré plugin implementuje: https://open-meteo.com/en/docs .

Prehľad providerov (poskytovateľov) v plugine

Poskytovateľ	SysName	Popis
Open‑Meteo Hourly Forecast	`e1_ws_openmeteo_forecast`	Vráti hodinové hodnoty (časová pečiatka + teplota, relatívna vlhkosť, zrážky). Je možné definovať vlastný zoznam metrík cez parameter `@Hourly`.
Open‑Meteo Daily Forecast	`e1_ws_openmeteo_daily`	Vráti denné súhrny (dátum + max/min teploty, suma zrážok, východ/západ slnka). Podporuje vlastné metriky cez parameter `@Daily`.

Oba poskytovatelia používajú spoločnú logiku pre určenie polohy: buď zadáte priamo súradnice, alebo len názov miesta. Pri názve miesta plugin automaticky zavolá verejný geokódovací API endpoint Nominatim a súradnice doplní.

Spoločné parametre

Parameter	Povinný	Popis
`@Latitude`	✔️ (ak nie je zadaný `@PlaceName`)	Zemepisná šírka v desatinnom formáte (napr. `48.1486`).
`@Longitude`	✔️ (ak nie je zadaný `@PlaceName`)	Zemepisná dĺžka v desatinnom formáte (napr. `17.1077`).
`@PlaceName`	Voliteľný	Ľubovoľný názov mesta/obce/štvrte. Použije sa len v prípade, že chýbajú súradnice; plugin následne vykoná geokódovanie cez Nominatim.
`@ForecastDays`	Voliteľný	Počet dní predpovede (1–16). Predvolene `1`.
`@Timezone`	Voliteľný	IANA časová zóna (napr. `Europe/Bratislava`). Ak je prázdna alebo `auto`, Open‑Meteo ju zistí automaticky.

Parametre pre hodinové dáta (Hourly)

Parameter	Povinný	Popis
`@Hourly`	Voliteľný	Zoznam hodinových metrík Open‑Meteo (oddelené čiarkou alebo bodkočiarkou). Predvolené hodnoty: `temperature_2m,relative_humidity_2m,precipitation`. Nepodporované metriky plugin ignoruje.

Štandardná schéma – Hourly

Hodinový DataTable má názov openmeteo_hourly a obsahuje:

timezone, timezone_abbreviation
measurement_time_utc
temperature_2m, temperature_unit
relative_humidity_2m, relative_humidity_unit
precipitation, precipitation_unit

Parametre pre denné dáta (Daily)

Parameter	Povinný	Popis
`@Daily`	Voliteľný	Zoznam denných metrík Open‑Meteo. Predvolene: `temperature_2m_max,temperature_2m_min,precipitation_sum,sunrise,sunset`.

Štandardná schéma – Daily

Denný DataTable má názov openmeteo_daily a obsahuje:

timezone, timezone_abbreviation
forecast_date
temperature_2m_max, temperature_2m_max_unit
temperature_2m_min, temperature_2m_min_unit
precipitation_sum, precipitation_sum_unit
sunrise, sunrise_unit
sunset, sunset_unit

Príklady konfigurácie

Príklad – hodinové dáta (Bratislava)

Parameter	Hodnota
`@Latitude`	`48.1486`
`@Longitude`	`17.1077`
`@ForecastDays`	`2`
`@Timezone`	`Europe/Bratislava`
`@Hourly`	`temperature_2m,relative_humidity_2m,precipitation`

Príklad – denné dáta (New York cez názov miesta)

Parameter	Hodnota
`@PlaceName`	`New York, USA`
`@ForecastDays`	`5`
`@Daily`	`temperature_2m_max,temperature_2m_min,precipitation_sum`

Plugin najskôr geokóduje „New York, USA“, následne načíta 5‑dňovú dennú predpoveď a vráti ju v tabuľke openmeteo_daily.

Tipy a odporúčania

Ak sú zadané súradnice aj názov miesta, vždy sa uprednostnia súradnice.
Počet dní predpovede je automaticky obmedzený na interval 1–16, ako vyžaduje Open‑Meteo.
Pri vlastných metrikách (@Hourly, @Daily) použite názvy presne podľa dokumentácie Open‑Meteo. Neplatné položky sa automaticky ignorujú.
Poskytovatelia vracajú fixnú sadu stĺpcov. Ak zadáte metriky mimo predvolených, ovplyvnia síce odpoveď Open‑Meteo, no nepridajú ďalšie stĺpce, pokiaľ plugin nerozšírite.