--- title: "Weathercloud" description: "Integrace cloudových dat Weathercloud. Aktuální data z meteostanice — teplota, vlhkost, vítr, srážky, UV index a další — přes HTTP v TapHome." url: "https://taphome.com/cs/compatibility/weathercloud/" language: cs lastmod: 2026-10-08 generator: hugo ai: topics: ["http","sensor","weather","cloud-service","packet-parser"] questions: ["Jak integrovat Weathercloud s TapHome?","Jaká meteorologická data poskytuje šablona Weathercloud pro TapHome?","Jak získat Weathercloud Device ID pro TapHome?","Proč Weathercloud zobrazuje neaktuální data v TapHome?","Jak se autentizovat ve Weathercloud pro integraci s TapHome?","Jaké senzory šablona Weathercloud čte?"] --- # Weathercloud Komunikace: Packet Parser → HTTP - [Stránka Weathercloud](https://weathercloud.net) ## Návod na integraci Weathercloud je cloudová meteorologická platforma s globální sítí více než 100 000 osobních meteostanic. TapHome se připojuje k Weathercloud přes HTTP Packet Parser šablonu, která pravidelně získává aktuální meteorologická data z interního webového API platformy. Integrace je pouze pro čtení — všech 14 zařízení v šabloně jsou senzory zobrazující meteorologická data z připojené stanice. > [!WARNING] > Tato integrace používá **neoficiální, reverzně analyzované API** (interní endpointy webové aplikace Weathercloud). Weathercloud nenabízí veřejné API pro získávání dat. Endpointy se mohou změnit nebo být zablokovány bez upozornění. ## Konfigurace Během importu šablony zadejte **Device ID** — desetimístné číslo identifikující meteostanici na Weathercloud. Šablona používá toto ID k dotazování `app.weathercloud.net/device/values?code={DeviceID}`. ### Získání Device ID 1. Přihlaste se do účtu Weathercloud na [weathercloud.net](https://weathercloud.net) 2. Otevřete stránku **Devices** z profilového menu 3. Klikněte na ikonu **Settings** (ozubené kolečko) u cílového zařízení 4. Vyberte **Link device** — **Weathercloud ID** je požadované Device ID ### Autentizace přes cookie Weathercloud API vyžaduje session cookie pro autentizaci. Šablona odesílá hlavičku `cookie` s každým požadavkem. Pro získání platného session cookie: 1. Přihlaste se na `app.weathercloud.net` v prohlížeči 2. Otevřete vývojářské nástroje prohlížeče (F12) a zkontrolujte hlavičky požadavků 3. Zkopírujte celou hodnotu `cookie` z libovolného požadavku na `app.weathercloud.net` 4. Nahraďte zástupný text `COOKIE` v read scriptu šablony skutečným cookie řetězcem Session cookies expirují po období nečinnosti. Pokud integrace přestane vracet data, znovu se autentizujte a aktualizujte hodnotu cookie v TapHome. ## Možnosti zařízení Šablona poskytuje 14 zařízení pouze pro čtení, která parsují pole z jedné JSON odpovědi. Všechna zařízení sdílejí stejný HTTP polling mechanismus s intervalem 15 sekund (UV Index se dotazuje každé 2,5 sekundy). Každý read script obsahuje ošetření chyb — pokud je odpověď null nebo obsahuje `"error"`, zařízení vrátí `NaN`. ### Teplota a vlhkost - **Temperature & Humidity** — venkovní teplota v °C a relativní vlhkost. Vlhkost je v API reportována jako 0–100 a šablona ji konvertuje na poměr 0–1. - **Dew Point** — teplota rosného bodu v °C - **Wind Chill** — pocitová teplota zohledňující ochlazující efekt větru, v °C. Volitelné — ne všechny stanice reportují wind chill. ### Měření větru - **Wind Speed** — aktuální rychlost větru, konvertovaná z m/s na km/h (násobení 3,6) - **Average Wind Speed** — průměrná rychlost větru za reportovací interval stanice, konvertovaná z m/s na km/h - **Wind Gust** — maximální rychlost větru, konvertovaná z m/s na km/h - **Wind Direction** — aktuální směr větru ve stupních (0–360) - **Average Wind Direction** — průměrný směr větru ve stupních ### Srážky - **Rain Rate** — aktuální intenzita srážek v mm/h - **Rainfall Today** — kumulativní srážky od půlnoci v mm ### Atmosférická a solární data - **Atmospheric Pressure** — atmosférický tlak v hPa - **Solar Radiation** — sluneční záření ve W/m². Volitelné — dostupné pouze na stanicích vybavených senzorem slunečního záření. - **UV Index** — úroveň UV záření zobrazená jako vícehodnotový indikátor s 10 hodnotami seskupenými do 5 pojmenovaných úrovní: 0–1 Low, 2–3 Medium, 4–5 Medium High, 6–7 High, 8–9 Very High. Volitelné — vyžaduje UV senzor na stanici. ### Aktuálnost dat - **Last Update Time** — Unix timestamp (sekundy) posledního nahrání dat z meteostanice. Užitečné pro ověření, zda stanice aktivně reportuje. ### Další možnosti Weathercloud API také poskytuje heat index, teplotně-vlhkostně-větrný (THW) index, viditelnost, sekundární senzory teploty a vlhkosti a data o vnitřním prostředí (teplota, vlhkost, rosný bod, heat index — dostupné pouze pro vlastníka stanice). Tyto lze přidat v budoucí aktualizaci šablony. ## Řešení problémů ### Data se neaktualizují 1. Zkontrolujte hodnotu **Last Update Time** — pokud nepostupuje, meteostanice přestala nahrávat data na Weathercloud 2. Ověřte, že stanice je online na `app.weathercloud.net` — vyhledejte Device ID a zkontrolujte časové razítko poslední aktualizace 3. Bezplatné účty Weathercloud se aktualizují každých 10 minut. Přestože se TapHome dotazuje každých 15 sekund, nová data se objeví až v intervalu nahrávání stanice. ### Všechny hodnoty zobrazují NaN 1. Potvrďte, že **Device ID** je správné — musí to být desetimístné číslo z nastavení Weathercloud „Link device", nikoli název stanice 2. Zkontrolujte hodnotu **cookie** v read scriptu šablony. Pokud session expirovala, API vrátí chybu a všechna zařízení zobrazí NaN. Znovu se autentizujte a aktualizujte cookie. 3. Ověřte, že stanice existuje a je veřejně přístupná na Weathercloud — soukromé stanice mohou vyžadovat autentizaci vlastníka ### Některé senzory zobrazují NaN, zatímco ostatní fungují Ne všechny meteostanice mají stejné senzory. Pole jako sluneční záření (`solarrad`), UV index (`uvi`) a wind chill (`chill`) jsou volitelná a závisí na fyzickém vybavení stanice. Pokud stanice dané pole nereportuje, API ho vynechá a šablona vrátí NaN pro dané zařízení. > [!NOTE] > Interval dotazování šablony je 15 sekund, ale data Weathercloud se obnovují pouze v intervalu nahrávání stanice (10 minut pro bezplatné účty, 1 minuta pro placené). Častější dotazování nepřináší novější data — pouze potvrzuje poslední dostupné měření. ## Dostupná zařízení 14 Tato zařízení se po importu zobrazí v TapHome. WeatherCloud Modul Vlastní proměnné | | | |-----------------|----------------------------------------------------------------------------------------| | `code` (string) | ID zařízení stanice WeatherCloud používané v URL API požadavku (nastaveno při importu) | Čtení (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 ``` Průměrný směr větru Proměnná Pouze ke čtení numeric Jednotka: ° json\_path Čtení ```taphome IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"wdiravg")) ``` Průměrná rychlost větru Proměnná Pouze ke čtení Průměrná rychlost větru za reportovací interval stanice — konvertovaná z m/s na km/h numeric Jednotka: km/h json\_path Čtení ```taphome IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"wspdavg")*3.6) ``` Teplota a vlhkost Teplotní senzor Pouze ke čtení Venkovní teplota (°C) a relativní vlhkost z meteostanice numeric Jednotka: °C / % json\_path Čtení vlhkosti ```taphome IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"hum")/100) ``` Čtení teploty ```taphome IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"temp")) ``` Rosný bod Proměnná Pouze ke čtení numeric Jednotka: °C json\_path Čtení ```taphome IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"dew")) ``` Atmosférický tlak Proměnná Pouze ke čtení numeric Jednotka: hPa json\_path Čtení ```taphome IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"bar")) ``` Intenzita srážek Proměnná Pouze ke čtení numeric Jednotka: mm/h json\_path Čtení ```taphome IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"rainrate")) ``` Srážky dnes Proměnná Pouze ke čtení numeric Jednotka: mm json\_path Čtení ```taphome IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"rain")) ``` Sluneční záření Proměnná Pouze ke čtení Sluneční záření ve W/m² — dostupné pouze na stanicích se senzorem slunečního záření numeric Jednotka: W/m² json\_path Čtení ```taphome IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"solarrad")) ``` Čas poslední aktualizace Proměnná Pouze ke čtení Unix timestamp posledního nahrání dat z meteostanice — užitečné pro ověření aktivity stanice numeric json\_path Čtení ```taphome IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"epoch")) ``` UV index Vícestavový přepínač Pouze ke čtení Úroveň UV záření — 0-1 Nízká, 2-3 Střední, 4-5 Středně vysoká, 6-7 Vysoká, 8-9 Velmi 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 Čtení stavu přepínače ```taphome IF(ISNULL(responseJson) | responseJson = "error", NaN, round(PARSEJSON(responseJson,"uvi"))) ``` Směr větru Proměnná Pouze ke čtení numeric Jednotka: ° json\_path Čtení ```taphome IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"wdir")) ``` Náraz větru Proměnná Pouze ke čtení Maximální rychlost větru — konvertovaná z m/s na km/h numeric Jednotka: km/h json\_path Čtení ```taphome IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"wspdhi")*3.6) ``` Pocitová teplota Proměnná Pouze ke čtení Pocitová teplota zohledňující ochlazující efekt větru — ne všechny stanice reportují tuto hodnotu numeric Jednotka: °C json\_path Čtení ```taphome IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"chill")) ``` Rychlost větru Proměnná Pouze ke čtení Aktuální rychlost větru — konvertovaná z m/s na km/h numeric Jednotka: km/h json\_path Čtení ```taphome IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"wspd")*3.6) ``` **Připojení:** Packet Parser → HTTP Možná vylepšení (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. ## Parametry importu Tyto hodnoty zadáte při importu XML. | Ptá se v aplikaci | Výchozí | |-------------------|-----------| | 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 ## Související dokumentace - [Integrace Packet Parser](https://taphome.com/cs/compatibility/packet-parser-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/cs/docs/integration/packet-parser/) - [Funkce Packet parser](https://taphome.com/cs/docs/script/packet-parser/) - [Funkce pro parsování](https://taphome.com/cs/docs/script/parsing-functions/)