Ответ

Ответ на запрос Фактическое значение и прогноз погоды возвращается в формате JSON. Информация в ответе содержит:

Поле Описание Формат
now Время сервера в формате Unixtime. Число
now_dt Время сервера в UTC. Строка
info Объект информации о населенном пункте. Объект
fact Объект фактической информации о погоде. Объект
forecasts Объект прогнозной информации о погоде. Объект

Объект info

Объект содержит информацию о населенном пункте.

Поле Описание Формат
lat Широта (в градусах). Число
lon Долгота (в градусах). Число
geoid Идентификатор населенного пункта. Число
slug URL-путь на странице https://yandex.TLD/pogoda/. Строка
tzinfo Информация о часовом поясе. Содержит поля offset, name, abbr и dst. Объект
offset Часовой пояс в секундах от UTC. Число
name Название часового пояса. Строка
abbr Сокращенное название часового пояса. Строка
dst Признак летнего времени. Логический
def_pressure_mm Норма давления для данной координаты (в мм рт. ст.). Число
def_pressure_pa Норма давления для данной координаты (в гектопаскалях). Число
url Страница населенного пункта на сайте Яндекс.Погода. Строка

Объект fact

Объект содержит информацию о погоде на данный момент.

Поле Описание Формат
temp Температура (°C). Число
feels_like Ощущаемая температура (°C). Число
temp_water Температура воды (°C). Параметр возвращается для населенных пунктов, где данная информация актуальна. Число
icon Код иконки погоды. Иконка доступна по адресу https://yastatic.net/weather/i/icons/blueye/color/svg/<значение из поля icon>.svg. Строка
condition Код расшифровки погодного описания. Возможные значения:
  • clear — ясно.
  • partly-cloudy — малооблачно.
  • cloudy — облачно с прояснениями.
  • overcast — пасмурно.
  • partly-cloudy-and-light-rain — малооблачно, небольшой дождь.
  • partly-cloudy-and-rain — малооблачно, дождь.
  • overcast-and-rain — значительная облачность, сильный дождь.
  • overcast-thunderstorms-with-rain — сильный дождь с грозой.
  • cloudy-and-light-rain — облачно, небольшой дождь.
  • overcast-and-light-rain — значительная облачность, небольшой дождь.
  • cloudy-and-rain — облачно, дождь.
  • overcast-and-wet-snow — дождь со снегом.
  • partly-cloudy-and-light-snow — небольшой снег.
  • partly-cloudy-and-snow — малооблачно, снег.
  • overcast-and-snow — снегопад.
  • cloudy-and-light-snow — облачно, небольшой снег.
  • overcast-and-light-snow — значительная облачность, небольшой снег.
  • cloudy-and-snow — облачно, снег.
Строка
wind_speed Скорость ветра (в м/с). Число
wind_gust Скорость порывов ветра (в м/с). Число
wind_dir Направление ветра. Возможные значения:
  • «nw» — северо-западное.
  • «n» — северное.
  • «ne» — северо-восточное.
  • «e» — восточное.
  • «se» — юго-восточное.
  • «s» — южное.
  • «sw» — юго-западное.
  • «w» — западное.
  • «с» — штиль.
Строка
pressure_mm Давление (в мм рт. ст.). Число
pressure_pa Давление (в гектопаскалях). Число
humidity Влажность воздуха (в процентах). Число
daytime Светлое или темное время суток. Возможные значения:
  • «d» — светлое время суток.
  • «n» — темное время суток.
Строка
polar Признак того, что время суток, указанное в поле daytime, является полярным. Логический
season Время года в данном населенном пункте. Возможные значения:
  • «summer» — лето.
  • «autumn» — осень.
  • «winter» — зима.
  • «spring» — весна.
Строка
obs_time Время замера погодных данных в формате Unixtime. Число
prec_type Тип осадков. Возможные значения:
  • 0 — без осадков.
  • 1 — дождь.
  • 2 — дождь со снегом.
  • 3 — снег.
Число
prec_strength Сила осадков. ВÏ Число
cloudness Облачность. Возможные значения:
  • 0 — ясно.
  • 0.25 — малооблачно.
  • 0.5 — облачно с прояснениями.
  • 0.75 — облачно с прояснениями.
  • 1 — пасмурно.
Число

Объект forecasts

Объект содержит данные прогноза погоды.

Поле Описание Формат
date Дата прогноза в формате ГГГГ-ММ-ДД. Строка
date_ts Дата прогноза в формате Unixtime. Число
week Порядковый номер недели. Число
sunrise Время восхода Солнца, локальное время (может отсутствовать для полярных регионов). Строка
sunset Время заката Солнца, локальное время (может отсутствовать для полярных регионов). Строка
moon_code Код фазы Луны. Возможные значения:
  • 0 — полнолуние.
  • 1-3 — убывающая Луна.
  • 4 — последняя четверть.
  • 5-7 — убывающая Луна.
  • 8 — новолуние.
  • 9-11 — растущая Луна.
  • 12 — первая четверть.
  • 13-15 — растущая Луна.
