---
title: "Meteosource API počasí"
description: "Integrace Meteosource Weather API s TapHome — aktuální počasí, denní předpovědi teplot a srážek přes HTTPS cloud API s podporou bezplatného tarifu."
url: "https://taphome.com/cs/compatibility/meteosource/"
language: cs
lastmod: 2026-03-28
generator: hugo
ai:
  topics: ["http","data-service","cloud-api","weather","packet-parser"]
  questions: ["Jak integrovat data o počasí z Meteosource s TapHome?","Jaká data o počasí poskytuje šablona Meteosource pro TapHome?","Jak získat bezplatný API klíč Meteosource pro TapHome?","Jak funguje přepínač typu počasí s více hodnotami v TapHome?","Je bezplatný tarif Meteosource dostatečný pro dotazování TapHome?","Jak změnit časovou zónu v šabloně Meteosource?"]
---

# Meteosource API počasí

Komunikace: Packet Parser → HTTP

- [Oficiální stránka Meteosource](https://www.meteosource.com)

## Návod na integraci

Meteosource je globální poskytovatel dat o počasí, který nabízí aktuální podmínky, předpovědi a historická data prostřednictvím REST API. Šablona TapHome se připojuje k bezplatnému tarifu Meteosource API přes HTTPS a načítá aktuální počasí a denní předpověď pro nakonfigurovanou GPS polohu.

Šablona poskytuje 8 zařízení pouze pro čtení, která pokrývají typ počasí, rychlost a směr větru, aktuální teplotu, denní minimální a maximální teploty a srážky (aktuální i denní). Modul dotazuje API každých 5 minut a ukládá celou JSON odpověď do vyrovnávací paměti — jednotlivé senzory pak čtou z vyrovnávací paměti v kratších intervalech. Bezplatný tarif povoluje 400 volání za den a šablona využívá přibližně 288 volání za den, což je bezpečně v rámci limitu.

## Konfigurace

### Získání API klíče

1. Zaregistrujte si bezplatný účet na [meteosource.com/client/sign-up](https://www.meteosource.com/client/sign-up)
2. Po registraci je API klíč dostupný v dashboardu účtu
3. Zkopírujte klíč — budete ho potřebovat při importu šablony v TapHome

> [!TIP]
> Bezplatný tarif poskytuje 400 API volání za den s limitem 10 požadavků za minutu. Šablona TapHome dotazuje každých 5 minut (288 volání/den), což ponechává dostatečnou rezervu. Bezplatný tarif vyžaduje uvedení a zpětný odkaz na Meteosource při komerčním použití.

### Parametry importu

Při importu šablony v TapHome jsou vyžadovány tři parametry:

| Parametr | Popis | Příklad |
|----------|-------|---------|
| `latitude` | Zeměpisná šířka lokality v desítkových stupních | `48.1778` |
| `longitude` | Zeměpisná délka lokality v desítkových stupních | `17.1426` |
| `apiKey` | API klíč Meteosource z dashboardu účtu | `abc123def456...` |

Pro nalezení souřadnic lokality klikněte pravým tlačítkem na [Google Maps](https://maps.google.com) a vyberte souřadnice z kontextového menu.

### Proměnné modulu

Po importu šablony lze upravit jednu proměnnou v nastavení modulu:

| Proměnná | Popis | Výchozí hodnota |
|----------|-------|-----------------|
| `tz` | Časová zóna ve formátu tzinfo | `Europe/Prague` |

Časová zóna určuje, jak se interpretují časová razítka v odpovědi API. Uživatelé mimo časovou zónu CET/CEST by měli tuto hodnotu změnit tak, aby odpovídala jejich lokalitě (např. `America/New_York`, `Asia/Tokyo`, `UTC`).

### API endpoint

Modul se připojuje na `www.meteosource.com` přes HTTPS (port 443) a volá:

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

Šablona používá jednotkový systém `ca` (kanadský): Celsius pro teplotu, km/h pro rychlost větru, mm pro srážky a hPa pro tlak.

## Schopnosti zařízení

### Typ počasí

Zařízení **Typ počasí** je přepínač s více hodnotami, který mapuje pole Meteosource `icon_num` (hodnoty 1–36) na 7 kategorií počasí TapHome:

| Hodnota přepínače | Kategorie | Ikony Meteosource (den) | Ikony Meteosource (noc) |
|-------------------|-----------|-------------------------|-------------------------|
| 0 | Jasno / Slunečno | 2, 3, 4, 5 | 26, 27, 28 |
| 1 | Oblačno / Zataženo | 6, 7, 8 | 29, 30, 31 |
| 2 | Déšť | 11, 12, 13, 25 | 32, 34, 35, 36 |
| 3 | Mrholení / Slabý déšť | 10 | -- |
| 4 | Bouřka | 14, 15 | 33 |
| 5 | Sníh / Námraza | 16–24 | -- |
| 6 | Mlha | 9 | -- |

Pokud je číslo ikony 1 nebo nerozpoznané, přepínač se nastaví na výchozí hodnotu 1 (Oblačno). Typ počasí se dotazuje každých 30 minut.

### Teplota

Tři teplotní zařízení poskytují aktuální data a data z předpovědi:

- **Temperature** — aktuální teplota vzduchu ve výšce 2 m ve stupních Celsia. Používá dedikovaný typ zařízení teplotního senzoru s hlášením chyb, pokud je odpověď API nedostupná
- **Temperature Max** — dnešní předpovězená maximální teplota ve stupních Celsia, načtená ze sekce denní předpovědi (`daily.data[0]`)
- **Temperature Min** — dnešní předpovězená minimální teplota ve stupních Celsia, načtená ze sekce denní předpovědi (`daily.data[0]`)

### Vítr

- **Wind Speed** — aktuální rychlost větru ve výšce 10 m v km/h (pomocí jednotkového systému `ca`). Hlásí chybu, pokud je uložená odpověď nedostupná
- **Wind Direction** — směr větru ve stupních (0–360, kde 0/360 = sever, 90 = východ, 180 = jih, 270 = západ). Toto je nejrychleji dotazované zařízení s intervalem 15 sekund, čtoucí z uložené odpovědi

### Srážky

- **Precipitation (1-hour)** — aktuální množství srážek v mm. Hlásí chybu, pokud je uložená odpověď nedostupná
- **Precipitation (Daily)** — dnešní celkové denní předpovězené srážky v mm, načtené ze sekce denní předpovědi

### Další schopnosti

Meteosource API také poskytuje pocitovou teplotu, nárazy větru, oblačnost, atmosférický tlak, vlhkost, viditelnost, UV index, rosný bod, pocit chladu, typ srážek a textový souhrn počasí pro aktuální podmínky. Endpoint kvality ovzduší s PM10, PM2.5, NO2, CO, O3 a AQI je dostupný samostatně. Tato data lze přidat v budoucí aktualizaci šablony.

## Řešení problémů

### Všechna zařízení zobrazují NaN nebo žádná data

1. Ověřte, že TapHome Core má přístup k internetu — šablona vyžaduje odchozí HTTPS připojení na `www.meteosource.com`
2. Zkontrolujte, zda je API klíč platný a nebyl přegenerován
3. Potvrďte, že hodnoty zeměpisné šířky a délky jsou správné desítkové souřadnice
4. Nové API klíče mohou vyžadovat několik minut na aktivaci po registraci

### Zastaralá nebo opožděná data

Modul dotazuje Meteosource API každých 5 minut a ukládá odpověď do proměnné vyrovnávací paměti. Jednotlivé senzory čtou z této vyrovnávací paměti v kratších intervalech (15 sekund až 1 minuta). Pokud volání API selže, všechny senzory pokračují ve vracení posledních uložených hodnot až do dalšího úspěšného dotazu.

> [!WARNING]
> Meteosource API je cloudová služba, která vyžaduje aktivní internetové připojení na TapHome Core. Během výpadků internetu nebo nedostupnosti API šablona nebude přijímat aktualizovaná data o počasí. Výchozí časová zóna je `Europe/Prague` — uživatelé v jiných regionech musí změnit proměnnou modulu `tz` pro správná lokální časová razítka.

## Dostupná zařízení 8

Tato zařízení se po importu zobrazí v TapHome.

Meteosource Modul

Vlastní proměnné

|                               |                                                                                                     |
|-------------------------------|-----------------------------------------------------------------------------------------------------|
| `apiKey` (string)             | Meteosource API klíč pro autentizaci (získejte z meteosource.com dashboardu)                        |
| `lat` (string)                | Zeměpisná šířka místa počasí v desetinných stupních (nastavena při importu)                         |
| `lon` (string)                | Zeměpisná délka místa počasí v desetinných stupních (nastavena při importu)                         |
| `tz` (string) = Europe/Prague | IANA identifikátor časové zóny pro převod časových razítek (např. Europe/Prague, America/New\_York) |

Čtení (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
```

Typ počasí Vícestavový přepínač Pouze ke čtení

Stav počasí jako multi-value switch — Jasno, Oblačno, Déšť, Mrholení, Bouřka, Sníh, Mlha

integer → mapped Jednotka: category JSON parsejson()

Hodnoty / Stavy: ${weather\_clear} · ${weather\_clouds} · ${weather\_rain} · ${weather\_drizzle} · ${weather\_thunderstorm} · ${weather\_snow} · ${weather\_fog}

Čtení stavu přepínače

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

Rychlost větru Proměnná Pouze ke čtení

numeric Jednotka: km/h JSON parsejson()

Čtení

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

Čtení (modul)

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

Směr větru Proměnná Pouze ke čtení

Směr větru ve stupních — 0/360 = sever, 90 = východ, 180 = jih, 270 = západ

numeric Jednotka: ° JSON parsejson()

Čtení

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

Teplota Teplotní senzor Pouze ke čtení

numeric Jednotka: °C JSON parsejson()

Čtení (modul)

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

Čtení teploty

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

Teplota max Proměnná Pouze ke čtení

Dnešní předpovědní maximální teplota ze sekce denní předpovědi

numeric Jednotka: °C JSON parsejson()

Čtení

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

Teplota min Proměnná Pouze ke čtení

Dnešní předpovědní minimální teplota ze sekce denní předpovědi

numeric Jednotka: °C JSON parsejson()

Čtení

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

Srážky (1 hodina) Proměnná Pouze ke čtení

numeric Jednotka: mm JSON parsejson()

Čtení

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

Čtení (modul)

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

Srážky (denní) Proměnná Pouze ke čtení

Dnešní celkové denní předpovědní srážky ze sekce denní předpovědi

numeric Jednotka: mm JSON parsejson()

Čtení

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

**Připojení:** Packet Parser → HTTP

Možná vylepšení (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

## Parametry importu

Tyto hodnoty zadáte při importu XML.

| Ptá se v aplikaci   | Výchozí   |
|---------------------|-----------|
| latitude            | `48.1778` |
| longitude           | `17.1426` |
| Meteosource API key | `apiKey`  |

## Zdroje

- 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

## Související dokumentace

- [Integrace Packet Parser](https://taphome.com/cs/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/cs/docs/integration/packet-parser/)
- [Funkce Packet parser](https://taphome.com/cs/docs/script/packet-parser/)
- [Funkce pro parsování](https://taphome.com/cs/docs/script/parsing-functions/)