---
title: "Meteosource Weather API"
description: "Integracija Meteosource Weather API za TapHome — trenutačno vrijeme, dnevna prognoza temperatura i oborina preko HTTPS API-ja u oblaku, i besplatno."
url: "https://taphome.com/hr/compatibility/meteosource/"
language: hr
lastmod: 2026-03-28
generator: hugo
ai:
  topics: ["http","data-service","cloud-api","weather","packet-parser"]
  questions: ["Kako integrirati vremenske podatke Meteosource sa sustavom TapHome?","Koje vremenske podatke daje predložak TapHome za Meteosource?","Kako dobiti besplatni API ključ Meteosource za TapHome?","Kako u sustavu TapHome radi prekidač s više vrijednosti za vrstu vremena?","Je li besplatni paket Meteosource dovoljan za očitavanje u sustavu TapHome?","Kako promijeniti vremensku zonu u predlošku Meteosource?"]
---

# Meteosource Weather API

Komunikacija: Packet Parser → HTTP

- [Službena stranica Meteosource](https://www.meteosource.com)

## Upute za integraciju

Meteosource je globalni pružatelj vremenskih podataka koji preko REST API-ja nudi trenutačne uvjete, prognoze i povijesne podatke. Predložak TapHome spaja se preko HTTPS-a na API besplatnog paketa Meteosource i očitava trenutačne vremenske uvjete i današnju dnevnu prognozu za postavljenu GPS lokaciju.

Predložak daje 8 uređaja samo za čitanje: vrstu vremena, brzinu i smjer vjetra, trenutačnu temperaturu, dnevnu najnižu i najvišu temperaturu te oborine (trenutačne i dnevne). Modul šalje upit API-ju svakih 5 minuta i sprema cijeli JSON odgovor u predmemoriju — pojedini senzori zatim čitaju iz predmemorije u kraćim intervalima. Besplatni paket dopušta 400 poziva dnevno, a predložak koristi približno 288 poziva dnevno, što je unutar ograničenja.

## Konfiguracija

### Dobivanje API ključa

1. Registrirajte besplatni korisnički račun na [meteosource.com/client/sign-up](https://www.meteosource.com/client/sign-up)
2. Nakon registracije API ključ je dostupan u korisničkom računu (dashboard)
3. Kopirajte ključ — trebat će vam pri uvozu predloška u TapHome

> [!TIP]
> Besplatni paket nudi 400 API poziva dnevno uz ograničenje od 10 zahtjeva u minuti. Predložak TapHome šalje upit svakih 5 minuta (288 poziva dnevno), što ostavlja dovoljnu rezervu. Za komercijalnu upotrebu besplatni paket zahtijeva navođenje usluge Meteosource i povratnu poveznicu na nju.

### Parametri uvoza

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

| Parametar | Opis | Primjer |
|-----------|-------------|---------|
| `latitude` | Zemljopisna širina lokacije u decimalnim stupnjevima | `48.1778` |
| `longitude` | Zemljopisna dužina lokacije u decimalnim stupnjevima | `17.1426` |
| `apiKey` | API ključ Meteosource iz korisničkog računa | `abc123def456...` |

Koordinate lokacije pronaći ćete tako da u [Google Maps](https://maps.google.com) desnom tipkom miša kliknete na mjesto i u kontekstnom izborniku odaberete koordinate.

### Varijable modula

Nakon uvoza predloška u postavkama modula može se prilagoditi jedna varijabla:

| Varijabla | Opis | Zadano |
|----------|-------------|---------|
| `tz` | Vremenska zona u formatu tzinfo | `Europe/Prague` |

Vremenska zona određuje kako se tumače vremenske oznake u odgovoru API-ja. Korisnici izvan vremenske zone CET/CEST trebaju ovu vrijednost promijeniti prema svojoj lokaciji (npr. `America/New_York`, `Asia/Tokyo`, `UTC`).

### Krajnja točka API-ja

Modul se spaja na `www.meteosource.com` preko HTTPS-a (port 443) i poziva:

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

Predložak koristi sustav jedinica `ca` (kanadski): Celzijevi stupnjevi za temperaturu, km/h za brzinu vjetra, mm za oborine i hPa za tlak.

## Mogućnosti uređaja

### Vrsta vremena

Uređaj **Vrsta vremena** je prekidač s više vrijednosti koji polje Meteosource `icon_num` (vrijednosti 1–36) preslikava u 7 kategorija vremena u sustavu TapHome:

| Vrijednost prekidača | Kategorija | Ikone Meteosource (dan) | Ikone Meteosource (noć) |
|-------------|----------|-------------------------|---------------------------|
| 0 | Vedro / Sunčano | 2, 3, 4, 5 | 26, 27, 28 |
| 1 | Oblačno / Potpuno oblačno | 6, 7, 8 | 29, 30, 31 |
| 2 | Kiša | 11, 12, 13, 25 | 32, 34, 35, 36 |
| 3 | Rosulja / Slaba kiša | 10 | — |
| 4 | Grmljavina | 14, 15 | 33 |
| 5 | Snijeg / Mraz | 16–24 | — |
| 6 | Magla | 9 | — |

Ako je broj ikone 1 ili nepoznat, prekidač se postavlja na 1 (Oblačno). Vrsta vremena očitava se svakih 30 minuta.

### Temperatura

Tri uređaja za temperaturu daju trenutačne i prognozirane podatke:

- **Temperatura** — trenutačna temperatura zraka na visini od 2 m u Celzijevim stupnjevima. Koristi namjensku vrstu uređaja „Senzor temperature” i javlja grešku ako odgovor API-ja nije dostupan
- **Najviša temperatura** — današnja prognozirana najviša temperatura u Celzijevim stupnjevima, očitana iz odjeljka dnevne prognoze (`daily.data[0]`)
- **Najniža temperatura** — današnja prognozirana najniža temperatura u Celzijevim stupnjevima, očitana iz odjeljka dnevne prognoze (`daily.data[0]`)

### Vjetar

- **Brzina vjetra** — trenutačna brzina vjetra na visini od 10 m u km/h (sustav jedinica `ca`). Javlja grešku ako odgovor u predmemoriji nije dostupan
- **Smjer vjetra** — smjer vjetra u stupnjevima (0–360, gdje je 0/360 = sjever, 90 = istok, 180 = jug, 270 = zapad). Ovaj se uređaj očitava najčešće, svakih 15 sekundi, iz odgovora u predmemoriji

### Oborine

- **Oborine (1 sat)** — trenutačna količina oborina u mm. Javlja grešku ako odgovor u predmemoriji nije dostupan
- **Oborine (dnevno)** — ukupna količina oborina prognozirana za danas u mm, očitana iz odjeljka dnevne prognoze

### Dodatne mogućnosti

API Meteosource daje i osjetnu temperaturu, udare vjetra, naoblaku, atmosferski tlak, vlažnost, vidljivost, UV indeks, temperaturu rosišta, faktor hlađenja vjetrom, vrstu oborina i tekstualni opis trenutačnog vremena. Zasebno je dostupna krajnja točka za kvalitetu zraka s vrijednostima PM10, PM2.5, NO2, CO, O3 i AQI. Mogu se dodati u 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 `www.meteosource.com`
2. Provjerite je li API ključ valjan i nije li ponovno generiran
3. Provjerite jesu li zemljopisna širina i dužina ispravne decimalne koordinate
4. Aktivacija novih API ključeva može potrajati nekoliko minuta nakon registracije

### Zastarjela ili zakašnjela očitanja

Modul šalje upit API-ju Meteosource svakih 5 minuta i odgovor sprema u varijablu predmemorije. Pojedini senzori čitaju iz te predmemorije u kraćim intervalima (od 15 sekundi do 1 minute). Ako poziv API-ja ne uspije, svi senzori i dalje vraćaju posljednje vrijednosti iz predmemorije do sljedećeg uspješnog upita.

> [!WARNING]
> API Meteosource je usluga u oblaku za koju TapHome Core treba aktivnu internetsku vezu. Tijekom prekida internetske veze ili nedostupnosti API-ja predložak neće primati nove vremenske podatke. Zadana vremenska zona je `Europe/Prague` — korisnici u drugim regijama moraju promijeniti varijablu modula `tz` kako bi lokalne vremenske oznake bile točne.

## Dostupni uređaji 8

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

Meteosource Modul

Prilagođene varijable

|                               |                                                                                                    |
|-------------------------------|----------------------------------------------------------------------------------------------------|
| `apiKey` (string)             | API ključ Meteosource za autentifikaciju (dobiva se u korisničkom računu na meteosource.com)       |
| `lat` (string)                | Zemljopisna širina lokacije za vremenske podatke u decimalnim stupnjevima (postavlja se pri uvozu) |
| `lon` (string)                | Zemljopisna dužina lokacije za vremenske podatke u decimalnim stupnjevima (postavlja se pri uvozu) |
| `tz` (string) = Europe/Prague | IANA oznaka vremenske zone za pretvorbu vremenskih oznaka (npr. Europe/Prague, America/New\_York)  |

Čitanje (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
```

Vrsta vremena Prekidač s više vrijednosti Samo za čitanje

Vremenski uvjeti kao prekidač s više vrijednosti — vedro, oblačno, kiša, rosulja, grmljavina, snijeg, magla

integer → mapped Jedinica: category JSON parsejson()

Vrijednosti / stanja: ${weather\_clear} · ${weather\_clouds} · ${weather\_rain} · ${weather\_drizzle} · ${weather\_thunderstorm} · ${weather\_snow} · ${weather\_fog}

Čitanje stanja sklopke

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

Brzina vjetra Varijabla Samo za čitanje

numeric Jedinica: km/h JSON parsejson()

Čitanje

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

Čitanje (modul)

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

Smjer vjetra Varijabla Samo za čitanje

Smjer vjetra u stupnjevima — 0/360 = sjever, 90 = istok, 180 = jug, 270 = zapad

numeric Jedinica: ° JSON parsejson()

Čitanje

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

Temperatura Senzor temperature Samo za čitanje

numeric Jedinica: °C JSON parsejson()

Čitanje (modul)

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

Čitanje temperature

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

Najviša temperatura Varijabla Samo za čitanje

Današnja prognozirana najviša temperatura iz odjeljka dnevne prognoze

numeric Jedinica: °C JSON parsejson()

Čitanje

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

Najniža temperatura Varijabla Samo za čitanje

Današnja prognozirana najniža temperatura iz odjeljka dnevne prognoze

numeric Jedinica: °C JSON parsejson()

Čitanje

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

Oborine (1 sat) Varijabla Samo za čitanje

numeric Jedinica: mm JSON parsejson()

Čitanje

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

Čitanje (modul)

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

Oborine (dnevno) Varijabla Samo za čitanje

Ukupna količina oborina prognozirana za danas iz odjeljka dnevne prognoze

numeric Jedinica: mm JSON parsejson()

Čitanje

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

**Povezivanje:** Packet Parser → HTTP

Moguća poboljšanja (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 uvoza

Ove vrijednosti unosite pri uvozu XML-a.

| Pitanje u aplikaciji | Zadano    |
|----------------------|-----------|
| latitude             | `48.1778` |
| longitude            | `17.1426` |
| Meteosource API key  | `apiKey`  |

## Izvori

- 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

## Povezana dokumentacija

- [Packet Parser Integration](https://taphome.com/hr/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hr/docs/integration/packet-parser/)
- [Funkcije Packet parsera](https://taphome.com/hr/docs/script/packet-parser/)
- [Funkcije za raščlambu](https://taphome.com/hr/docs/script/parsing-functions/)

