Veřejné API: počasí pro Česko
Předpověď, radarový nowcast a výstrahy ČHMÚ běžným HTTP dotazem — stejná data, jaká vydává MCP server pro AI asistenty. Zdarma, bez registrace a bez klíče.
Endpointy
Místo se zadává jménem obce (place=Turnov) nebo souřadnicemi (lat=50.587&lon=15.157).
GET /v1/forecast— předpověď: shrnutí větami a čísla na dnes a zítra (teplota, srážky, vítr).GET /v1/rain-now— prší, nebo bude pršet: tři hodiny dopředu z českého radaru, kdy déšť začne či přestane a jak silný bude.GET /v1/warnings— platné výstrahy ČHMÚ pro místo. Bez parametrů vrátí přehled za celou ČR.
Zkuste to
curl "https://api.pocasko.cz/v1/forecast?place=Turnov"
Odpověď (zkráceně):
{
"misto": "Turnov (okres Semily)",
"shrnuti": ["Večer bude polojasno, v noci se vyjasní…"],
"dnes": { "teplota": "13.5 až 21.0 °C", "pocasi": "Polojasno", "vitr_kmh": 21.3 },
"zitra": { "teplota": "10.0 až 18.8 °C", "pocasi": "Polojasno", "vitr_kmh": 15.1 },
"zdroj": "Počásko (pocasko.cz), data ČHMÚ"
}
Úplný popis včetně všech polí a možnosti vyzkoušet dotazy rovnou v prohlížeči je v interaktivní dokumentaci.
Chyby
Chybu říká stavový kód, podrobnost je v těle spolu se strojovým polem kod:
- 400 — chybí místo, nebo je název nejednoznačný. U názvů jako „Ústí“ vrátíme seznam obcí v poli
moznostia necháme vybrat, místo abychom tiše ukázali počasí jinde. - 404 — obec není v číselníku, nebo bod leží mimo Česko.
- 503 — nowcast pro ten bod právě není k dispozici.
- 429 — překročený limit; hlavička
Retry-Afterřekne, za jak dlouho to zkusit znovu.
Pravidla
- Limit 60 volání za 5 minut z jedné adresy. Odpovědi se dají cachovat (
Cache-Controlv hlavičce), takže se limit běžně nepotká s ničím rozumným. - Prosíme o uvedení zdroje: Počásko (pocasko.cz).
- Data ČHMÚ jsou využita podle licence CC BY 4.0. Předpověď je informativní služba; při výstrahách se řiďte pokyny ČHMÚ a úřadů.
- Chybí vám tu něco, co byste potřebovali? Dejte vědět a rozšíříme to.
Odkud data jsou
Model ALADIN od ČHMÚ, radarový kompozit, stanice a výstrahy — podrobně na stránce zdroje dat a měření přesnosti. O projektu se dočtete tady.