TapHome

Weathercloud

Packet Parser → HTTP
Pridal
Posledná aktualizácia: 03. 2026
Weathercloud

Weathercloud je cloudová meteorologická platforma s globálnou sieťou viac ako 100 000 osobných meteostaníc. TapHome sa pripája k Weathercloud cez HTTP Packet Parser šablónu, ktorá pravidelne získava aktuálne meteorologické údaje z interného webového API platformy. Integrácia je len na čítanie — všetkých 14 zariadení v šablóne sú senzory zobrazujúce meteorologické údaje z pripojenej stanice.

Táto integrácia používa neoficiálne, reverzne analyzované API (interné endpointy webovej aplikácie Weathercloud). Weathercloud neponúka verejné API na získavanie dát. Endpointy sa môžu zmeniť alebo byť zablokované bez upozornenia.

Konfigurácia

Počas importu šablóny zadajte Device ID — desaťmiestne číslo identifikujúce meteostanicu na Weathercloud. Šablóna používa toto ID na dopytovanie app.weathercloud.net/device/values?code={DeviceID}.

Získanie Device ID
  1. Prihláste sa do účtu Weathercloud na weathercloud.net
  2. Otvorte stránku Devices z profilového menu
  3. Kliknite na ikonu Settings (ozubené koliesko) pri cieľovom zariadení
  4. Vyberte Link device — Weathercloud ID je požadované Device ID

Weathercloud API vyžaduje session cookie na autentifikáciu. Šablóna posiela hlavičku cookie s každou požiadavkou. Na získanie platného session cookie:

  1. Prihláste sa na app.weathercloud.net v prehliadači
  2. Otvorte vývojárske nástroje prehliadača (F12) a skontrolujte hlavičky požiadaviek
  3. Skopírujte celú hodnotu cookie z akejkoľvek požiadavky na app.weathercloud.net
  4. Nahraďte zástupný text COOKIE v read scripte šablóny skutočným cookie reťazcom

Session cookies exspirujú po období nečinnosti. Ak integrácia prestane vracať údaje, znova sa autentifikujte a aktualizujte hodnotu cookie v TapHome.

Možnosti zariadení

Šablóna poskytuje 14 zariadení len na čítanie, ktoré parsujú polia z jednej JSON odpovede. Všetky zariadenia zdieľajú rovnaký HTTP polling mechanizmus s intervalom 15 sekúnd (UV Index sa dopytuje každých 2,5 sekundy). Každý read script obsahuje spracovanie chýb — ak je odpoveď null alebo obsahuje "error", zariadenie vráti NaN.

Teplota a vlhkosť
  • Temperature & Humidity — vonkajšia teplota v °C a relatívna vlhkosť. Vlhkosť je v API reportovaná ako 0–100 a šablóna ju konvertuje na pomer 0–1.
  • Dew Point — teplota rosného bodu v °C
  • Wind Chill — pocitová teplota zohľadňujúca chladivý efekt vetra, v °C. Voliteľné — nie všetky stanice reportujú wind chill.
Meranie vetra
  • Wind Speed — aktuálna rýchlosť vetra, konvertovaná z m/s na km/h (násobenie 3,6)
  • Average Wind Speed — priemerná rýchlosť vetra za reportovací interval stanice, konvertovaná z m/s na km/h
  • Wind Gust — maximálna rýchlosť vetra, konvertovaná z m/s na km/h
  • Wind Direction — aktuálny smer vetra v stupňoch (0–360)
  • Average Wind Direction — priemerný smer vetra v stupňoch
Zrážky
  • Rain Rate — aktuálna intenzita zrážok v mm/h
  • Rainfall Today — kumulatívne zrážky od polnoci v mm
