---
title: "OpenWeather"
description: "OpenWeather API în TapHome — vremea curentă și prognoze pentru 3 și 24 de ore: temperatură, umiditate, presiune, vizibilitate și viteza vântului."
url: "https://taphome.com/ro/compatibility/openweather/"
language: ro
lastmod: 2026-03-28
generator: hugo
ai:
  topics: ["http","data-service","cloud-api","weather","packet-parser"]
  questions: ["Cum integrez OpenWeather cu TapHome?","Ce oferă șablonul TapHome pentru OpenWeather?","Cum obțin o cheie API OpenWeather gratuită pentru TapHome?","Ce date meteo citește TapHome din OpenWeather?","Cum funcționează în TapHome comutatorul cu mai multe valori pentru starea vremii?","Se poate folosi gratuit OpenWeather API cu TapHome?"]
---

# OpenWeather

Comunicație: Packet Parser → HTTP

- [Site-ul oficial OpenWeather](https://openweathermap.org/)

## Ghid de integrare

OpenWeather este un furnizor de date meteo care oferă informații despre vreme la nivel global printr-un API REST. Șablonul TapHome se conectează prin HTTPS la OpenWeather API v2.5 gratuit și citește vremea curentă, o prognoză pentru 3 ore și o prognoză pentru 24 de ore pentru locația configurată.

Șablonul face două apeluri API la fiecare 5 minute — unul pentru vremea curentă și unul pentru prognoza pe 5 zile, la intervale de 3 ore. Oferă 18 dispozitive numai pentru citire, care acoperă temperatura aerului, temperatura resimțită, umiditatea, presiunea atmosferică, vizibilitatea, viteza vântului și starea vremii. Toate temperaturile sunt în grade Celsius (unități metrice) și nu este necesar niciun abonament plătit.

## Configurare

### Obținerea cheii API

1. Înregistrați un cont gratuit pe [openweathermap.org](https://home.openweathermap.org/users/sign_up) — nu este necesar un card de credit
2. După înregistrare, cheia API (APPID) vă este trimisă în e-mailul de confirmare
3. Cheia este disponibilă și pe pagina contului, în fila **API key**
4. Cheile noi se activează automat, de obicei între 10 minute și 2 ore

> [!TIP]
> Nivelul gratuit permite 60 de apeluri pe minut și 1.000.000 de apeluri pe lună. Șablonul TapHome face aproximativ 576 de apeluri pe zi (2 apeluri la fiecare 5 minute), mult sub limitele gratuite.

### Parametri de import

La importul șablonului în TapHome sunt necesari trei parametri:

| Parametru | Descriere | Exemplu |
|-----------|-------------|---------|
| `latitude` | Latitudinea locației în grade zecimale | `48.1778` |
| `longitude` | Longitudinea locației în grade zecimale | `17.1426` |
| `appid` | Cheia API OpenWeather din panoul contului | `a1b2c3d4e5f6...` |

Pentru a afla coordonatele unei locații, faceți clic dreapta în [Google Maps](https://maps.google.com) și selectați coordonatele din meniul contextual.

### Endpointuri API

Modulul se conectează la `api.openweathermap.org` prin HTTPS (portul 443) și apelează două endpointuri la fiecare ciclu de interogare:

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

Prima cerere returnează vremea curentă. A doua returnează o listă de prognoze, în care `list[0]` este următorul interval de 3 ore, iar `list[8]` este intervalul de peste 24 de ore (8 x 3 h = 24 h).

## Funcțiile dispozitivului

Șablonul pune la dispoziție 18 dispozitive numai pentru citire, organizate în trei grupuri: vremea curentă (6 dispozitive), prognoza pentru 3 ore (6 dispozitive) și prognoza pentru 24 de ore (6 dispozitive). Fiecare grup oferă aceleași șase mărimi.

### Temperatură și umiditate

- **Temperatura aerului (acum)** — temperatura curentă în grade Celsius, cu umiditatea ca valoare secundară (API-ul returnează 0–100 %, convertit într-o valoare de la 0 la 1 pentru TapHome)
- **Temperatura resimțită (acum)** — temperatura aparentă, care ține cont de efectul de răcire al vântului și de umiditate. Funcția de umiditate este dezactivată (returnează NaN) — se folosește doar valoarea temperaturii
- **Temperatura aerului (prognoză +3h)** — temperatura și umiditatea pentru următorul interval de prognoză de 3 ore. Include atributul de service **Data prognozei**, care afișează marcajul de timp al datelor
- **Temperatura resimțită (prognoză +3h)** — temperatura aparentă pentru următorul interval de 3 ore
- **Temperatura aerului (prognoză +24h)** — temperatura și umiditatea pentru intervalul de prognoză de +24 h. Include atributul de service **Data prognozei**
- **Temperatura resimțită (prognoză +24h)** — temperatura aparentă pentru intervalul de +24 h

### Presiune atmosferică și vizibilitate

- **Presiunea atmosferică (acum)** — presiunea atmosferică în hPa
- **Vizibilitatea (acum)** — distanța de vizibilitate în metri (maximum 10.000 m)
- **Presiunea atmosferică (prognoză +3h)** — presiunea atmosferică pentru următorul interval de 3 ore
- **Vizibilitatea (prognoză +3h)** — vizibilitatea pentru prognoza de 3 ore
- **Presiunea atmosferică (prognoză +24h)** — presiunea atmosferică pentru intervalul de +24 h
- **Vizibilitatea (prognoză +24h)** — vizibilitatea pentru prognoza de 24 de ore

> [!WARNING]
> În versiunea actuală a șablonului, dispozitivele Vizibilitatea (prognoză +3h) și Vizibilitatea (prognoză +24h) au indicii datelor inversați. Dispozitivul +3h citește din list[8] (poziția pentru 24 h), iar dispozitivul +24h citește din list[0] (poziția pentru 3 h). Valorile sunt inversate până la corectarea într-o actualizare viitoare a șablonului.

### Viteza vântului

- **Viteza vântului (acum)** — viteza vântului în m/s
- **Viteza vântului (prognoză +3h)** — viteza vântului pentru următorul interval de 3 ore
- **Viteza vântului (prognoză +24h)** — viteza vântului pentru intervalul de +24 h

### Starea vremii

Trei dispozitive de tip comutator cu mai multe valori afișează categoria stării vremii:

- **Vremea (acum)** — starea curentă a vremii
- **Vremea (prognoză +3h)** — starea vremii pentru următorul interval de 3 ore
- **Vremea (prognoză +24h)** — starea vremii pentru intervalul de +24 h

Fiecare dispozitiv pentru vreme mapează câmpul API `weather[0].main` pe una dintre cele 7 categorii:

| Valoarea comutatorului | Etichetă | Grupuri meteo API |
|-------------|-------|--------------------|
| 0 | Senin | Clear |
| 1 | Noros | Clouds |
| 2 | Ploaie | Rain |
| 3 | Burniță | Drizzle |
| 4 | Furtună | Thunderstorm |
| 5 | Ninsoare | Snow |
| 6 | Fenomene atmosferice | Mist, Smoke, Haze, Dust, Fog, Sand, Ash, Squall, Tornado |

Dacă API-ul returnează un grup meteo necunoscut, comutatorul trece implicit pe 0 (Senin). Valorile 7, 8 și 9 ale comutatorului sunt definite în configurația șablonului, dar nu au corespondență în logica scriptului — sunt valori rezervate, nefolosite.

### Funcții suplimentare

OpenWeather API oferă și direcția vântului, rafalele de vânt, gradul de acoperire cu nori în procente, cantitatea de ploaie și de zăpadă (1 h) și orele răsăritului și apusului. Umiditatea este disponibilă doar ca valoare secundară a senzorilor de temperatură, nu ca dispozitiv separat. Acestea pot fi adăugate într-o actualizare viitoare a șablonului.

## Rezolvarea problemelor

### Toate dispozitivele arată NaN sau nu au date

1. Verificați dacă TapHome Core are acces la internet — șablonul necesită conectivitate HTTPS de ieșire către `api.openweathermap.org`
2. Verificați dacă cheia API este validă — pentru test, deschideți în browser `https://api.openweathermap.org/data/2.5/weather?lat=48.18&lon=17.14&appid=YOUR_KEY&units=metric`
3. Activarea cheilor API noi poate dura până la 2 ore după înregistrare
4. Verificați dacă latitudinea și longitudinea sunt coordonate zecimale corecte (nu grade/minute/secunde)

### Datele de prognoză par incorecte

API-ul de prognoză returnează date în intervale de 3 ore. Dispozitivele +3h citesc primul interval de prognoză (`list[0]`), adică următorul bloc de 3 ore disponibil — nu exact peste 3 ore de acum. La fel, dispozitivele +24h citesc `list[8]` (al 9-lea interval), care corespunde aproximativ momentului de peste 24 de ore.

Țineți cont de inversarea indicilor de vizibilitate descrisă în avertismentul de mai sus — dacă valorile de vizibilitate +3h și +24h par schimbate între ele, este vorba de eroarea cunoscută a șablonului.

### Greșeală de scriere în numele dispozitivului

Dispozitivul nr. 17 din șablon se numește „Forecast (+24h)Weather” (lipsește spațiul înainte de „Weather”). Este o problemă cosmetică în fișierul XML al șablonului și nu afectează funcționarea. Dispozitivul se afișează corect în tabelul de dispozitive TapHome, cu numele corectat.

## Dispozitive disponibile 18

Aceste dispozitive apar în TapHome după import.

OpenWeather Modul

Variabile personalizate

|                      |                                                                                            |
|----------------------|--------------------------------------------------------------------------------------------|
| `longitude` (string) | Longitudinea geografică a locației stației meteo, în grade zecimale (se setează la import) |
| `latitude` (string)  | Latitudinea geografică a locației stației meteo, în grade zecimale (se setează la import)  |
| `AppId` (string)     | Cheia API OpenWeather (o cheie gratuită se obține pe openweathermap.org/api)               |

Citire (modul)

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

Presiunea atmosferică (acum) Variabilă Doar citire

numeric Unitate: hPa json\_path

Citire

```taphome
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"main.pressure"))
```

Citire (modul)

```taphome
IF(ISNULL(responseJson) | responseJson = "error", ADDERROR("Failed to read data "));
```

Temperatura aerului (acum) Senzor de temperatură Doar citire

Temperatura și umiditatea curente — umiditatea se împarte la 100 (API-ul returnează 0–100 %, TapHome folosește valori de la 0 la 1)

numeric Unitate: °C json\_path

Citirea umidității

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

Citire (modul)

```taphome
IF(ISNULL(responseJson) | responseJson = "error", ADDERROR("Failed to read data "));
```

Citirea temperaturii

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

Temperatura resimțită (acum) Senzor de temperatură Doar citire

Temperatura aparentă, care ține cont de efectul de răcire al vântului și de umiditate — funcția de umiditate este dezactivată (returnează NaN)

numeric Unitate: °C json\_path

Citirea umidității

```taphome
NaN
```

Citire (modul)

```taphome
IF(ISNULL(responseJson) | responseJson = "error", ADDERROR("Failed to read data "));
```

Citirea temperaturii

```taphome
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"main.feels_like"))
```

Vizibilitatea (acum) Variabilă Doar citire

Distanța de vizibilitate în metri (maximum 10.000 m)

numeric Unitate: m json\_path

Citire

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

Citire (modul)

```taphome
IF(ISNULL(responseJson) | responseJson = "error", ADDERROR("Failed to read data "));
```

Vremea (acum) Comutator cu mai multe valori Doar citire

Starea vremii ca comutator cu mai multe valori — Senin, Noros, Ploaie, Burniță, Furtună, Ninsoare, Fenomene atmosferice

string multi\_value\_switch

Valori / Stări: Clear · Clouds · Rain · Drizzle · Thunderstorm · Snow · Atmosphere

Citirea stării comutatorului

```taphome
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);
```

Citire (modul)

```taphome
IF(ISNULL(responseJson) | responseJson = "error", ADDERROR("Failed to read data "));
```

Viteza vântului (acum) Variabilă Doar citire

numeric Unitate: m/s json\_path

Citire

```taphome
IF(ISNULL(responseJson) | responseJson = "error", NaN, PARSEJSON(responseJson,"wind.speed"))
```

Citire (modul)

```taphome
IF(ISNULL(responseJson) | responseJson = "error", ADDERROR("Failed to read data "));
```

Presiunea atmosferică (prognoză +3h) Variabilă Doar citire

numeric Unitate: hPa json\_path

Citire

```taphome
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[0].main.pressure"))
```

Citire (modul)

```taphome
IF(ISNULL(responseJson) | responseJson = "error", ADDERROR("Failed to read data "));
```

Temperatura aerului (prognoză +3h) Senzor de temperatură Doar citire

Temperatura și umiditatea pentru următorul interval de prognoză de 3 ore — include atributul de service Data prognozei

numeric Unitate: °C json\_path

Atribute de service

|                |                                                                     |
|----------------|---------------------------------------------------------------------|
| Data prognozei | Marcajul de timp al datelor de prognoză (dt\_txt din răspunsul API) |

Citirea umidității

```taphome
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[0].main.humidity") / 100)
```

Citire (modul)

```taphome
IF(ISNULL(Daily) | Daily = "error", ADDERROR("Failed to read data "));
```

Citirea temperaturii

```taphome
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[0].main.temp"))
```

Atribute de service

Forecast Date

```taphome
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[0].dt_txt"))
```

Temperatura resimțită (prognoză +3h) Senzor de temperatură Doar citire

Temperatura aparentă pentru următorul interval de prognoză de 3 ore — funcția de umiditate este dezactivată (returnează NaN)

numeric Unitate: °C json\_path

Citirea umidității

```taphome
NaN
```

Citire (modul)

```taphome
IF(ISNULL(responseJson) | responseJson = "error", ADDERROR("Failed to read data "));
```

Citirea temperaturii

```taphome
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[0].main.feels_like"))
```

Vizibilitatea (prognoză +3h) Variabilă Doar citire

Problemă cunoscută: citește din list\[8] în loc de list\[0] — valorile de vizibilitate sunt inversate cu cele ale dispozitivului Vizibilitatea (prognoză +24h)

numeric Unitate: m json\_path

Citire

```taphome
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[8].visibility"))
```

Citire (modul)

```taphome
IF(ISNULL(responseJson) | responseJson = "error", ADDERROR("Failed to read data "));
```

Vremea (prognoză +3h) Comutator cu mai multe valori Doar citire

Starea vremii pentru următorul interval de prognoză de 3 ore — aceeași mapare pe 7 categorii ca la Vremea (acum)

string multi\_value\_switch

Valori / Stări: Clear · Clouds · Rain · Drizzle · Thunderstorm · Snow · Atmosphere

Citirea stării comutatorului

```taphome
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);
```

Citire (modul)

```taphome
IF(ISNULL(Daily) | Daily = "error", ADDERROR("Failed to read data "));
```

Viteza vântului (prognoză +3h) Variabilă Doar citire

numeric Unitate: m/s json\_path

Citire

```taphome
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[0].wind.speed"))
```

Citire (modul)

```taphome
IF(ISNULL(responseJson) | responseJson = "error", ADDERROR("Failed to read data "));
```

Presiunea atmosferică (prognoză +24h) Variabilă Doar citire

numeric Unitate: hPa json\_path

Citire

```taphome
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[8].main.pressure"))
```

Citire (modul)

```taphome
IF(ISNULL(responseJson) | responseJson = "error", ADDERROR("Failed to read data "));
```

Temperatura aerului (prognoză +24h) Senzor de temperatură Doar citire

Temperatura și umiditatea pentru intervalul de prognoză de +24 h — include atributul de service Data prognozei

numeric Unitate: °C json\_path

Atribute de service

|                |                                                                     |
|----------------|---------------------------------------------------------------------|
| Data prognozei | Marcajul de timp al datelor de prognoză (dt\_txt din răspunsul API) |

Citirea umidității

```taphome
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[8].main.humidity") / 100)
```

Citire (modul)

```taphome
IF(ISNULL(Daily) | Daily = "error", ADDERROR("Failed to read data "));
```

Citirea temperaturii

```taphome
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[8].main.temp"))
```

Atribute de service

Forecast Date

```taphome
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[8].dt_txt"))
```

Temperatura resimțită (prognoză +24h) Senzor de temperatură Doar citire

Temperatura aparentă pentru intervalul de prognoză de +24 h — funcția de umiditate este dezactivată (returnează NaN)

numeric Unitate: °C json\_path

Citirea umidității

```taphome
NaN
```

Citire (modul)

```taphome
IF(ISNULL(responseJson) | responseJson = "error", ADDERROR("Failed to read data "));
```

Citirea temperaturii

```taphome
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[8].main.feels_like"))
```

Vizibilitatea (prognoză +24h) Variabilă Doar citire

Problemă cunoscută: citește din list\[0] în loc de list\[8] — valorile de vizibilitate sunt inversate cu cele ale dispozitivului Vizibilitatea (prognoză +3h)

numeric Unitate: m json\_path

Citire

```taphome
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[0].visibility"))
```

Citire (modul)

```taphome
IF(ISNULL(responseJson) | responseJson = "error", ADDERROR("Failed to read data "));
```

Viteza vântului (prognoză +24h) Variabilă Doar citire

numeric Unitate: m/s json\_path

Citire

```taphome
IF(ISNULL(Daily) | Daily = "error", NaN, PARSEJSON(Daily,"$.list[8].wind.speed"))
```

Vremea (prognoză +24h) Comutator cu mai multe valori Doar citire

Starea vremii pentru intervalul de prognoză de +24 h — aceeași mapare pe 7 categorii ca la Vremea (acum)

string multi\_value\_switch

Valori / Stări: Clear · Clouds · Rain · Drizzle · Thunderstorm · Snow · Atmosphere

Citirea stării comutatorului

```taphome
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);
```

**Conexiune:** Packet Parser → HTTP

Îmbunătățiri posibile (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 de import

Introduceți aceste valori când importați XML-ul.

| Solicitat în aplicație     | Implicit  |
|----------------------------|-----------|
| latitude                   | `48.1778` |
| longitude                  | `17.1426` |
| OpenWeather application id | `appid`   |

## Surse

- Current Weather Data API 2.5
  
  [openweathermap.org](https://openweathermap.org/current) 2026-03-28
- 5 Day / 3 Hour Forecast API
  
  [openweathermap.org](https://openweathermap.org/forecast5) 2026-03-28
- Weather Condition Codes
  
  [openweathermap.org](https://openweathermap.org/weather-conditions) 2026-03-28
- API Key Setup Guide
  
  [openweathermap.org](https://openweathermap.org/appid) 2026-03-28

## Documentație asociată

- [Packet Parser Integration](https://taphome.com/ro/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/ro/docs/integration/packet-parser/)
- [Funcții Packet parser](https://taphome.com/ro/docs/script/packet-parser/)
- [Funcții de parsare](https://taphome.com/ro/docs/script/parsing-functions/)

