Погодинний та щоденний прогноз погоди на основі даних Фінського метеорологічного інституту (FMI)
Прогноз погоди для міст України на основі даних FMI
Weather API надає прогноз погоди для міст України на основі даних Фінського метеорологічного інституту (FMI). Дані оновлюються кожні 3 години та зберігаються локально для швидкого доступу.
https://geodataua.runasp.net/api/weather
Найближчий годинний запис: температура, вологість, тиск, вітер, опади
Прогноз по годинам на 1–10 днів з детальними параметрами
Агрегація min/max/avg температури, опадів та вітру на 1–10 днів
Прогноз на основі даних Фінського метеорологічного інституту (FMI)
Детальний прогноз по годинам
| Час | Погода | Опади | Темп | Вітер | Пориви | Вол. |
|---|
Агреговані показники min/max температури, опадів та вітру по днях
Ендпоінти Weather API
API-ключ передається у заголовку кожного запиту:
X-API-Key: <YOUR_API_KEY>API-ключ видається при реєстрації клієнта в особистому кабінеті.
Поточна погода для міста — найближчий годинний запис з прогнозу.
| Параметр | Тип | Обов'язк. | Опис |
|---|---|---|---|
cityId |
int | ✅ | ID міста з бази GeoData |
{
"station": {
"stationName": "Kyiv",
"city": "Київ",
"region": "Київська область",
"latitude": 50.4501,
"longitude": 30.5234
},
"forecast": {
"localTime": "2026-04-09T18:00:00",
"temperature": 6,
"dewPoint": -2,
"humidity": 55,
"pressure": 1015,
"windDirection": 358,
"windSpeedMS": 4,
"windGust": 10,
"windCompass8": "N",
"precipitation": 0,
"weatherCode": 4,
"weatherText": "partly cloudy",
"isDark": false,
"sunrise": "03:17",
"sunset": "16:42",
"dayLengthMinutes": 806
}
}Погодинний прогноз за діапазоном дат.
| Параметр | Тип | Обов'язк. | Опис |
|---|---|---|---|
cityId |
int | ✅ | ID міста |
from |
date | ❌ | Початок діапазону (за замовч. — зараз) |
to |
date | ❌ | Кінець діапазону (за замовч. — +3 дні) |
Щоденний прогноз — агрегація min/max/avg по днях.
| Параметр | Тип | Обов'язк. | Опис |
|---|---|---|---|
cityId |
int | ✅ | ID міста |
from |
date | ❌ | Початок (за замовч. — сьогодні) |
to |
date | ❌ | Кінець (за замовч. — +7 днів) |
| Метод | Ендпоінт | Опис |
|---|---|---|
| GET | /api/weather/current |
Поточна погода для міста |
| GET | /api/weather/hourly |
Погодинний прогноз за діапазоном дат |
| GET | /api/weather/daily |
Щоденний прогноз (агрегований) |
SmartSymbol — система кодів FMI для відображення погодних станів
Нічні коди = денні + 100. CSS-клас dark додається для нічних версій
| Код | Ніч | День | Ніч | CSS-клас | UA назва |
|---|---|---|---|---|---|
| 1 | 101 | ☀️ | 🌙 | clear | Ясно |
| 2 | 102 | 🌤️ | 🌙 | mostly-clear | Переважно ясно |
| 4 | 104 | ⛅ | ☁️ | partly-cloudy | Мінлива хмарність |
| 6 | 106 | 🌥️ | ☁️ | mostly-cloudy | Переважно хмарно |
| 7 | 107 | ☁️ | ☁️ | overcast | Похмуро |
| 31 | 131 | 🌦️ | 🌧️ | periods-of-light-rain | Часом невеликий дощ |
| 34 | 134 | 🌧️ | 🌧️ | moderate-rain | Помірний дощ |
| 35 | 135 | 🌧️ | 🌧️ | heavy-rain | Сильний дощ |
| 37 | 137 | 🌦️ | 🌧️ | light-rain | Невеликий дощ |
| 38 | 138 | 🌧️ | 🌧️ | moderate-rain | Помірний дощ |
| 41 | 141 | 🌨️ | 🌨️ | light-snow | Невеликий сніг |
| 44 | 144 | ❄️ | ❄️ | moderate-snow | Помірний сніг |
| 47 | 147 | 🌨️ | 🌨️ | light-sleet | Невеликий мокрий сніг |
| 51 | 151 | ⛈️ | ⛈️ | thunderstorm | Гроза |