TapHome
Službeni · TapHome Provjereno

OpenWeather

Integracija API-ja OpenWeather sa sustavom TapHome — trenutačno vrijeme te prognoze za 3 sata i 24 sata s temperaturom, vlažnošću, tlakom, vidljivošću, brzinom vjetra i vremenskim uvjetima preko API-ja u oblaku (HTTPS).

OpenWeatherPacket Parser → HTTP18 uređajaRevizija 1.0 Posljednje ažuriranje: 28. ožujka 2026.
OpenWeather

Uvoz u aplikaciju TapHomeHardver › Packet Parser › Dodaj iz predloška

Preuzmite predložak
Na ovoj stranici

Upute za integraciju

OpenWeather je pružatelj vremenskih podataka koji preko REST API-ja nudi vremenske informacije za cijeli svijet. Predložak TapHome spaja se preko HTTPS-a na besplatni API OpenWeather v2.5 i za postavljenu lokaciju očitava trenutačne vremenske uvjete, prognozu za 3 sata i prognozu za 24 sata.

Predložak svakih 5 minuta šalje dva poziva API-ju: jedan za trenutačno vrijeme i jedan za prognozu za 5 dana u koracima od 3 sata. Daje 18 uređaja samo za čitanje: temperaturu zraka, osjetnu temperaturu, vlažnost, atmosferski tlak, vidljivost, brzinu vjetra i vremenske uvjete. Sve temperature su u Celzijevim stupnjevima (metričke jedinice), a plaćena pretplata nije potrebna.

Konfiguracija

Dobivanje API ključa

  1. Registrirajte besplatni korisnički račun na openweathermap.org — kreditna kartica nije potrebna
  2. Nakon registracije API ključ (APPID) stiže u e-poruci s potvrdom
  3. Ključ je dostupan i na stranici korisničkog računa, na kartici API key
  4. Novi ključevi aktiviraju se automatski, obično u roku od 10 minuta do 2 sata

Besplatni paket dopušta 60 poziva u minuti i 1 000 000 poziva mjesečno. Predložak TapHome šalje približno 576 poziva dnevno (2 poziva svakih 5 minuta), što je znatno ispod ograničenja besplatnog paketa.

Parametri uvoza

Pri uvozu predloška u TapHome potrebna su tri parametra:

ParametarOpisPrimjer
latitudeZemljopisna širina lokacije u decimalnim stupnjevima48.1778
longitudeZemljopisna dužina lokacije u decimalnim stupnjevima17.1426
appidAPI ključ OpenWeather iz korisničkog računa (dashboard)a1b2c3d4e5f6...

Koordinate lokacije pronaći ćete tako da u Google Maps desnom tipkom miša kliknete na mjesto i u kontekstnom izborniku odaberete koordinate.

Krajnje točke API-ja

Modul se spaja na api.openweathermap.org preko HTTPS-a (port 443) i u svakom ciklusu očitavanja poziva dvije krajnje točke:

1
2
GET /data/2.5/weather?units=metric&lat={latitude}&lon={longitude}&appid={AppId}
GET /data/2.5/forecast?units=metric&lat={latitude}&lon={longitude}&appid={AppId}&cnt=9

Prvi zahtjev vraća trenutačne vremenske uvjete. Drugi vraća popis prognoza u kojem je list[0] sljedeći termin od 3 sata, a list[8] termin za +24 sata (8 x 3 h = 24 h).

Mogućnosti uređaja

Predložak daje 18 uređaja samo za čitanje podijeljenih u tri skupine: trenutačno vrijeme (6 uređaja), prognoza za 3 sata (6 uređaja) i prognoza za 24 sata (6 uređaja). Svaka skupina daje istih šest mjerenja.

Temperatura i vlažnost

  • Trenutačna temperatura zraka — trenutačna temperatura u Celzijevim stupnjevima s vlažnošću kao drugom vrijednošću (API vraća 0–100 %, a za TapHome se pretvara u omjer 0–1)
  • Trenutačna osjetna temperatura — prividna temperatura koja uzima u obzir hlađenje vjetrom i vlažnost. Mjerenje vlažnosti je isključeno (vraća NaN), koristi se samo vrijednost temperature
  • Prognoza (+3 h) temperature zraka — temperatura i vlažnost za sljedeći termin prognoze od 3 sata. Uključuje servisni atribut Datum prognoze s vremenskom oznakom podatka
  • Prognoza (+3 h) osjetne temperature — osjetna temperatura za sljedeći termin od 3 sata
  • Prognoza (+24 h) temperature zraka — temperatura i vlažnost za termin prognoze +24 h. Uključuje servisni atribut Datum prognoze
  • Prognoza (+24 h) osjetne temperature — osjetna temperatura za termin +24 h

