---
title: "Weathercloud"
description: "Integracija vremenskih podataka Weathercloud: podaci meteorološke postaje u stvarnom vremenu (temperatura, vlažnost, vjetar, kiša, UV indeks) preko HTTP-a."
url: "https://taphome.com/hr/compatibility/weathercloud/"
language: hr
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["http","sensor","weather","cloud-service","packet-parser"]
  questions: ["Kako integrirati Weathercloud sa sustavom TapHome?","Koje vremenske podatke daje predložak TapHome za Weathercloud?","Kako dobiti Device ID postaje Weathercloud za TapHome?","Zašto Weathercloud u sustavu TapHome prikazuje zastarjele podatke?","Kako se autentificirati na Weathercloud za integraciju sa sustavom TapHome?","Koje senzore očitava predložak Weathercloud?"]
---

# Weathercloud

Komunikacija: Packet Parser → HTTP

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

## Upute za integraciju

Weathercloud je platforma za vremenske podatke u oblaku s globalnom mrežom od više od 100 000 privatnih meteoroloških postaja. TapHome se na Weathercloud spaja preko predloška HTTP Packet Parser koji očitava vremenske podatke u stvarnom vremenu iz internog web API-ja platforme. Integracija služi samo za čitanje: svih 14 uređaja u predlošku su senzori koji prikazuju vremenske podatke s povezane postaje.

> [!WARNING]
> Ova integracija koristi **neslužbeni API dobiven obrnutim inženjeringom** (interne krajnje točke web-aplikacije Weathercloud). Weathercloud ne nudi javni API za dohvat podataka. Krajnje točke mogu se promijeniti ili biti blokirane bez najave.

## Konfiguracija

Pri uvozu predloška unesite **Device ID**, deseteroznamenkasti broj koji označava meteorološku postaju na Weathercloudu. Predložak s tim ID-om očitava `app.weathercloud.net/device/values?code={DeviceID}`.

### Dohvat Device ID-a