Atmosférické a solárne údaje
  • Atmospheric Pressure — atmosférický tlak v hPa
  • Solar Radiation — slnečné žiarenie vo W/m². Voliteľné — dostupné len na staniciach vybavených senzorom slnečného žiarenia.
  • UV Index — úroveň UV žiarenia zobrazená ako viachodnotový indikátor s 10 pomenovanými úrovňami: 0–1 Low, 2–3 Medium, 4–5 Medium High, 6–7 High, 8–9 Very High. Voliteľné — vyžaduje UV senzor na stanici.
Aktuálnosť dát
  • Last Update Time — Unix timestamp (sekundy) posledného nahratia dát z meteostanice. Užitočné na overenie, či stanica aktívne reportuje.
Ďalšie možnosti

Weathercloud API tiež poskytuje heat index, teplotno-vlhkostno-veterný (THW) index, viditeľnosť, sekundárne senzory teploty a vlhkosti a údaje o vnútornom prostredí (teplota, vlhkosť, rosný bod, heat index — dostupné len pre vlastníka stanice). Tieto je možné pridať v budúcej aktualizácii šablóny.

Riešenie problémov

Údaje sa neaktualizujú
  1. Skontrolujte hodnotu Last Update Time — ak nenapreduje, meteostanica prestala nahrávať údaje na Weathercloud
  2. Overte, že stanica je online na app.weathercloud.net — vyhľadajte Device ID a skontrolujte časovú značku poslednej aktualizácie
  3. Bezplatné účty Weathercloud sa aktualizujú každých 10 minút. Hoci TapHome sa dopytuje každých 15 sekúnd, nové údaje sa objavia až v intervale nahrávania stanice.
Všetky hodnoty zobrazujú NaN
  1. Potvrďte, že Device ID je správne — musí to byť desaťmiestne číslo z nastavení Weathercloud „Link device", nie názov stanice
  2. Skontrolujte hodnotu cookie v read scripte šablóny. Ak session expirovala, API vráti chybu a všetky zariadenia zobrazia NaN. Znova sa autentifikujte a aktualizujte cookie.
  3. Overte, že stanica existuje a je verejne prístupná na Weathercloud — súkromné stanice môžu vyžadovať autentifikáciu vlastníka
Niektoré senzory zobrazujú NaN, kým ostatné fungujú

Nie všetky meteostanice majú rovnaké senzory. Polia ako slnečné žiarenie (solarrad), UV index (uvi) a wind chill (chill) sú voliteľné a závisia od fyzického vybavenia stanice. Ak stanica dané pole nereportuje, API ho vynechá a šablóna vráti NaN pre dané zariadenie.

Interval dopytovania šablóny je 15 sekúnd, ale údaje Weathercloud sa obnovujú len v intervale nahrávania stanice (10 minút pre bezplatné účty, 1 minúta pre platené). Častejšie dopytovanie neprináša novšie údaje — len potvrdzuje posledné dostupné meranie.

Dostupné zariadenia

WeatherCloud Modul
Vlastné premenné
code (string)WeatherCloud station device ID used in API request URL (set during import)

WeatherCloud

Čítanie (modul)
#documentation https://github.com/maxime-mrl/weathercloud-js/blob/main/api-documentation.md#api-documentation
VAR request := HTTPREQUEST("/device/values?code=" + code, "GET");
request.Headers := { "Content-Type: application/x-www-form-urlencoded; charset=UTF-8", "X-Requested-With: XMLHttpRequest", "cookie: COOKIE"};
request.Method := "GET";
VAR response := SENDHTTPREQUEST(request);


IF response.IsSuccess
    VAR content := response.Content;
    responseJson := content;
    END
Priemerný smer vetra Premenná Len na čítanie
numeric Jednotka: ° json_path

Priemerný smer vetra

Čítanie
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"wdiravg"))
Priemerná rýchlosť vetra Premenná Len na čítanie

Priemerná rýchlosť vetra za reportovací interval stanice — konvertovaná z m/s na km/h

numeric Jednotka: km/h json_path

Priemerná rýchlosť vetra

Čítanie
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"wspdavg")*3.6)
Teplota a vlhkosť Teplotný senzor Len na čítanie