Число
moon_text Текстовый код для фазы Луны. Возможные значения:
  • full-moon — полнолуние.
  • decreasing-moon — убывающая Луна.
  • last-quarter — последняя четверть.
  • new-moon — новолуние.
  • growing-moon — растущая Луна.
  • first-quarter — первая четверть.
Строка
parts

Прогнозы по времени суток и 12-часовые прогнозы.

Содержит поля, различающиеся типом прогноза:

  • night — прогноз на ночь.
  • morning — прогноз на утро.
  • day — прогноз на день.
  • evening — прогноз на вечер.
  • day_short — 12-часовой прогноз на день.
  • night_short — прогноз на ночь, для которого исключены поля temp_min и temp_max, в поле temp указывается минимальная температура за ночной период.

Все прогнозы погоды на время суток имеют одинаковый набор полей.

Все 12-часовые прогнозы имеют одинаковый набор полей.

Примечание. В последнем возвращаемом дне прогноза состав частей может быть неполным.
Объект
night Объект с прогнозом погоды на ночь. Содержит следующие поля:
Внимание. Начало ночного периода соответствует времени начала суток. Для указания предстоящей ночной температуры используйте объект ночного прогноза следующего дня.
Объект
temp_min Минимальная температура для времени суток (°C). Число
temp_max Максимальная температура для времени суток (°C). Число
temp_avg Средняя температура для времени суток (°C). Число
feels_like Ощущаемая температура (°C). Число
icon Код иконки погоды. Иконка доступна по адресу https://yastatic.net/weather/i/icons/blueye/color/svg/<значение из поля icon>.svg. Строка
condition Код расшифровки погодного описания. Возможные значения:
  • clear — ясно.
  • partly-cloudy — малооблачно.
  • cloudy — облачно с прояснениями.
  • overcast — пасмурно.
  • partly-cloudy-and-light-rain — малооблачно, небольшой дождь.
  • partly-cloudy-and-rain — малооблачно, дождь.
  • overcast-and-rain — значительная облачность, сильный дождь.
  • overcast-thunderstorms-with-rain — сильный дождь с грозой.
  • cloudy-and-light-rain — облачно, небольшой дождь.
  • overcast-and-light-rain — значительная облачность, небольшой дождь.
  • cloudy-and-rain — облачно, дождь.
  • overcast-and-wet-snow — дождь со снегом.
  • partly-cloudy-and-light-snow — небольшой снег.
  • partly-cloudy-and-snow — малооблачно, снег.
  • overcast-and-snow — снегопад.
  • cloudy-and-light-snow — облачно, небольшой снег.
  • overcast-and-light-snow — значительная облачность, небольшой снег.
  • cloudy-and-snow — облачно, снег.
Строка
daytime Светлое или темное время суток. Возможные значения:
  • «d» — светлое время суток.
  • «n» — темное время суток.
Строка
polar Признак того, что время суток, указанное в поле daytime, является полярным. Логический
wind_speed Скорость ветра (в м/с). Число
wind_gust Скорость порывов ветра (в м/с). Число
wind_dir Направление ветра. Возможные значения:
  • «nw» — северо-западное.
  • «n» — северное.
  • «ne» — северо-восточное.
  • «e» — восточное.
  • «se» — юго-восточное.
  • «s» — южное.
  • «sw» — юго-западное.
  • «w» — западное.
  • «с» — штиль.
Строка
pressure_mm Давление (в мм рт. ст.). Число
pressure_pa Давление (в гектопаскалях). Число
humidity Влажность воздуха (в процентах). Число
prec_mm Прогнозируемое количество осадков (в мм). Число
prec_period Прогнозируемый период осадков (в минутах). Число
prec_type Тип осадков. Возможные значения:
  • 0 — без осадков.
  • 1 — дождь.
  • 2 — дождь со снегом.
  • 3 — снег.
Число
prec_strength Сила осадков. Возможные значения:
  • 0 — без осадков.
  • 0.25 — слабый дождь/слабый снег.
  • 0.5 — дождь/снег.
  • 0.75 — сильный дождь/сильный снег.
  • 1 — сильный ливень/очень сильный снег.
Число
cloudness Облачность. Возможные значения:
  • 0 — ясно.
  • 0.25 — малооблачно.
  • 0.5 — облачно с прояснениями.
  • 0.75 — облачно с прояснениями.
  • 1 — пасмурно.
Число
day_short Объект с 12-часовым прогнозом на день. Содержит следующие поля: Объект
temp Максимальная дневная или минимальная ночная температура (°C). Число
hours Объект почасового прогноза погоды. Содержит 24 части (часа) в первые 2-3 суток, после возвращается пустая строка. Каждая часть имеет следующие поля: Объект
hour Значение часа, для которого дается прогноз (0-23), локальное время. Строка
hour_ts Время прогноза в Unixtime. Число

Пример ответа

Ниже приведен пример ответа на запрос прогноза погоды:

GET https://api.weather.yandex.ru/v1/forecast?lat=55.75396&lon=37.620393&extra=true
{
  "now": 1470220206,
  "now_dt": "2016-08-03T10:30:06.238Z",
  "info": {
    "lat": 55.833333,
    "lon": 37.616667,
    "geoid": 213,
    "slug": "moscow",
    "tzinfo": {
      "offset": 10800,
      "name": "Europe/Moscow",
      "abbr": "MSK",
      "dst": false
    },
    "def_pressure_mm": 746,
    "def_pressure_pa": 994,
    "url": "https://yandex.ru/pogoda/moscow"
  },
  "fact": {
    "temp": 20,
    "feels_like": 21,
    "icon": "ovc",
    "condition": "overcast",
    "wind_speed": 2,
    "wind_gust": 5.9,
    "wind_dir": "n",
    "pressure_mm": 745,
    "pressure_pa": 994,
    "humidity": 83,
    "daytime": "d",
    "polar": false,
    "season": "summer",
    "prec_type": 1,
    "prec_strength": 0.25,
    "cloudness": 1,
    "obs_time": 1470214800
  },
  "forecasts": [
    {
      "date": "2016-08-03",
      "date_ts": 1470171600,
      "week": 32,
      "sunrise": "04:38",
      "sunset": "20:31",
      "moon_code": 8,
      "moon_text": "new-moon",
      "parts": {
        "night": {
          "temp_min": 20,
          "temp_max": 21,
          "temp_avg": 21,
          "feels_like": 23,
          "icon": "bkn_n",
          "condition": "cloudy",
          "daytime": "n",
          "polar": false,
          "wind_speed": 0.9,
          "wind_gust": 4,
          "wind_dir": "nw",
          "pressure_mm": 746,
          "pressure_pa": 995,
          "humidity": 81,
          "prec_mm": 0,
          "prec_period": 360,
          "prec_type": 1,
          "prec_strength": 0.5,
          "cloudness": 0.75
        },
        ...
        "evening": {
          "temp_min": 17,
          "temp_max": 19,
          "temp_avg": 18,
          "feels_like": 19,
          "icon": "ovc_+ra",
          "condition": "overcast-and-rain",
          "daytime": "d",
          "polar": false,
          "wind_speed": 1.8,
          "wind_dir": "nw",
          "pressure_mm": 745,
          "pressure_pa": 994,
          "humidity": 99,
          "prec_mm": 17.95,
          "prec_period": 360,
          "prec_type": 1,
          "prec_strength": 0.5,
          "cloudness": 0.75,
          "_fallback_temp": false,
          "_fallback_prec": false
        },
        "day_short": {
          "temp": 20,
          "temp_min": 18,
          "feels_like": 21,
          "icon": "bkn_+ra_d",
          "condition": "overcast-and-rain",
          "wind_speed": 1.9,
          "wind_gust": 5.9,
          "wind_dir": "nw",
          "pressure_mm": 745,
          "pressure_pa": 994,
          "humidity": 88,
          "prec_type": 1,
          "prec_strength": 0.25,
          "cloudness": 1,
          "_fallback_temp": false,
          "_fallback_prec": false
        },
        "night_short": {
          "temp": 20,
          "feels_like": 22,
          "icon": "bkn_n",
          "condition": "cloudy",
          "wind_speed": 0.9,
          "wind_gust": 5.9,
          "wind_dir": "nw",
          "pressure_mm": 746,
          "pressure_pa": 995,
          "humidity": 81,
          "prec_type": 1,
          "prec_strength": 0.25,
          "cloudness": 1,
          "_fallback_temp": false,
          "_fallback_prec": false
        }
      },
      "hours": [
        {
          "hour": "0",
          "hour_ts": 1470171600,
          "temp": 21,
          "feels_like": 23,
          "icon": "bkn_n",
          "condition": "partly-cloudy",
          "wind_speed": 0.3,
          "wind_gust": 4,
          "wind_dir": "nw",
          "pressure_mm": 746,
          "pressure_pa": 995,
          "humidity": 80,
          "prec_mm": 0,
          "prec_period": 60,
          "prec_type": 1,
          "prec_strength": 0.5,
          "cloudness": 1,
          "_fallback_temp": false,
          "_fallback_prec": false
        },
        ...
        {
          "hour": "23",
          "hour_ts": 1470254400,
          "temp": 17,
          "feels_like": 19,
          "icon": "ovc_-ra",
          "condition": "overcast-and-light-rain",
          "wind_speed": 0.9,
          "wind_gust": 3.6,
          "wind_dir": "nw",
          "pressure_mm": 745,
          "pressure_pa": 994,
          "humidity": 100,
          "prec_mm": 0.05,
          "prec_period": 60,
          "prec_type": 1,
          "prec_strength": 0.5,
          "cloudness": 1,
          "_fallback_temp": false,
          "_fallback_prec": false
        }
      ]
    },
    ...
    {
      "date": "2016-08-10",
      "date_ts": 1471035600,
      "week": 33,
      "sunrise": "04:57",
      "sunset": "20:09",
      "moon_code": 13,
      "moon_text": "growing-moon",
      "parts": {
        "night": {...},
        "morning": {...},
        "day": {...},
        "evening": {...},
        "day_short": {...},
        "night_short": {...}
      },
      "hours": [...]
    }
  ]
}