TapHome

Weathercloud

Packet Parser → HTTP
Přidal
Poslední aktualizace: 03. 2026
Weathercloud

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.

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

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 pojmenovanými úrovněmi: 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í.

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í

WeatherCloud Modul
Vlastní proměnné
code (string)WeatherCloud station device ID used in API request URL (set during import)

WeatherCloud

Čtení (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
Průměrný směr větru Proměnná Pouze ke čtení
numeric Jednotka: ° json_path

Průměrný směr větru

Čtení
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

Průměrná rychlost větru

Čtení
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

Teplota a vlhkost

Čtení vlhkosti
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"hum")/100)
Čtení teploty
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"temp"))
Rosný bod Proměnná Pouze ke čtení
numeric Jednotka: °C json_path

Rosný bod

Čtení
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"dew"))
Atmosférický tlak Proměnná Pouze ke čtení
numeric Jednotka: hPa json_path

Atmosférický tlak

Čtení
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"bar"))
Intenzita srážek Proměnná Pouze ke čtení
numeric Jednotka: mm/h json_path

Intenzita srážek

Čtení
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"rainrate"))
Srážky dnes Proměnná Pouze ke čtení
numeric Jednotka: mm json_path

Srážky dnes

Čtení
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

Sluneční záření

Čtení
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

Čas poslední aktualizace

Čtení
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

UV index

Čtení stavu přepínače
IF(ISNULL(responseJson) | responseJson = "error", NaN, round(PARSEJSON(responseJson,"uvi")))
Směr větru Proměnná Pouze ke čtení
numeric Jednotka: ° json_path

Směr větru

Čtení
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

Náraz větru

Čtení
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

Pocitová teplota

Čtení
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

Rychlost větru

Čtení
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.

Zdroje

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