Vonkajšia teplota (°C) a relatívna vlhkosť z meteostanice

numeric Jednotka: °C / % json_path

Teplota a vlhkosť

Čítanie vlhkosti
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"hum")/100)
Čítanie teploty
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"temp"))
Rosný bod Premenná Len na čítanie
numeric Jednotka: °C json_path

Rosný bod

Čítanie
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"dew"))
Atmosférický tlak Premenná Len na čítanie
numeric Jednotka: hPa json_path

Atmosférický tlak

Čítanie
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"bar"))
Intenzita zrážok Premenná Len na čítanie
numeric Jednotka: mm/h json_path

Intenzita zrážok

Čítanie
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"rainrate"))
Zrážky dnes Premenná Len na čítanie
numeric Jednotka: mm json_path

Zrážky dnes

Čítanie
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"rain"))
Slnečné žiarenie Premenná Len na čítanie

Slnečné žiarenie vo W/m² — dostupné len na staniciach so senzorom slnečného žiarenia

numeric Jednotka: W/m² json_path

Slnečné žiarenie

Čítanie
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"solarrad"))
Čas poslednej aktualizácie Premenná Len na čítanie

Unix timestamp posledného nahratia dát z meteostanice — užitočné na overenie aktivity stanice

numeric json_path

Čas poslednej aktualizácie

Čítanie
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"epoch"))
UV index Viacstavový prepínač Len na čítanie

Úroveň UV žiarenia — 0-1 Nízka, 2-3 Stredná, 4-5 Stredne vysoká, 6-7 Vysoká, 8-9 Veľmi vysoká

integer multi_value
Hodnoty / Stavy: 0 - Low · 1 - Low · 2 - Medium · 3 - Medium · 4 - Medium High · 5 - Medium High · 6 - High · 7 - High · 8 - Very High · 9 - Very High

UV index

Čítanie stavu prepínača
IF(ISNULL(responseJson) | responseJson = "error", NaN, round(PARSEJSON(responseJson,"uvi")))
Smer vetra Premenná Len na čítanie
numeric Jednotka: ° json_path

Smer vetra

Čítanie
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"wdir"))
Náraz vetra Premenná Len na čítanie

Maximálna rýchlosť vetra — konvertovaná z m/s na km/h

numeric Jednotka: km/h json_path

Náraz vetra

Čítanie
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"wspdhi")*3.6)
Pocitová teplota Premenná Len na čítanie

Pocitová teplota zohľadňujúca chladivý efekt vetra — nie všetky stanice reportujú túto hodnotu

numeric Jednotka: °C json_path

Pocitová teplota

Čítanie
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"chill"))
Rýchlosť vetra Premenná Len na čítanie

Aktuálna rýchlosť vetra — konvertovaná z m/s na km/h

numeric Jednotka: km/h json_path

Rýchlosť vetra

Čítanie
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"wspd")*3.6)
Pripojenie: Packet Parser → HTTP
Možné vylepšenia (9)
  • Heat Index — Perceived temperature accounting for humidity. Optional field, unit °C.
  • Temperature-Humidity-Wind Index — Combined feel-like index considering temperature, humidity, and wind. Optional field, unit °C.
  • Visibility — Visibility in 100m units (divide by 100 for km). Optional field.
  • Secondary Temperature — Secondary temperature sensor reading. Optional field, unit °C.
  • Secondary Humidity — Secondary humidity sensor reading. Optional field, unit %.
  • Indoor Temperature — Indoor temperature — requires owner authentication. Unit °C.
  • Indoor Humidity — Indoor humidity — requires owner authentication. Unit %.
  • Indoor Dew Point — Indoor dew point — requires owner authentication. Unit °C.
  • Indoor Heat Index — Indoor heat index — requires owner authentication. Unit °C.

Zdroje

  • Weathercloud API Documentation (unofficial, reverse-engineered)
    github.com 2026-03-28
  • Weathercloud FAQ & Setup Guide
    weathercloud.net 2026-03-28