---
title: "Meteosource Weather API"
description: "Vremea curentă, temperaturile și precipitațiile din prognoza zilnică Meteosource în TapHome, prin API cloud HTTPS. Funcționează cu planul gratuit."
url: "https://taphome.com/ro/compatibility/meteosource/"
language: ro
lastmod: 2026-03-28
generator: hugo
ai:
  topics: ["http","data-service","cloud-api","weather","packet-parser"]
  questions: ["Cum integrez datele meteo Meteosource cu TapHome?","Ce date meteo oferă șablonul TapHome pentru Meteosource?","Cum obțin o cheie API Meteosource gratuită pentru TapHome?","Cum funcționează comutatorul cu mai multe valori pentru tipul vremii în TapHome?","Este suficient planul gratuit Meteosource pentru interogările TapHome?","Cum schimb fusul orar în șablonul Meteosource?"]
---

# Meteosource Weather API

Comunicație: Packet Parser → HTTP

- [Site-ul oficial Meteosource](https://www.meteosource.com)

## Ghid de integrare

Meteosource este un furnizor global de date meteo, care oferă condițiile curente, prognoze și date istorice printr-un REST API. Șablonul TapHome se conectează prin HTTPS la API-ul Meteosource din planul gratuit și citește condițiile meteo curente și prognoza zilnică pentru azi, pentru o locație GPS configurată.

Șablonul oferă 8 dispozitive numai pentru citire, care acoperă tipul vremii, viteza și direcția vântului, temperatura curentă, temperaturile zilnice minimă/maximă și precipitațiile (curente și zilnice). Modulul interoghează API-ul la fiecare 5 minute și păstrează în cache întregul răspuns JSON — senzorii individuali citesc apoi din cache la intervale mai scurte. Planul gratuit permite 400 de apeluri pe zi, iar șablonul folosește aproximativ 288 de apeluri pe zi, cu mult sub limită.

## Configurare

### Obținerea cheii API

1. Înregistrați un cont gratuit pe [meteosource.com/client/sign-up](https://www.meteosource.com/client/sign-up)
2. După înregistrare, cheia API este disponibilă în dashboard-ul contului
3. Copiați cheia — veți avea nevoie de ea la importul șablonului în TapHome

> [!TIP]
> Planul gratuit oferă 400 de apeluri API pe zi, cu o limită de 10 cereri pe minut. Șablonul TapHome interoghează la fiecare 5 minute (288 de apeluri/zi), ceea ce lasă o rezervă confortabilă. Pentru utilizarea comercială, planul gratuit cere menționarea Meteosource și un backlink către acesta.

### Parametrii 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` |
| `apiKey` | Cheia API Meteosource din dashboard-ul contului | `abc123def456...` |

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.

### Variabilele modulului

După importul șablonului, în setările modulului se poate ajusta o variabilă:

| Variabilă | Descriere | Implicit |
|----------|-------------|---------|
| `tz` | Fusul orar în format tzinfo | `Europe/Prague` |

Fusul orar determină cum sunt interpretate marcajele de timp din răspunsul API. Utilizatorii din afara fusului orar CET/CEST trebuie să schimbe această valoare în funcție de locația lor (de ex. `America/New_York`, `Asia/Tokyo`, `UTC`).

### Endpoint-ul API

Modulul se conectează la `www.meteosource.com` prin HTTPS (portul 443) și apelează:

```
GET /api/v1/free/point?lat={lat}&lon={lon}&sections=current,daily&timezone={tz}&language=en&units=ca&key={apiKey}
```

Șablonul folosește sistemul de unități `ca` (canadian): grade Celsius pentru temperatură, km/h pentru viteza vântului, mm pentru precipitații și hPa pentru presiune.

## Funcțiile dispozitivului

### Tipul vremii

Dispozitivul **Tipul vremii** este un comutator cu mai multe valori, care mapează câmpul Meteosource `icon_num` (valorile 1--36) pe 7 categorii meteo TapHome:

| Valoare comutator | Categorie | Pictograme Meteosource (zi) | Pictograme Meteosource (noapte) |
|-------------|----------|-------------------------|---------------------------|
| 0 | Senin / Însorit | 2, 3, 4, 5 | 26, 27, 28 |
| 1 | Noros / Înnorat | 6, 7, 8 | 29, 30, 31 |
| 2 | Ploaie | 11, 12, 13, 25 | 32, 34, 35, 36 |
| 3 | Burniță / Ploaie slabă | 10 | -- |
| 4 | Furtună | 14, 15 | 33 |
| 5 | Ninsoare / Îngheț | 16--24 | -- |
| 6 | Ceață | 9 | -- |

Dacă numărul pictogramei este 1 sau nu este recunoscut, comutatorul trece implicit pe 1 (Noros). Tipul vremii este interogat la fiecare 30 de minute.

### Temperatură

Trei dispozitive de temperatură oferă date curente și din prognoză:

- **Temperatură** -- temperatura curentă a aerului la 2 m înălțime, în grade Celsius. Folosește tipul de dispozitiv dedicat senzorilor de temperatură și raportează o eroare dacă răspunsul API nu este disponibil
- **Temperatură max.** -- temperatura maximă prognozată pentru azi, în grade Celsius, citită din secțiunea de prognoză zilnică (`daily.data[0]`)
- **Temperatură min.** -- temperatura minimă prognozată pentru azi, în grade Celsius, citită din secțiunea de prognoză zilnică (`daily.data[0]`)

### Vânt

- **Viteza vântului** -- viteza curentă a vântului la 10 m înălțime, în km/h (cu sistemul de unități `ca`). Raportează o eroare dacă răspunsul din cache nu este disponibil
- **Direcția vântului** -- direcția vântului în grade (0--360, unde 0/360 = nord, 90 = est, 180 = sud, 270 = vest). Este dispozitivul interogat cel mai des, la intervale de 15 secunde, și citește din răspunsul din cache

### Precipitații

- **Precipitații (1 oră)** -- cantitatea curentă de precipitații în mm. Raportează o eroare dacă răspunsul din cache nu este disponibil
- **Precipitații (zilnic)** -- totalul precipitațiilor prognozate pentru azi, în mm, citit din secțiunea de prognoză zilnică

### Funcții suplimentare

API-ul Meteosource pune la dispoziție și temperatura resimțită, rafalele de vânt, nebulozitatea, presiunea atmosferică, umiditatea, vizibilitatea, indicele UV, punctul de rouă, temperatura resimțită din cauza vântului, tipul precipitațiilor și un rezumat text al vremii pentru condițiile curente. Separat este disponibil un endpoint pentru calitatea aerului, cu PM10, PM2.5, NO2, CO, O3 și AQI. Acestea pot fi adăugate într-o actualizare viitoare a șablonului.

## Rezolvarea problemelor

### Toate dispozitivele afișează NaN sau nu au date

1. Verificați dacă TapHome Core are acces la internet -- șablonul necesită conectivitate HTTPS de ieșire către `www.meteosource.com`
2. Verificați dacă cheia API este validă și nu a fost regenerată
3. Verificați dacă valorile latitudinii și longitudinii sunt coordonate zecimale corecte
4. Cheile API noi pot avea nevoie de câteva minute pentru activare după înregistrare

### Citiri vechi sau întârziate

Modulul interoghează API-ul Meteosource la fiecare 5 minute și stochează răspunsul într-o variabilă cache. Senzorii individuali citesc din acest cache la intervale mai scurte (de la 15 secunde la 1 minut). Dacă apelul API eșuează, toți senzorii continuă să returneze ultimele valori din cache până la următoarea interogare reușită.

> [!WARNING]
> API-ul Meteosource este un serviciu cloud care necesită o conexiune activă la internet pe TapHome Core. În timpul întreruperilor de internet sau al indisponibilității API, șablonul nu primește date meteo actualizate. Fusul orar implicit este `Europe/Prague` -- utilizatorii din alte regiuni trebuie să schimbe variabila de modul `tz` pentru marcaje de timp locale corecte.

## Dispozitive disponibile 8

Aceste dispozitive apar în TapHome după import.

Meteosource Modul

Variabile personalizate

|                               |                                                                                                                    |
|-------------------------------|--------------------------------------------------------------------------------------------------------------------|
| `apiKey` (string)             | Cheia API Meteosource pentru autentificare (se obține din dashboard-ul meteosource.com)                            |
| `lat` (string)                | Latitudinea geografică a locației meteo, în grade zecimale (se setează la import)                                  |
| `lon` (string)                | Longitudinea geografică a locației meteo, în grade zecimale (se setează la import)                                 |
| `tz` (string) = Europe/Prague | Identificatorul IANA al fusului orar pentru conversia marcajelor de timp (de ex. Europe/Prague, America/New\_York) |

Citire (modul)

```taphome
VAR request := HTTPREQUEST(
	"/api/v1/free/point?lat=" + lat + "&lon=" + lon + "&sections=current,daily&timezone=" + tz + "&language=en&units=ca&key=" + apiKey,
	"GET" 
);
VAR response := SENDHTTPREQUEST(request);
VAR responseHeaders := response.Headers;
IF response.IsSuccess  
  responseJson := response.Content;
END
```

Tipul vremii Comutator cu mai multe valori Doar citire

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

integer → mapped Unitate: category JSON parsejson()

Valori / Stări: ${weather\_clear} · ${weather\_clouds} · ${weather\_rain} · ${weather\_drizzle} · ${weather\_thunderstorm} · ${weather\_snow} · ${weather\_fog}

Citirea stării comutatorului

```taphome
IF(ISNULL(responseJson) | responseJson = "error")
    return(NaN);
END 

VAR weather := PARSEJSON(responseJson, "current.icon_num");
SWITCH(weather, 
2, 0, 3, 0, 4, 0,26,0, 27,0,28,0,
5, 0, 6, 1, 7, 1, 8,1,29,1,30,1,31,1, 
	11,2,12,2,13,2,25,2,32,2,34,2,35,2,36,2,
10,3,
	16,5,17,5,18,5,19,5,20,5,21,5,22,5,23,5,24,5,
14,4,15,4,33,4,
9,6, 
1);
```

Viteza vântului Variabilă Doar citire

numeric Unitate: km/h JSON parsejson()

Citire

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

Citire (modul)

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

Direcția vântului Variabilă Doar citire

Direcția vântului în grade — 0/360 = nord, 90 = est, 180 = sud, 270 = vest

numeric Unitate: ° JSON parsejson()

Citire

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

Temperatură Senzor de temperatură Doar citire

numeric Unitate: °C JSON parsejson()

Citire (modul)

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

Citirea temperaturii

```taphome
IF(ISNULL(responseJson) | responseJson = "error", NaN, TODOUBLE(PARSEJSON(responseJson,"current.temperature")))
```

Temperatură max. Variabilă Doar citire

Temperatura maximă prognozată pentru azi, din secțiunea de prognoză zilnică

numeric Unitate: °C JSON parsejson()

Citire

```taphome
IF(ISNULL(responseJson) | responseJson = "error", NaN, TODOUBLE(PARSEJSON(responseJson,"daily.data[0].all_day.temperature_max")))
```

Temperatură min. Variabilă Doar citire

Temperatura minimă prognozată pentru azi, din secțiunea de prognoză zilnică

numeric Unitate: °C JSON parsejson()

Citire

```taphome
IF(ISNULL(responseJson) | responseJson = "error", NaN, TODOUBLE(PARSEJSON(responseJson,"daily.data[0].all_day.temperature_min")))
```

Precipitații (1 oră) Variabilă Doar citire

numeric Unitate: mm JSON parsejson()

Citire

```taphome
IF(ISNULL(responseJson) | responseJson = "error", NaN, TODOUBLE(PARSEJSON(responseJson,"current.precipitation.total")))
```

Citire (modul)

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

Precipitații (zilnic) Variabilă Doar citire

Totalul precipitațiilor prognozate pentru azi, din secțiunea de prognoză zilnică

numeric Unitate: mm JSON parsejson()

Citire

```taphome
IF(ISNULL(responseJson) | responseJson = "error", NaN, TODOUBLE(PARSEJSON(responseJson,"daily.data[0].all_day.precipitation.total")))
```

**Conexiune:** Packet Parser → HTTP

Îmbunătățiri posibile (12)

- Feels Like Temperature — Perceived temperature accounting for wind chill and humidity. Float, Celsius with ca units
- Wind Gusts — Peak wind gust speed at 10m. Float, km/h with ca units
- Cloud Cover — Total cloud cover percentage. Integer, 0–100%
- Atmospheric Pressure — Sea level atmospheric pressure. Float, hPa with ca units
- Relative Humidity — Relative humidity. Integer, 0–100%
- Visibility — Visibility distance. Float, km with ca units
- UV Index — UV radiation index. Float, 0–11+ scale
- Dew Point — Dew point temperature. Float, Celsius with ca units
- Wind Chill — Wind chill temperature. Float, Celsius with ca units
- Precipitation Type — Type of precipitation — none, rain, snow, rain\_snow, ice\_pellets, frozen\_rain. String value
- Weather Summary — Human-readable text description of current weather. Translated per language parameter
- Air Quality Index — Requires separate /air\_quality endpoint. Includes PM10, PM2.5, NO2, CO, O3, AQI (1–6 scale). Not available via Point endpoint

## Parametri de import

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

| Solicitat în aplicație | Implicit  |
|------------------------|-----------|
| latitude               | `48.1778` |
| longitude              | `17.1426` |
| Meteosource API key    | `apiKey`  |

## Surse

- Meteosource — Main Website & Pricing
  
  [www.meteosource.com](https://www.meteosource.com/pricing) 2026-03-28
- Meteosource — API Documentation
  
  [www.meteosource.com](https://www.meteosource.com/documentation) 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/)

