--- title: "Weathercloud" description: "Integrácia cloudových dát Weathercloud. Aktuálne údaje z meteostanice — teplota, vlhkosť, vietor, zrážky, UV index a ďalšie — cez HTTP v TapHome." url: "https://taphome.com/sk/compatibility/weathercloud/" language: sk lastmod: 2026-10-08 generator: hugo ai: topics: ["http","sensor","weather","cloud-service","packet-parser"] questions: ["Ako integrovať Weathercloud s TapHome?","Aké meteorologické údaje poskytuje šablóna Weathercloud pre TapHome?","Ako získať Weathercloud Device ID pre TapHome?","Prečo Weathercloud zobrazuje neaktuálne údaje v TapHome?","Ako sa autentifikovať vo Weathercloud pre integráciu s TapHome?","Aké senzory šablóna Weathercloud číta?"] --- # Weathercloud Komunikácia: Packet Parser → HTTP - [Stránka Weathercloud](https://weathercloud.net) ## Návod na integráciu 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. > [!WARNING] > 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](https://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 ### Autentifikácia cez cookie 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 hodnotami zoskupenými do 5 pomenovaných úrovní: 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. > [!NOTE] > 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 14 Tieto zariadenia sa po importe zobrazia v TapHome. WeatherCloud Modul Vlastné premenné | | | |-----------------|---------------------------------------------------------------------------------------------| | `code` (string) | ID zariadenia stanice WeatherCloud používané v URL API požiadavky (nastavené počas importu) | Čítanie (modul) ```taphome #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 Čítanie ```taphome 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 Čítanie ```taphome 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 Čítanie vlhkosti ```taphome IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"hum")/100) ``` Čítanie teploty ```taphome IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"temp")) ``` Rosný bod Premenná Len na čítanie numeric Jednotka: °C json\_path Čítanie ```taphome IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"dew")) ``` Atmosférický tlak Premenná Len na čítanie numeric Jednotka: hPa json\_path Čítanie ```taphome IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"bar")) ``` Intenzita zrážok Premenná Len na čítanie numeric Jednotka: mm/h json\_path Čítanie ```taphome IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"rainrate")) ``` Zrážky dnes Premenná Len na čítanie numeric Jednotka: mm json\_path Čítanie ```taphome 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 Čítanie ```taphome 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 Čítanie ```taphome 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 Čítanie stavu prepínača ```taphome IF(ISNULL(responseJson) | responseJson = "error", NaN, round(PARSEJSON(responseJson,"uvi"))) ``` Smer vetra Premenná Len na čítanie numeric Jednotka: ° json\_path Čítanie ```taphome 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 Čítanie ```taphome 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 Čítanie ```taphome 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 Čítanie ```taphome 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. ## Parametre importu Tieto hodnoty zadáte pri importe XML. | Pýta sa v aplikácii | Predvolené | |---------------------|------------| | Device ID | `xxxxxxx` | ## Zdroje - Weathercloud API Documentation (unofficial, reverse-engineered) [github.com](https://github.com/maxime-mrl/weathercloud-js/blob/main/api-documentation.md) 2026-03-28 - Weathercloud FAQ & Setup Guide [weathercloud.net](https://weathercloud.net/en/faq) 2026-03-28 ## Súvisiaca dokumentácia - [Integrácia Packet Parser](https://taphome.com/sk/compatibility/packet-parser-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/sk/docs/integration/packet-parser/) - [Funkcie Packet parsera](https://taphome.com/sk/docs/script/packet-parser/) - [Parsovacie funkcie](https://taphome.com/sk/docs/script/parsing-functions/)