Atmosferski tlak i vidljivost

  • Trenutačni tlak zraka — atmosferski tlak u hPa
  • Trenutačna vidljivost — vidljivost u metrima (najviše 10 000 m)
  • Prognoza (+3 h) tlaka zraka — atmosferski tlak za sljedeći termin od 3 sata
  • Prognoza (+3 h) vidljivosti — vidljivost za prognozu od 3 sata
  • Prognoza (+24 h) tlaka zraka — atmosferski tlak za termin +24 h
  • Prognoza (+24 h) vidljivosti — vidljivost za prognozu od 24 sata

Uređaji Prognoza (+3 h) vidljivosti i Prognoza (+24 h) vidljivosti u trenutačnoj verziji predloška imaju zamijenjene indekse podataka. Uređaj +3 h čita iz list[8] (položaj za 24 h), a uređaj +24 h čita iz list[0] (položaj za 3 h). Vrijednosti su zamijenjene dok se to ne ispravi u nekom budućem ažuriranju predloška.

Brzina vjetra

  • Trenutačna brzina vjetra — brzina vjetra u m/s
  • Prognoza (+3 h) brzine vjetra — brzina vjetra za sljedeći termin od 3 sata
  • Prognoza (+24 h) brzine vjetra — brzina vjetra za termin +24 h

Vremenski uvjeti

Tri uređaja s prekidačem s više vrijednosti prikazuju kategoriju vremenskih uvjeta:

  • Trenutačno vrijeme — trenutačni vremenski uvjeti
  • Prognoza (+3 h) vremena — vremenski uvjeti za sljedeći termin od 3 sata
  • Prognoza (+24 h) vremena — vremenski uvjeti za termin +24 h

Svaki od tih uređaja preslikava polje API-ja weather[0].main u jednu od 7 kategorija:

Vrijednost prekidačaOznakaSkupine vremenskih uvjeta u API-ju
0VedroClear
1OblačnoClouds
2KišaRain
3RosuljaDrizzle
4GrmljavinaThunderstorm
5SnijegSnow
6Atmosferske pojaveMist, Smoke, Haze, Dust, Fog, Sand, Ash, Squall, Tornado

Ako API vrati nepoznatu skupinu vremenskih uvjeta, prekidač se postavlja na 0 (Vedro). Vrijednosti prekidača 7, 8 i 9 definirane su u konfiguraciji predloška, ali u logici skripte nemaju preslikavanje — to su neiskorištena rezervirana mjesta.

Dodatne mogućnosti

API OpenWeather daje i smjer vjetra, udare vjetra, postotak naoblake, količinu kiše i snijega (1 h) te vrijeme izlaska i zalaska sunca. Vlažnost je dostupna samo kao druga vrijednost na senzorima temperature, a ne kao zaseban uređaj. Mogu se dodati u nekom budućem ažuriranju predloška.

Rješavanje problema

Svi uređaji prikazuju NaN ili nemaju podataka

  1. Provjerite ima li TapHome Core pristup internetu — predložak zahtijeva odlaznu HTTPS vezu prema api.openweathermap.org
  2. Provjerite je li API ključ valjan — za test u pregledniku otvorite https://api.openweathermap.org/data/2.5/weather?lat=48.18&lon=17.14&appid=YOUR_KEY&units=metric
  3. Aktivacija novih API ključeva može potrajati do 2 sata nakon registracije
  4. Provjerite jesu li zemljopisna širina i dužina ispravne decimalne koordinate (ne stupnjevi/minute/sekunde)

Podaci prognoze čine se netočnima

API za prognozu vraća podatke u koracima od 3 sata. Uređaji +3 h čitaju prvi termin prognoze (list[0]), a to je sljedeći dostupni blok od 3 sata, ne točno 3 sata od sada. Slično tome, uređaji +24 h čitaju list[8] (9. termin), što je otprilike 24 sata unaprijed.

