Weather Forecast API — основной и самый популярный раздел Open-Meteo: прогноз погоды до 16 дней вперёд для любой точки на Земле, построенный на данных лучших глобальных и региональных моделей (ECMWF, GFS, ICON, ARPEGE, GEM, JMA, KMA, UK Met Office, MeteoSwiss, MET Norway, KNMI, DMI, BOM, CMA и др.).
Базовый адрес
https://api.open-meteo.com/v1/forecast
Пример — почасовая температура для Москвы на ближайшие 7 дней:
https://api.open-meteo.com/v1/forecast?latitude=55.75&longitude=37.62&hourly=temperature_2m&timezone=Europe%2FMoscow
Ключевые параметры
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
latitude, longitude | число | — | Координаты (можно несколько точек через запятую) |
elevation | число | из DEM 90 м | Высота точки для статистического даунскейлинга; nan отключает коррекцию |
hourly | массив строк | — | Список часовых переменных |
daily | массив строк | — | Список суточных переменных (требует указания timezone) |
current | массив строк | — | Текущие условия «здесь и сейчас» |
forecast_days | 0–16 | 7 | Горизонт прогноза в днях |
past_days | 0–92 | 0 | Добавить данные за прошедшие дни |
forecast_hours / past_hours | целое | — | Точный диапазон в часах вместо целых дней |
start_date/end_date | yyyy-mm-dd | — | Явный диапазон дат |
models | массив строк | auto (best match) | Конкретная модель или несколько моделей вместо автоподбора |
timezone | строка | GMT | Часовой пояс ответа, либо auto |
cell_selection | строка | land | land, sea, nearest |
Часовые переменные (hourly)
Температура и влажность: temperature_2m, relative_humidity_2m, dew_point_2m, apparent_temperature, wet_bulb_temperature_2m.
Давление и облачность: pressure_msl, surface_pressure, cloud_cover (а также cloud_cover_low/mid/high).
Ветер: wind_speed_10m/80m/120m/180m, wind_direction_10m/80m/120m/180m, wind_gusts_10m.
Осадки: precipitation, rain, showers, snowfall, snow_depth, precipitation_probability, weather_code.
Радиация: shortwave_radiation, direct_radiation, diffuse_radiation, direct_normal_irradiance, global_tilted_irradiance, sunshine_duration, uv_index, uv_index_clear_sky.
Почва (5 слоёв глубины): soil_temperature_0/6/18/54cm, soil_moisture по нескольким диапазонам глубин.
Прочее: visibility, evapotranspiration, et0_fao_evapotranspiration, vapour_pressure_deficit, cape, freezing_level_height, is_day.
Также доступны переменные на 19 барических уровнях (от 1000 до 30 гПа): температура, влажность, точка росы, облачность, скорость и направление ветра, геопотенциальная высота — параметры вида temperature_850hPa, wind_speed_500hPa и т.п.
Суточные переменные (daily)
weather_code, temperature_2m_max/min/mean, apparent_temperature_max/min/mean, sunrise, sunset, daylight_duration, sunshine_duration, uv_index_max, precipitation_sum, precipitation_hours, precipitation_probability_max, rain_sum, showers_sum, snowfall_sum, wind_speed_10m_max, wind_gusts_10m_max, wind_direction_10m_dominant, shortwave_radiation_sum, et0_fao_evapotranspiration.
Текущие условия (current)
temperature_2m, relative_humidity_2m, apparent_temperature, is_day, precipitation, rain, showers, snowfall, weather_code, cloud_cover, pressure_msl, surface_pressure, wind_speed_10m, wind_direction_10m, wind_gusts_10m.
15-минутные данные
Для Центральной Европы (ICON-D2/AROME) и Северной Америки (HRRR) доступны данные с шагом 15 минут через параметр minutely_15 — включая грозовой потенциал (только HRRR), высоту снегопада и длительность солнечного сияния. В остальных регионах используется интерполяция из часовых данных.
Погодные модели
По умолчанию используется режим best_match, автоматически объединяющий лучшие доступные модели для региона. Параметр models позволяет выбрать конкретную модель: ecmwf_ifs, gfs_seamless, icon_seamless, gem_seamless, meteofrance_seamless, jma_seamless, metno_nordic и десятки других — вплоть до региональных моделей высокого разрешения (ICON-D2, HRRR, AROME).
Пример полного запроса
https://api.open-meteo.com/v1/forecast
?latitude=55.75&longitude=37.62
&hourly=temperature_2m,precipitation,wind_speed_10m
&daily=temperature_2m_max,temperature_2m_min,precipitation_sum
¤t=temperature_2m,weather_code
&timezone=auto&forecast_days=10
Ответ содержит вложенные объекты hourly/daily/current с массивом time и массивами значений для каждой запрошенной переменной, а также соответствующие *_units объекты с единицами измерения.