Kontakt

Publikace

Naměřené hodnoty jsou veřejně dostupné, možnosti jak k nim přistupovat jsou popsány níže:

Web - Nejpodrobnější informace můžete najít přímo na těchto stránkách.

Telegram bot - Přehled základních hodnot si můžete nechat zaslat v chatovací aplikaci Telegram od bota "weather-link.cz".

Webové api - Naměřené hodnoty můžete vkládat a využívat ve svých webových a jiných aplikacích.

Api

Naměřené hodnoty můžete vkládat a využívat ve svých webových a jiných aplikacích.
Jsou veřejně přístupné ve webovém api v těchto formátech:

JSON

Api je rozděleno do souborů podle obsahu:

all.json - Obsahuje aktuální naměřené hodnoty. Aktualizuje se s periodou 60s.
maxmin.json - Záznam rekordních hodnot (nejvyšších a nejnižších hodnot sledovaných veličin). Aktualizuje se s překročením rekordních hodnot.

Data jsou přístupná pomocí protokolů http/https v podobě pravidelně aktualizovaných souborů.
Příklad a šablonu pro využití naleznete zde.

Umístění a obsah souborů naleznete niže:

all.json

Json sobor naleznete na adrese:

https://weather-link.cz/api/<číslo_stanice>/all.json

Např.: https://weather-link.cz/api/1/all.json je adresa pro stanici "Jindřichova Ves"
Příklad Číslo stanice můžete najít v tabulce níže:

Číslo stanice	Jméno stanice
1	Jindřichova Ves

Json soubor obsahuje jednoduchý objekt s vlastnostmi. Tyto vlastnosi jsou vypsány v tabulce níže:

Vlastnost	Popis	Datový typ	Poznámka
unix_timestamp	Časový snímek měření	int	Unixový čas
datetime	Časový snímek měření	string	ve formátu: "RRRR-MM-DD HH:mm:SS", pro Českou republiku
maxTemp	Nejvyšší teplota	float	za posledních 24h, [°C]
minTemp	Nejnižší teplota	float	za posledních 24h, [°C]
temp	Aktuální teplota	float	[°C]
hum	Aktuální vlhkost	float	relativní, [%]
prsr	Aktuální tlak	float	relativní, [hPa]
windSpeedAveM	Rychlost větru - průměrná	float	za 10 minut, [km/h]
windGustMaxM	Nárazy větru - maximální	float	za 10 minut, [km/h]
windDirAveM	Směr větru - průměrný	float	za 10 minut, udává odkud vane vítr (0° - S, 90° - V) (0° - 360°) [°]
windSpeedAveH	Rychlost větru - průměrná	float	za hodinu, [km/h]
windGustMaxH	Nárazy větru - maximální	float	za hodinu, [km/h]
windDirAveH	Směr větru - průměrný	float	za hodinu, udává odkud vane vítr (0° - S, 90° - V) (0° - 360°) [°]
windSpeedAveD	Rychlost větru - průměrná	float	za den, [km/h]
windGustMaxD	Nárazy větru - maximální	float	za den, [km/h]
windDirAveD	Směr větru - průměrný	float	za den, udává odkud vane vítr (0° - S, 90° - V) (0° - 360°) [°]
windSpeed	Rychlost větru - průměrná	float	za minutu, [km/h]
windGust	Nárazy větru - maximální	float	za minutu, [km/h]
windDir	Směr větru - průměrný	float	za minutu, udává odkud vane vítr (0° - S, 90° - V) (0° - 360°) [°]
windDirText	Směr větru - průměrný	string	za minutu, udává odkud vane vítr (ve zkratkách, např.: S, SZ, ...)
beaufortAveM	Beaufortova stupnice	int	z prům. rychlosti za 10 minut, udává sílu větru podle Beaufortovy stupnice (0 - 12)
apparentTemp	Aktuální pocitová teplota	float	[°C]

Poznámka: Vlastnosti json objeku budou přibývat s rozšiřováním měřených hodnot a jejich vyhodnocováním. Pro zajištění kompatibility budou zachovány názvy a formát již existujicích vlastností. Poslední aktualizace 21. 5. 2022

Příklad:

{
  "unix_timestamp": 1653145763,
  "datetime": "2022-05-21 17:09:23",
  "maxTemp": 25.142,
  "minTemp": 9.267,
  "temp": 14.062,
  "hum": 98.3,
  "prsr": null,
  "windSpeedAveM": 10.125,
  "windGustMaxM": 27.522,
  "windDirAveM": 313,
  "windSpeedAveH": 10.954,
  "windGustMaxH": 47.092,
  "windDirAveH": 308,
  "windSpeedAveD": 8.566,
  "windGustMaxD": 54.72,
  "windDirAveD": 292,
  "windSpeed": 8.413,
  "windGust": 16.509,
  "windDir": 321,
  "windDirText": "SZ",
  "beaufortAveM": 2,
  "apparentTemp": 13.622
}

Poznámka: V případě výpadku nemusí json objekt obsahovat některé vlastnosti (hodnoty), nebo mohou vlastnosti nabývat hodnoty null.

maxmin.json

Json sobor naleznete na adrese:

https://weather-link.cz/api/<číslo_stanice>/maxmin.json

Např.: https://weather-link.cz/api/1/maxmin.json je adresa pro stanici "Jindřichova Ves"
Číslo stanice můžete najít v tabulce uvedené výše. (v podkapitole all.json)

Json soubor obsahuje pole objektů, každý objekt odpovídá jedné sledované hodnotě a má tyto vlastnosti:

Vlastnost	Popis	Datový typ	Poznámka
var	jméno sledované hodnoty	string	(odpovídají názvům z tabulky v podkapitole all.json), např.: "apparentTemp" - Aktuální pocitová teplota
val	rekordní hodnota	float
datetime	Časový snímek	int	Časový snímek okamžiku, kdy byla zaznamenána rekordní hodnota. (Unixový čas)
type	Typ rekordu	string	Určuje zda-li jde o nejnižší nebo nejvyšší hodnotu. Nabývá hodnot "max" a "min".

Výpis sledovaných hodnot:

sledovaná hodnota	typ rekordní hodnoty
windSpeed	max
temp	max
temp	min
windGust	max
prsr	max
prsr	min
apparentTemp	max
apparentTemp	min

[
  { "var": windSpeed, "val": 36.8927, "datetime": 1647046201, "type": "max" },
  { "var": temp, "val": 26.0495, "datetime": 1653056659, "type": "max" },
  { "var": temp, "val": -11.827, "datetime": 1640462263, "type": "min" },
  { "var": windGust, "val": 95.3137, "datetime": 1647043733, "type": "max" },
  { "var": prsr, "val": 1040.83, "datetime": 1642030558, "type": "max" },
  { "var": prsr, "val": 925.48, "datetime": 1653160089, "type": "min" },
  { "var": apparentTemp, "val": 31.185, "datetime": 1653056293, "type": "max" },
  { "var": apparentTemp, "val": -15.107, "datetime": 1647060227, "type": "min" }
]