Imajte na umu zamjenu indeksa vidljivosti opisanu u upozorenju iznad — ako se čini da su vrijednosti vidljivosti +3 h i +24 h zamijenjene, riječ je o poznatoj grešci predloška.

Pogreška u nazivu uređaja

Uređaj br. 17 u predlošku nazvan je „Forecast (+24h)Weather” (nedostaje razmak ispred „Weather”). To je kozmetički problem u XML-u predloška i ne utječe na rad. Uređaj se u tablici uređaja TapHome prikazuje ispravno, pod dopunjenim nazivom.

Dostupni uređaji 18

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

OpenWeather Modul
Prilagođene varijable
longitude (string)Zemljopisna dužina lokacije meteorološke postaje u decimalnim stupnjevima (postavlja se pri uvozu)
latitude (string)Zemljopisna širina lokacije meteorološke postaje u decimalnim stupnjevima (postavlja se pri uvozu)
AppId (string)API ključ OpenWeather (besplatni ključ nabavite na openweathermap.org/api)

OpenWeather

Čitanje (modul)
responseJson := "error";
Daily := "error";

VAR path := "data/2.5/weather?units=metric&lat=" + latitude + "&lon=" + longitude + "&appid=" + AppId;
VAR response := SENDHTTPREQUEST(path);

IF response.IsSuccess
    responseJson := response.Content;
ELSE
    VAR contentJson := response.Content;
    VAR errCode := response.StatusCode;
    VAR message := PARSEJSON(contentJson, "message");
    #ADDERROR("Failed to read data - (" + errCode + ") " + message);
END

path := "data/2.5/forecast?units=metric&lat=" + latitude + "&lon=" + longitude + "&appid=" + AppId + "&cnt=9";
response := SENDHTTPREQUEST(path);

IF response.IsSuccess
    Daily := response.Content;
ELSE
    contentJson := response.Content;
    errCode := response.StatusCode;
    message := PARSEJSON(contentJson, "message");
    #ADDERROR("Failed to read data - (" + errCode + ") " + message);
END
Trenutačni tlak zraka Varijabla Samo za čitanje
numeric Jedinica: hPa json_path

Trenutačni tlak zraka

Čitanje
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"main.pressure"))
Čitanje (modul)
IF(ISNULL(responseJson) | responseJson = "error", ADDERROR("Failed to read data "));
Trenutačna temperatura zraka Senzor temperature Samo za čitanje

Trenutačna temperatura i vlažnost — vlažnost se dijeli sa 100 (API vraća 0–100 %, TapHome očekuje omjer 0–1)

numeric Jedinica: °C json_path

Trenutačna temperatura zraka

Čitanje vlažnosti
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"main.humidity") / 100)
Čitanje (modul)
IF(ISNULL(responseJson) | responseJson = "error", ADDERROR("Failed to read data "));
Čitanje temperature
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"main.temp"))
Trenutačna osjetna temperatura Senzor temperature Samo za čitanje

Osjetna temperatura koja uzima u obzir hlađenje vjetrom i vlažnost — mjerenje vlažnosti je isključeno (vraća NaN)

numeric Jedinica: °C json_path

Trenutačna osjetna temperatura

Čitanje vlažnosti
NaN
Čitanje (modul)
IF(ISNULL(responseJson) | responseJson = "error", ADDERROR("Failed to read data "));
Čitanje temperature
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"main.feels_like"))
Trenutačna vidljivost Varijabla Samo za čitanje

Vidljivost u metrima (najviše 10 000 m)

numeric Jedinica: m json_path

Trenutačna vidljivost

Čitanje
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"visibility"))
Čitanje (modul)
IF(ISNULL(responseJson) | responseJson = "error", ADDERROR("Failed to read data "));
Trenutačno vrijeme Prekidač s više vrijednosti Samo za čitanje

Vremenski uvjeti kao prekidač s više vrijednosti — Vedro, Oblačno, Kiša, Rosulja, Grmljavina, Snijeg, Atmosferske pojave

string multi_value_switch
Vrijednosti / stanja: Clear · Clouds · Rain · Drizzle · Thunderstorm · Snow · Atmosphere

Trenutačno vrijeme

Čitanje stanja sklopke
IF(ISNULL(responseJson) | responseJson = "error")
    return(NaN);
END

