---
title: "Weathercloud"
description: "Weathercloud felhőalapú időjárásadat-integráció. Valós idejű állomásadatok — hőmérséklet, páratartalom, szél, csapadék, UV-index — HTTP-n a TapHome-ban."
url: "https://taphome.com/hu/compatibility/weathercloud/"
language: hu
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["http","sensor","weather","cloud-service","packet-parser"]
  questions: ["Hogyan integrálható a Weathercloud a TapHome-mal?","Milyen időjárási adatokat biztosít a Weathercloud TapHome sablon?","Hogyan szerezheted meg a Weathercloud Device ID-t a TapHome-hoz?","Miért mutat elavult adatokat a Weathercloud a TapHome-ban?","Hogyan történik a hitelesítés a Weathercloud-nál a TapHome integrációhoz?","Milyen szenzorokat olvas ki a Weathercloud sablon?"]
---

# Weathercloud

Kommunikáció: Packet Parser → HTTP

- [Weathercloud weboldal](https://weathercloud.net)

## Integrációs útmutató

A Weathercloud egy felhő alapú időjárás-adat platform, amely több mint 100 000 magán időjárás-állomásból álló globális hálózattal rendelkezik. A TapHome HTTP Packet Parser sablonon keresztül kapcsolódik a Weathercloudhoz, és a platform belső webes API-jából kérdezi le az aktuális időjárási adatokat. Az integráció csak olvasható — a sablon mind a 14 eszköze szenzor, amelyek a csatolt állomás időjárási adatait jelenítik meg.

> [!WARNING]
> Ez az integráció **nem hivatalos, visszafejtett API-t** használ (a Weathercloud webalkalmazás belső végpontjait). A Weathercloud nem kínál nyilvános API-t adatlekérdezéshez. A végpontok előzetes értesítés nélkül megváltozhatnak vagy blokkolhatók.

## Konfiguráció

A sablon importálásakor add meg a **Device ID-t** — egy tízjegyű számot, amely a Weathercloud-on azonosítja az időjárás-állomást. A sablon ezt az ID-t használja az `app.weathercloud.net/device/values?code={DeviceID}` lekérdezésére.

### A Device ID megszerzése

1. Jelentkezz be a Weathercloud fiókba a [weathercloud.net](https://weathercloud.net) oldalon
2. Nyisd meg a **Devices** oldalt a profilmenüből
3. Kattints a **Settings** (fogaskerék) ikonra a céleszköznél
4. Válaszd a **Link device** lehetőséget — a **Weathercloud ID** a szükséges Device ID

### Cookie-hitelesítés

A Weathercloud API session cookie-t igényel a hitelesítéshez. A sablon minden kéréshez `cookie` fejlécet küld. Érvényes session cookie beszerzéséhez:

1. Jelentkezz be az `app.weathercloud.net` oldalra böngészőben
2. Nyisd meg a böngésző fejlesztői eszközeit (F12), és vizsgáld meg a kérés fejléceket
3. Másold ki a teljes `cookie` értéket bármelyik `app.weathercloud.net`-hez intézett kérésből
4. Cseréld ki a `COOKIE` helyőrzőt a sablon olvasási szkriptjének fejlécében a tényleges cookie karakterláncra

A session cookie-k inaktivitás után lejárnak. Ha az integráció nem ad vissza adatokat, hitelesítsd magad újra, és frissítsd a cookie értéket a TapHome-ban.

## Eszközfunkciók

A sablon 14 csak olvasható eszközt biztosít, amelyek egyetlen JSON válasz mezőit elemzik. Minden eszköz ugyanazt a HTTP polling mechanizmust használja 15 másodperces intervallummal (az UV Index 2,5 másodpercenként kérdez le). Minden olvasási szkript tartalmaz hibakezelést — ha a válasz null vagy `"error"` szöveget tartalmaz, az eszköz `NaN`-t ad vissza.

### Hőmérséklet és páratartalom

- **Temperature & Humidity** — kültéri hőmérséklet °C-ban és relatív páratartalom. A páratartalmat az API 0–100 értékként jelenti, a sablon 0–1 arányra konvertálja.
- **Dew Point** — harmatpont hőmérséklete °C-ban
- **Wind Chill** — a szél hűtő hatását figyelembe vevő érzett hőmérséklet, °C-ban. Opcionális — nem minden állomás jelenti a wind chill értéket.

### Szélmérések

- **Wind Speed** — aktuális szélsebesség, m/s-ról km/h-ra konvertálva (3,6-tal szorozva)
- **Average Wind Speed** — átlagos szélsebesség az állomás jelentési intervallumában, m/s-ról km/h-ra konvertálva
- **Wind Gust** — csúcsszélsebesség, m/s-ról km/h-ra konvertálva
- **Wind Direction** — aktuális szélirány fokban (0–360)
- **Average Wind Direction** — átlagos szélirány fokban

### Csapadék

- **Rain Rate** — aktuális csapadékintenzitás mm/h-ban
- **Rainfall Today** — halmozott csapadék éjfél óta mm-ben

### Légköri és napenergia-adatok

- **Atmospheric Pressure** — légköri nyomás hPa-ban
- **Solar Radiation** — napsugárzás W/m²-ben. Opcionális — csak napsugárzás-érzékelővel felszerelt állomásokon érhető el.
- **UV Index** — UV sugárzási szint többértékű kijelzőként 10 értékkel, 5 elnevezett szintbe csoportosítva: 0–1 Low, 2–3 Medium, 4–5 Medium High, 6–7 High, 8–9 Very High. Opcionális — UV szenzort igényel az állomáson.

### Adatfrissesség

- **Last Update Time** — Unix időbélyeg (másodperc) az időjárás-állomás utolsó adatfeltöltéséről. Hasznos annak ellenőrzéséhez, hogy az állomás aktívan jelent-e.

### További lehetőségek

A Weathercloud API emellett hőérzeti indexet, hőmérséklet-páratartalom-szél (THW) indexet, látótávolságot, másodlagos hőmérséklet- és páratartalom-érzékelőket, valamint beltéri környezeti adatokat is szolgáltat (hőmérséklet, páratartalom, harmatpont, hőérzeti index — csak az állomás tulajdonosa számára elérhető). Ezek egy jövőbeli sablonfrissítésben adhatók hozzá.

## Hibaelhárítás

### Az adatok nem frissülnek

1. Ellenőrizd a **Last Update Time** értéket — ha nem halad előre, az időjárás-állomás leállította a feltöltést a Weathercloudba
2. Ellenőrizd, hogy az állomás online-e az `app.weathercloud.net` oldalon — keresd meg a Device ID-t, és nézd meg az utolsó frissítés időbélyegét
3. Az ingyenes Weathercloud fiókok 10 percenként frissülnek. Bár a TapHome 15 másodpercenként kérdez le, az új adatok csak az állomás feltöltési intervallumában jelennek meg.

### Minden érték NaN-t mutat

1. Győződj meg róla, hogy a **Device ID** helyes — az a Weathercloud „Link device" beállításokból származó tízjegyű szám kell legyen, nem az állomás neve
2. Ellenőrizd a **cookie** értéket a sablon olvasási szkriptjében. Ha a session lejárt, az API hibát ad vissza, és minden eszköz NaN-t mutat. Hitelesítsd magad újra, és frissítsd a cookie-t.
3. Ellenőrizd, hogy az állomás létezik-e és nyilvánosan elérhető-e a Weathercloud-on — a privát állomások tulajdonosi hitelesítést igényelhetnek

### Egyes szenzorok NaN-t mutatnak, míg mások működnek

Nem minden időjárás-állomásnak vannak ugyanazok a szenzorai. Az olyan mezők, mint a napsugárzás (`solarrad`), UV-index (`uvi`) és wind chill (`chill`) opcionálisak, és az állomás fizikai felszereltségétől függnek. Ha az állomás nem jelent egy mezőt, az API kihagyja, és a sablon az adott eszközhöz NaN-t ad vissza.

> [!NOTE]
> A sablon lekérdezési intervalluma 15 másodperc, de a Weathercloud adatok csak az állomás feltöltési ütemében frissülnek (10 perc ingyenes fiókoknál, 1 perc fizetőseknél). A gyakoribb lekérdezés nem hoz frissebb adatokat — csak az utolsó elérhető mérést erősíti meg.

## Elérhető eszközök 14

Ezek az eszközök az importálás után jelennek meg a TapHome-ban.

WeatherCloud Modul

Egyéni változók

|                 |                                                                                                                       |
|-----------------|-----------------------------------------------------------------------------------------------------------------------|
| `code` (string) | A WeatherCloud állomás eszközazonosítója, amelyet az API kérés URL-jében használnak (importáláskor kerül beállításra) |

Olvasás (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
```

Átlagos szélirány Változó Csak olvasható

numeric Egység: ° json\_path

Olvasás

```taphome
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"wdiravg"))
```

Átlagos szélsebesség Változó Csak olvasható

Átlagos szélsebesség az állomás jelentési intervallumában — m/s-ról km/h-ra konvertálva

numeric Egység: km/h json\_path

Olvasás

```taphome
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"wspdavg")*3.6)
```

Hőmérséklet és páratartalom Hőmérséklet-érzékelő Csak olvasható

Kültéri hőmérséklet (°C) és relatív páratartalom az időjárás-állomásról

numeric Egység: °C / % json\_path

Páratartalom olvasása

```taphome
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"hum")/100)
```

Hőmérséklet olvasása

```taphome
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"temp"))
```

Harmatpont Változó Csak olvasható

numeric Egység: °C json\_path

Olvasás

```taphome
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"dew"))
```

Légköri nyomás Változó Csak olvasható

numeric Egység: hPa json\_path

Olvasás

```taphome
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"bar"))
```

Csapadékintenzitás Változó Csak olvasható

numeric Egység: mm/h json\_path

Olvasás

```taphome
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"rainrate"))
```

Mai csapadék Változó Csak olvasható

numeric Egység: mm json\_path

Olvasás

```taphome
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"rain"))
```

Napsugárzás Változó Csak olvasható

Napsugárzás W/m²-ben — csak napsugárzás-érzékelővel felszerelt állomásokon érhető el

numeric Egység: W/m² json\_path

Olvasás

```taphome
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"solarrad"))
```

Utolsó frissítés ideje Változó Csak olvasható

Az időjárás-állomás utolsó adatfeltöltésének Unix időbélyege — hasznos az állomás aktivitásának ellenőrzéséhez

numeric json\_path

Olvasás

```taphome
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"epoch"))
```

UV-index Többértékű kapcsoló Csak olvasható

UV sugárzási szint — 0-1 Alacsony, 2-3 Közepes, 4-5 Közepesen magas, 6-7 Magas, 8-9 Nagyon magas

integer multi\_value

Értékek / Állapotok: 0 - Low · 1 - Low · 2 - Medium · 3 - Medium · 4 - Medium High · 5 - Medium High · 6 - High · 7 - High · 8 - Very High · 9 - Very High

Kapcsoló állapot olvasása

```taphome
IF(ISNULL(responseJson) | responseJson = "error", NaN, round(PARSEJSON(responseJson,"uvi")))
```

Szélirány Változó Csak olvasható

numeric Egység: ° json\_path

Olvasás

```taphome
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"wdir"))
```

Széllökés Változó Csak olvasható

Csúcsszélsebesség — m/s-ról km/h-ra konvertálva

numeric Egység: km/h json\_path

Olvasás

```taphome
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"wspdhi")*3.6)
```

Szélhűtés Változó Csak olvasható

A szél hűtő hatását figyelembe vevő érzett hőmérséklet — nem minden állomás jelenti ezt az értéket

numeric Egység: °C json\_path

Olvasás

```taphome
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"chill"))
```

Szélsebesség Változó Csak olvasható

Aktuális szélsebesség — m/s-ról km/h-ra konvertálva

numeric Egység: km/h json\_path

Olvasás

```taphome
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"wspd")*3.6)
```

**Kapcsolat:** Packet Parser → HTTP

Lehetséges fejlesztések (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.

## Importálási paraméterek

Ezeket az értékeket az XML importálásakor adja meg.

| Az alkalmazás kéri | Alapérték |
|--------------------|-----------|
| Device ID          | `xxxxxxx` |

## Források

- 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

## Kapcsolódó dokumentáció

- [Packet Parser integráció](https://taphome.com/hu/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hu/docs/integration/packet-parser/)
- [Packet parser függvények](https://taphome.com/hu/docs/script/packet-parser/)
- [Elemző függvények](https://taphome.com/hu/docs/script/parsing-functions/)