1. Prijavite se u račun Weathercloud na [weathercloud.net](https://weathercloud.net)
2. U izborniku profila otvorite stranicu **Devices**
3. Na ciljnom uređaju kliknite ikonu zupčanika **Settings**
4. Odaberite **Link device**: **Weathercloud ID** je traženi Device ID

### Autentifikacija kolačićem

API Weathercloud za autentifikaciju zahtijeva kolačić sesije (cookie). Predložak uz svaki zahtjev šalje zaglavlje `cookie`. Za dobivanje valjanog kolačića sesije:

1. Prijavite se na `app.weathercloud.net` u pregledniku
2. Otvorite alate za razvojne programere preglednika (F12) i pregledajte zaglavlja zahtjeva
3. Kopirajte cijelu vrijednost `cookie` iz bilo kojeg zahtjeva prema `app.weathercloud.net`
4. U zaglavlju skripte za čitanje predloška zamijenite rezervirano mjesto `COOKIE` stvarnim nizom kolačića

Kolačići sesije istječu nakon razdoblja neaktivnosti. Ako integracija prestane vraćati podatke, ponovno se prijavite i ažurirajte vrijednost kolačića u sustavu TapHome.

## Mogućnosti uređaja

Predložak daje 14 uređaja samo za čitanje koji raščlanjuju polja iz jednog odgovora JSON. Svi uređaji dijele isti mehanizam očitavanja preko HTTP-a s intervalom očitavanja od 15 sekundi (UV indeks očitava se svakih 2,5 sekunde). Svaka skripta za čitanje sadrži obradu pogrešaka: ako je odgovor `null` ili sadrži `"error"`, uređaj vraća `NaN`.

### Temperatura i vlažnost

- **Temperatura i vlažnost** — vanjska temperatura u °C i relativna vlažnost. API vlažnost javlja kao 0–100, a predložak je pretvara u omjer 0–1.
- **Točka rosišta** — temperatura točke rosišta u °C
- **Osjetna temperatura (wind chill)** — osjetna temperatura koja uzima u obzir hlađenje vjetrom, u °C. Neobavezno: ne javljaju sve postaje osjetnu temperaturu.

### Mjerenje vjetra

- **Brzina vjetra** — trenutačna brzina vjetra, pretvara se iz m/s u km/h (množi se s 3,6)
- **Prosječna brzina vjetra** — prosječna brzina vjetra u intervalu slanja podataka postaje, pretvara se iz m/s u km/h
- **Udar vjetra** — najveća brzina vjetra, pretvara se iz m/s u km/h
- **Smjer vjetra** — trenutačni smjer vjetra u stupnjevima (0–360)
- **Prosječni smjer vjetra** — prosječni smjer vjetra u stupnjevima

### Oborine

- **Intenzitet kiše** — trenutačni intenzitet oborina u mm/h
- **Oborine danas** — ukupna količina oborina od ponoći u mm

### Atmosfera i sunce

- **Atmosferski tlak** — barometarski tlak u hPa
- **Sunčevo zračenje** — sunčevo zračenje u W/m². Neobavezno: dostupno samo na postajama sa senzorom sunčevog zračenja.
- **UV indeks** — razina UV zračenja prikazana kao pokazatelj s više vrijednosti s 10 vrijednosti grupiranih u 5 imenovanih razina: 0–1 niska, 2–3 srednja, 4–5 srednje visoka, 6–7 visoka, 8–9 vrlo visoka. Neobavezno: postaja mora imati UV senzor.

### Svježina podataka

- **Vrijeme posljednjeg ažuriranja** — Unix vremenska oznaka (u sekundama) posljednjeg slanja podataka s meteorološke postaje. Korisno za provjeru da postaja aktivno šalje podatke.

### Dodatne mogućnosti

API Weathercloud daje i toplinski indeks (heat index), indeks THW (temperatura-vlažnost-vjetar), vidljivost, dodatne senzore temperature i vlažnosti te očitanja u zatvorenom prostoru (temperatura, vlažnost, točka rosišta, toplinski indeks; dostupno samo vlasniku postaje). Mogu se dodati u budućem ažuriranju predloška.

## Rješavanje problema

### Podaci se ne ažuriraju

1. Provjerite vrijednost **Vrijeme posljednjeg ažuriranja**: ako se ne mijenja, meteorološka postaja je prestala slati podatke na Weathercloud
2. Na `app.weathercloud.net` provjerite je li postaja na mreži: potražite Device ID i provjerite vremensku oznaku posljednjeg ažuriranja
3. Besplatni računi Weathercloud ažuriraju se svakih 10 minuta. Iako TapHome očitava svakih 15 sekundi, novi se podaci pojavljuju tek u intervalu slanja postaje.

### Sve vrijednosti prikazuju NaN

1. Provjerite je li **Device ID** ispravan: mora biti deseteroznamenkasti broj iz postavki Weathercloud „Link device”, a ne naziv postaje
2. Provjerite vrijednost **cookie** u skripti za čitanje predloška. Ako je sesija istekla, API vraća pogrešku i svi uređaji prelaze na NaN. Ponovno se prijavite i ažurirajte kolačić.
3. Provjerite postoji li postaja i je li javno dostupna na Weathercloudu: privatne postaje mogu zahtijevati autentifikaciju vlasnika

### Neki senzori prikazuju NaN, a drugi rade

Nemaju sve meteorološke postaje iste senzore. Polja kao što su sunčevo zračenje (`solarrad`), UV indeks (`uvi`) i osjetna temperatura (`chill`) neobavezna su i ovise o hardveru postaje. Ako postaja neko polje ne javlja, API ga izostavlja i predložak za taj uređaj vraća NaN.

> [!NOTE]
> Interval očitavanja predloška je 15 sekundi, ali se podaci na Weathercloudu osvježavaju tek u intervalu slanja postaje (10 minuta za besplatne račune, 1 minuta za plaćene). Češće očitavanje ne donosi novije podatke, samo potvrđuje posljednje dostupno očitanje.

## Dostupni uređaji 14

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

WeatherCloud Modul

Prilagođene varijable

|                 |                                                                                                               |
|-----------------|---------------------------------------------------------------------------------------------------------------|
| `code` (string) | ID uređaja meteorološke postaje WeatherCloud koji se koristi u URL-u zahtjeva API-ja (postavlja se pri uvozu) |

Čitanje (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
```

Prosječni smjer vjetra Varijabla Samo za čitanje

numeric Jedinica: ° json\_path

Čitanje

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

Prosječna brzina vjetra Varijabla Samo za čitanje

Prosječna brzina vjetra u intervalu slanja podataka postaje — pretvara se iz m/s u km/h

numeric Jedinica: km/h json\_path

Čitanje

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

Temperatura i vlažnost Senzor temperature Samo za čitanje

Vanjska temperatura (°C) i relativna vlažnost s meteorološke postaje

numeric Jedinica: °C / % json\_path

Čitanje vlažnosti

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

Čitanje temperature

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

Točka rosišta Varijabla Samo za čitanje

numeric Jedinica: °C json\_path

Čitanje

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

Atmosferski tlak Varijabla Samo za čitanje

numeric Jedinica: hPa json\_path

Čitanje

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

Intenzitet kiše Varijabla Samo za čitanje

numeric Jedinica: mm/h json\_path

Čitanje

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

Oborine danas Varijabla Samo za čitanje

numeric Jedinica: mm json\_path

Čitanje

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

Sunčevo zračenje Varijabla Samo za čitanje

Sunčevo zračenje u W/m² — dostupno samo na postajama sa senzorom sunčevog zračenja

numeric Jedinica: W/m² json\_path

Čitanje

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

Vrijeme posljednjeg ažuriranja Varijabla Samo za čitanje

Unix vremenska oznaka posljednjeg slanja podataka s meteorološke postaje — korisno za provjeru aktivnosti postaje

numeric json\_path

Čitanje

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

UV indeks Prekidač s više vrijednosti Samo za čitanje

Razina UV zračenja — 0–1 niska, 2–3 srednja, 4–5 srednje visoka, 6–7 visoka, 8–9 vrlo visoka

integer multi\_value

Vrijednosti / stanja: 0 - Low · 1 - Low · 2 - Medium · 3 - Medium · 4 - Medium High · 5 - Medium High · 6 - High · 7 - High · 8 - Very High · 9 - Very High

Čitanje stanja sklopke

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

Smjer vjetra Varijabla Samo za čitanje

numeric Jedinica: ° json\_path

Čitanje

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

Udar vjetra Varijabla Samo za čitanje

Najveća brzina vjetra — pretvara se iz m/s u km/h

numeric Jedinica: km/h json\_path

Čitanje

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

Osjetna temperatura (wind chill) Varijabla Samo za čitanje

Osjetna temperatura koja uzima u obzir hlađenje vjetrom — ne javljaju sve postaje ovu vrijednost

numeric Jedinica: °C json\_path

Čitanje

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

Brzina vjetra Varijabla Samo za čitanje

Trenutačna brzina vjetra — pretvara se iz m/s u km/h

numeric Jedinica: km/h json\_path

Čitanje

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

**Povezivanje:** Packet Parser → HTTP

Moguća poboljšanja (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.

## Parametri uvoza

Ove vrijednosti unosite pri uvozu XML-a.

| Pitanje u aplikaciji | Zadano    |
|----------------------|-----------|
| Device ID            | `xxxxxxx` |

## Izvori

- 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

## Povezana dokumentacija

- [Packet Parser Integration](https://taphome.com/hr/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hr/docs/integration/packet-parser/)
- [Funkcije Packet parsera](https://taphome.com/hr/docs/script/packet-parser/)
- [Funkcije za raščlambu](https://taphome.com/hr/docs/script/parsing-functions/)