VAR weather := PARSEJSON(responseJson, "weather[0].main");
SWITCH(weather, "Clear", 0, "Clouds", 1, "Rain", 2, "Drizzle", 3, "Thunderstorm", 4, "Snow", 5, "Mist", 6, "Smoke", 6, "Haze", 6, "Dust", 6, "Fog", 6, "Sand", 6, "Ash", 6, "Squall", 6, "Tornado", 6, 0);
Čitanje (modul)
IF(ISNULL(responseJson) | responseJson = "error", ADDERROR("Failed to read data "));
Trenutačna brzina vjetra Varijabla Samo za čitanje
numeric Jedinica: m/s json_path

Trenutačna brzina vjetra

Čitanje
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"wind.speed"))
Čitanje (modul)
IF(ISNULL(responseJson) | responseJson = "error", ADDERROR("Failed to read data "));
Prognoza (+3 h) tlaka zraka Varijabla Samo za čitanje
numeric Jedinica: hPa json_path

Prognoza (+3 h) tlaka zraka

Čitanje
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[0].main.pressure"))
Čitanje (modul)
IF(ISNULL(responseJson) | responseJson = "error", ADDERROR("Failed to read data "));
Prognoza (+3 h) temperature zraka Senzor temperature Samo za čitanje

Temperatura i vlažnost za sljedeći termin prognoze od 3 sata — uključuje servisni atribut Datum prognoze

numeric Jedinica: °C json_path
Servisni atributi
Datum prognozeVremenska oznaka podatka prognoze (dt_txt iz odgovora API-ja)

Prognoza (+3 h) temperature zraka

Čitanje vlažnosti
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[0].main.humidity") / 100)
Čitanje (modul)
IF(ISNULL(Daily) | Daily = "error", ADDERROR("Failed to read data "));
Čitanje temperature
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[0].main.temp"))
Servisni atributi
Forecast Date
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[0].dt_txt"))
Prognoza (+3 h) osjetne temperature Senzor temperature Samo za čitanje

Osjetna temperatura za sljedeći termin prognoze od 3 sata — mjerenje vlažnosti je isključeno (vraća NaN)

numeric Jedinica: °C json_path

Prognoza (+3 h) osjetne temperature

Čitanje vlažnosti
NaN
Čitanje (modul)
IF(ISNULL(responseJson) | responseJson = "error", ADDERROR("Failed to read data "));
Čitanje temperature
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[0].main.feels_like"))
Prognoza (+3 h) vidljivosti Varijabla Samo za čitanje

Poznati problem: čita iz list[8] umjesto iz list[0] — vrijednosti vidljivosti zamijenjene su s Prognozom (+24 h)

numeric Jedinica: m json_path

Prognoza (+3 h) vidljivosti

Čitanje
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[8].visibility"))
Čitanje (modul)
IF(ISNULL(responseJson) | responseJson = "error", ADDERROR("Failed to read data "));
Prognoza (+3 h) vremena Prekidač s više vrijednosti Samo za čitanje

Vremenski uvjeti za sljedeći termin prognoze od 3 sata — isto preslikavanje u 7 kategorija kao Trenutačno vrijeme

string multi_value_switch
Vrijednosti / stanja: Clear · Clouds · Rain · Drizzle · Thunderstorm · Snow · Atmosphere

Prognoza (+3 h) vremena

Čitanje stanja sklopke
IF(ISNULL(Daily) | Daily = "error")
    return(NaN);
END

VAR weather := PARSEJSON(Daily, "$.list[0].weather[0].main");
SWITCH(weather, "Clear", 0, "Clouds", 1, "Rain", 2, "Drizzle", 3, "Thunderstorm", 4, "Snow", 5, "Mist", 6, "Smoke", 6, "Haze", 6, "Dust", 6, "Fog", 6, "Sand", 6, "Ash", 6, "Squall", 6, "Tornado", 6, 0);
Čitanje (modul)
IF(ISNULL(Daily) | Daily = "error", ADDERROR("Failed to read data "));
Prognoza (+3 h) brzine vjetra Varijabla Samo za čitanje
numeric Jedinica: m/s json_path

Prognoza (+3 h) brzine vjetra

Čitanje
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[0].wind.speed"))
Čitanje (modul)
IF(ISNULL(responseJson) | responseJson = "error", ADDERROR("Failed to read data "));
Prognoza (+24 h) tlaka zraka Varijabla Samo za čitanje
numeric Jedinica: hPa json_path

Prognoza (+24 h) tlaka zraka

