---
title: "Meteosource Időjárás API"
description: "Meteosource Weather API integráció a TapHome-hoz — aktuális időjárás, napi hőmérséklet-előrejelzés és csapadék HTTPS cloud API-n (ingyenes csomag)."
url: "https://taphome.com/hu/compatibility/meteosource/"
language: hu
lastmod: 2026-03-28
generator: hugo
ai:
  topics: ["http","data-service","cloud-api","weather","packet-parser"]
  questions: ["Hogyan integrálhatod a Meteosource időjárási adatokat a TapHome-mal?","Milyen időjárási adatokat biztosít a Meteosource TapHome sablon?","Hogyan szerezhetsz ingyenes Meteosource API-kulcsot a TapHome-hoz?","Hogyan működik az időjárástípus többértékű kapcsoló a TapHome-ban?","Elegendő a Meteosource ingyenes tarifája a TapHome lekérdezéshez?","Hogyan változtathatod meg az időzónát a Meteosource sablonban?"]
---

# Meteosource Időjárás API

Kommunikáció: Packet Parser → HTTP

- [Meteosource hivatalos weboldal](https://www.meteosource.com)

## Integrációs útmutató

A Meteosource egy globális időjárási adatszolgáltató, amely aktuális körülményeket, előrejelzéseket és történeti adatokat kínál REST API-n keresztül. A TapHome sablon a Meteosource ingyenes tarifájú API-jához csatlakozik HTTPS-en, és beolvassa az aktuális időjárást és a napi előrejelzést egy beállított GPS-helyre.

A sablon 8 csak olvasható eszközt biztosít, amelyek lefedik az időjárástípust, a szélsebességet és -irányt, az aktuális hőmérsékletet, a napi minimális és maximális hőmérsékleteket, valamint a csapadékot (aktuális és napi). A modul 5 percenként kérdezi le az API-t, és a teljes JSON-választ gyorsítótárban tárolja — az egyes szenzorok ezután rövidebb időközönként olvassák a gyorsítótárat. Az ingyenes tarifa napi 400 hívást engedélyez, és a sablon körülbelül napi 288 hívást használ, ami bőven a korláton belül van.

## Beállítás

### API-kulcs beszerzése

1. Regisztrálj egy ingyenes fiókot a [meteosource.com/client/sign-up](https://www.meteosource.com/client/sign-up) oldalon
2. Regisztráció után az API-kulcs elérhető a fiók kezelőfelületén
3. Másold ki a kulcsot — szükség lesz rá a sablon TapHome-ba történő importálásakor

> [!TIP]
> Az ingyenes tarifa napi 400 API-hívást biztosít, percenként 10 kérés korláttal. A TapHome sablon 5 percenként kérdez le (288 hívás/nap), ami kényelmes tartalékot hagy. Az ingyenes tarifa kereskedelmi használat esetén a Meteosource megemlítését és visszahivatkozást igényel.

### Import paraméterek

A sablon TapHome-ba történő importálásakor három paraméter szükséges:

| Paraméter | Leírás | Példa |
|-----------|--------|-------|
| `latitude` | Hely szélességi foka tizedes fokban | `48.1778` |
| `longitude` | Hely hosszúsági foka tizedes fokban | `17.1426` |
| `apiKey` | Meteosource API-kulcs a fiók kezelőfelületéről | `abc123def456...` |

A hely koordinátáinak megkereséséhez kattints jobb gombbal a [Google Maps](https://maps.google.com) oldalon, és válaszd ki a koordinátákat a helyi menüből.

### Modulváltozók

A sablon importálása után egy változó állítható be a modul beállításaiban:

| Változó | Leírás | Alapértelmezett |
|---------|--------|-----------------|
| `tz` | Időzóna tzinfo formátumban | `Europe/Prague` |

Az időzóna határozza meg, hogyan értelmezi a rendszer az API-válaszban lévő időbélyegeket. A CET/CEST időzónán kívüli felhasználóknak ezt az értéket a saját helyüknek megfelelőre kell módosítaniuk (pl. `America/New_York`, `Asia/Tokyo`, `UTC`).

### API-végpont

A modul a `www.meteosource.com` szerverhez csatlakozik HTTPS-en (443-as port) és a következőt hívja:

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

A sablon a `ca` (kanadai) mértékegységrendszert használja: Celsius hőmérséklethez, km/h szélsebességhez, mm csapadékhoz és hPa nyomáshoz.

## Eszközképességek

### Időjárástípus

Az **Időjárástípus** eszköz egy többértékű kapcsoló, amely a Meteosource `icon_num` mezőjét (1–36 értékek) 7 TapHome időjáráskategóriára képezi le:

| Kapcsolóérték | Kategória | Meteosource ikonok (nappal) | Meteosource ikonok (éjszaka) |
|---------------|-----------|-----------------------------|-----------------------------|
| 0 | Derült / Napos | 2, 3, 4, 5 | 26, 27, 28 |
| 1 | Felhős / Borult | 6, 7, 8 | 29, 30, 31 |
| 2 | Eső | 11, 12, 13, 25 | 32, 34, 35, 36 |
| 3 | Szitálás / Enyhe eső | 10 | -- |
| 4 | Zivatar | 14, 15 | 33 |
| 5 | Hó / Fagyás | 16–24 | -- |
| 6 | Köd | 9 | -- |

Ha az ikonszám 1 vagy ismeretlen, a kapcsoló az alapértelmezett 1 (Felhős) értékre áll. Az időjárástípus 30 percenként frissül.

### Hőmérséklet

Három hőmérséklet-eszköz biztosít aktuális és előrejelzési adatokat:

- **Temperature** — aktuális léghőmérséklet 2 m magasságban, Celsiusban. Dedikált hőmérsékletszenzor eszköztípust használ hibajelentéssel, ha az API-válasz nem elérhető
- **Temperature Max** — a mai előrejelzett maximális hőmérséklet Celsiusban, a napi előrejelzési szekcióból (`daily.data[0]`)
- **Temperature Min** — a mai előrejelzett minimális hőmérséklet Celsiusban, a napi előrejelzési szekcióból (`daily.data[0]`)

### Szél

- **Wind Speed** — aktuális szélsebesség 10 m magasságban km/h-ban (a `ca` mértékegységrendszer használatával). Hibát jelent, ha a gyorsítótárazott válasz nem elérhető
- **Wind Direction** — szélirány fokban (0–360, ahol 0/360 = észak, 90 = kelet, 180 = dél, 270 = nyugat). Ez a leggyakrabban lekérdezett eszköz 15 másodperces időközönként, a gyorsítótárazott válaszból olvas

### Csapadék

- **Precipitation (1-hour)** — aktuális csapadékmennyiség mm-ben. Hibát jelent, ha a gyorsítótárazott válasz nem elérhető
- **Precipitation (Daily)** — a mai teljes napi előrejelzett csapadék mm-ben, a napi előrejelzési szekcióból

### További képességek

A Meteosource API emellett biztosít hőérzetet, széllökéseket, felhőborítottságot, légnyomást, páratartalmat, látótávolságot, UV-indexet, harmatpontot, szélhűlést, csapadéktípust és szöveges időjárás-összefoglalót az aktuális körülményekhez. Egy légszennyezettségi végpont PM10, PM2.5, NO2, CO, O3 és AQI értékekkel külön elérhető. Ezek egy jövőbeli sablonfrissítésben adhatók hozzá.

## Hibaelhárítás

### Minden eszköz NaN-t vagy semmilyen adatot nem mutat

1. Ellenőrizd, hogy a TapHome Core rendelkezik internet-hozzáféréssel — a sablon kimenő HTTPS-kapcsolatot igényel a `www.meteosource.com` felé
2. Ellenőrizd, hogy az API-kulcs érvényes és nem lett újragenerálva
3. Győződj meg róla, hogy a szélességi és hosszúsági fok értékek helyes tizedes koordináták
4. Az új API-kulcsok regisztráció után néhány percet igényelhetnek az aktiváláshoz

### Elavult vagy késleltetett értékek

A modul 5 percenként kérdezi le a Meteosource API-t, és a választ egy gyorsítótár-változóban tárolja. Az egyes szenzorok rövidebb időközönként (15 másodperc – 1 perc) olvasnak ebből a gyorsítótárból. Ha az API-hívás sikertelen, minden szenzor az utolsó gyorsítótárazott értékeit adja vissza a következő sikeres lekérdezésig.

> [!WARNING]
> A Meteosource API egy felhőszolgáltatás, amely aktív internetkapcsolatot igényel a TapHome Core-on. Internetkimaradás vagy API-leállás esetén a sablon nem kap frissített időjárási adatokat. Az alapértelmezett időzóna `Europe/Prague` — a más régiókban lévő felhasználóknak módosítaniuk kell a `tz` modulváltozót a helyes helyi időbélyegekhez.

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

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

Meteosource Modul

Egyéni változók

|                               |                                                                                              |
|-------------------------------|----------------------------------------------------------------------------------------------|
| `apiKey` (string)             | Meteosource API kulcs a hitelesítéshez (a meteosource.com dashboardon szerezhető be)         |
| `lat` (string)                | Az időjárás-helyszín földrajzi szélessége tizedes fokban (importáláskor kerül beállításra)   |
| `lon` (string)                | Az időjárás-helyszín földrajzi hosszúsága tizedes fokban (importáláskor kerül beállításra)   |
| `tz` (string) = Europe/Prague | IANA időzóna-azonosító az időbélyegek konvertálásához (pl. Europe/Prague, America/New\_York) |

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

Időjárástípus Többértékű kapcsoló Csak olvasható

Időjárási állapot multi-value switchként — Derült, Felhős, Eső, Szitálás, Zivatar, Hó, Köd

integer → mapped Egység: category JSON parsejson()

Értékek / Állapotok: ${weather\_clear} · ${weather\_clouds} · ${weather\_rain} · ${weather\_drizzle} · ${weather\_thunderstorm} · ${weather\_snow} · ${weather\_fog}

Kapcsoló állapot olvasása

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

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

numeric Egység: km/h JSON parsejson()

Olvasás

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

Olvasás (modul)

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

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

Szélirány fokban — 0/360 = észak, 90 = kelet, 180 = dél, 270 = nyugat

numeric Egység: ° JSON parsejson()

Olvasás

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

Hőmérséklet Hőmérséklet-érzékelő Csak olvasható

numeric Egység: °C JSON parsejson()

Olvasás (modul)

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

Hőmérséklet olvasása

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

Hőmérséklet max Változó Csak olvasható

Mai előrejelzett maximális hőmérséklet a napi előrejelzés szekcióból

numeric Egység: °C JSON parsejson()

Olvasás

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

Hőmérséklet min Változó Csak olvasható

Mai előrejelzett minimális hőmérséklet a napi előrejelzés szekcióból

numeric Egység: °C JSON parsejson()

Olvasás

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

Csapadék (1 óra) Változó Csak olvasható

numeric Egység: mm JSON parsejson()

Olvasás

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

Olvasás (modul)

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

Csapadék (napi) Változó Csak olvasható

Mai teljes napi előrejelzett csapadék a napi előrejelzés szekcióból

numeric Egység: mm JSON parsejson()

Olvasás

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

**Kapcsolat:** Packet Parser → HTTP

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

## Importálási paraméterek

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

| Az alkalmazás kéri  | Alapérték |
|---------------------|-----------|
| latitude            | `48.1778` |
| longitude           | `17.1426` |
| Meteosource API key | `apiKey`  |

## Források

- 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

## 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/)