Čitanje
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[8].main.pressure"))
Čitanje (modul)
IF(ISNULL(responseJson) | responseJson = "error", ADDERROR("Failed to read data "));
Prognoza (+24 h) temperature zraka Senzor temperature Samo za čitanje

Temperatura i vlažnost za termin prognoze +24 h — uključuje servisni atribut Datum prognoze

numeric Jedinica: °C json_path
Servisni atributi
Datum prognozeVremenska oznaka podatka prognoze (dt_txt iz odgovora API-ja)

Prognoza (+24 h) temperature zraka

Čitanje vlažnosti
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[8].main.humidity") / 100)
Čitanje (modul)
IF(ISNULL(Daily) | Daily = "error", ADDERROR("Failed to read data "));
Čitanje temperature
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[8].main.temp"))
Servisni atributi
Forecast Date
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[8].dt_txt"))
Prognoza (+24 h) osjetne temperature Senzor temperature Samo za čitanje

Osjetna temperatura za termin prognoze +24 h — mjerenje vlažnosti je isključeno (vraća NaN)

numeric Jedinica: °C json_path

Prognoza (+24 h) osjetne temperature

Čitanje vlažnosti
NaN
Čitanje (modul)
IF(ISNULL(responseJson) | responseJson = "error", ADDERROR("Failed to read data "));
Čitanje temperature
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[8].main.feels_like"))
Prognoza (+24 h) vidljivosti Varijabla Samo za čitanje

Poznati problem: čita iz list[0] umjesto iz list[8] — vrijednosti vidljivosti zamijenjene su s Prognozom (+3 h)

numeric Jedinica: m json_path

Prognoza (+24 h) vidljivosti

Čitanje
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[0].visibility"))
Čitanje (modul)
IF(ISNULL(responseJson) | responseJson = "error", ADDERROR("Failed to read data "));
Prognoza (+24 h) brzine vjetra Varijabla Samo za čitanje
numeric Jedinica: m/s json_path

Prognoza (+24 h) brzine vjetra

Čitanje
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[8].wind.speed"))
Prognoza (+24 h) vremena Prekidač s više vrijednosti Samo za čitanje

Vremenski uvjeti za termin prognoze +24 h — isto preslikavanje u 7 kategorija kao Trenutačno vrijeme

string multi_value_switch
Vrijednosti / stanja: Clear · Clouds · Rain · Drizzle · Thunderstorm · Snow · Atmosphere

Prognoza (+24 h) vremena

Čitanje stanja sklopke
IF(ISNULL(Daily) | Daily = "error")
    return(NaN);
END

VAR weather := PARSEJSON(Daily, "$.list[8].weather[0].main");
SWITCH(weather, "Clear", 0, "Clouds", 1, "Rain", 2, "Drizzle", 3, "Thunderstorm", 4, "Snow", 5, "Mist", 6, "Smoke", 6, "Haze", 6, "Dust", 6, "Fog", 6, "Sand", 6, "Ash", 6, "Squall", 6, "Tornado", 6, 0);
Povezivanje: Packet Parser → HTTP
Moguća poboljšanja (7)
  • Current Humidity (standalone) — Humidity is only exposed as secondary value on temperature sensors, not as standalone device
  • Wind Direction — Wind direction in degrees available in API but not implemented in template
  • Wind Gust — Wind gust speed available in API but not implemented in template
  • Cloudiness — Cloudiness percentage available in API but not implemented
  • Rain Volume (1h) — Rain volume for last 1 hour in mm, available in API
  • Snow Volume (1h) — Snow volume for last 1 hour in mm, available in API
  • Sunrise / Sunset — Unix timestamps for sunrise and sunset available in API

Parametri uvoza

Ove vrijednosti unosite pri uvozu XML-a.

Pitanje u aplikacijiZadano
latitude48.1778
longitude17.1426
OpenWeather application idappid

Izvori

Pronašli ste problem s ovim predloškom uređaja?

Recite nam što ne radi, što nedostaje ili kako bi se predložak trebao ponašati. Vaše povratne informacije pomažu nam da katalog bude točan.

Predložak · TapHome portal OpenWeather Otvorite ovaj predložak na portalu Customer Portal kako biste ga primijenili na jedan od svojih domova ili predložili poboljšanje i poslali ga natrag u katalog. Packet Parser → HTTP Pogledaj u TapHome portalu