Тариф «Оптимальный (REST)»

Поле

Описание

Формат

now

Время сервера в формате Unixtime.

Число

now_dt

Время сервера в UTC.

Строка

info

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

Объект

fact

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

Объект

forecasts

Объект прогнозной информации о погоде.

Объект

Поле

Описание

Формат

lat

Широта (в градусах).

Число

lon

Долгота (в градусах).

Число

tzinfo

Информация о часовом поясе. Содержит поля offset, name, abbr и dst.

Объект

offset

Часовой пояс в секундах от UTC.

Число

name

Название часового пояса.

Строка

abbr

Сокращенное название часового пояса.

Строка

dst

Признак летнего времени.

Логический

def_pressure_mm

Норма давления для данной координаты (в мм рт. ст.).

Число

def_pressure_pa

Норма давления для данной координаты (в гектопаскалях).

Число

url

Страница населенного пункта на сайте Яндекс.Погода.

Строка

Поле

Описание

Формат

temp

Температура (°C).

Число

feels_like

Ощущаемая температура (°C).

Число

temp_water

Температура воды (°C). Параметр возвращается для населенных пунктов, где данная информация актуальна.

Число

icon

Код иконки погоды. Иконка доступна по адресу https://yastatic.net/weather/i/icons/funky/dark/<значение из поля icon>.svg.

Строка

condition

Код расшифровки погодного описания. Возможные значения:

• clear — ясно.
• partly-cloudy — малооблачно.
• cloudy — облачно с прояснениями.
• overcast — пасмурно.
• light-rain — небольшой дождь.
• rain — дождь.
• heavy-rain — сильный дождь.
• showers — ливень.
• wet-snow — дождь со снегом.
• light-snow — небольшой снег.
• snow — снег.
• snow-showers — снегопад.
• hail — град.
• thunderstorm — гроза.
• thunderstorm-with-rain — дождь с грозой.
• thunderstorm-with-hail — гроза с градом.

Строка

wind_speed

Скорость ветра (в м/с).

Число

wind_gust

Скорость порывов ветра (в м/с).

Число

wind_dir

Направление ветра. Возможные значения:

• «nw» — северо-западное.
• «n» — северное.
• «ne» — северо-восточное.
• «e» — восточное.
• «se» — юго-восточное.
• «s» — южное.
• «sw» — юго-западное.
• «w» — западное.
• «c» — штиль.

Строка

pressure_mm

Давление (в мм рт. ст.).

Число

pressure_pa

Давление (в гектопаскалях).

Число

humidity

Влажность воздуха (в процентах).

Число

daytime

Светлое или темное время суток. Возможные значения:

• «d» — светлое время суток.
• «n» — темное время суток.

Строка

polar

Признак того, что время суток, указанное в поле daytime,
является полярным.

Логический

season

Время года в данном населенном пункте. Возможные значения:

• «summer» — лето.
• «autumn» — осень.
• «winter» — зима.
• «spring» — весна.

Строка

obs_time

Время замера погодных данных в формате Unixtime.

Число

is_thunder

Признак грозы. Возможные значения:

• true — гроза.
• false — нет грозы.

Логический

prec_type

Тип осадков. Возможные значения:

• 0 — без осадков.
• 1 — дождь.
• 2 — дождь со снегом.
• 3 — снег.
• 4 — град.

Число

prec_strength

Сила осадков. Возможные значения:

• 0 — без осадков.
• 0.25 — слабый дождь/слабый снег.
• 0.5 — дождь/снег.
• 0.75 — сильный дождь/сильный снег.
• 1 — сильный ливень/очень сильный снег.

Число

cloudness

Облачность. Возможные значения:

• 0 — ясно.
• 0.25 — малооблачно.
• 0.5 — облачно с прояснениями.
• 0.75 — облачно с прояснениями.
• 1 — пасмурно.

Число

phenom_icon

Код дополнительной иконки погодного явления. Обрабатывается по аналогии с icon.

Строка

phenom_condition

Код расшифровки дополнительного погодного описания. Обрабатывается по аналогии с condition. Возможные значения:

• fog — туман.
• mist — дымка.
• smoke — смог.
• dust — пыль.
• dust-suspension — пылевая взвесь.
• duststorm — пыльная буря.
• thunderstorm-with-duststorm — пыльная буря с грозой.
• drifting-snow — слабая метель.
• blowing-snow — метель.
• ice-pellets — ледяная крупа.
• freezing-rain — ледяной дождь.
• tornado — торнадо.
• volcanic-ash — вулканический пепел.

Строка

Поле

Описание

Формат

date

Дата прогноза в формате ГГГГ-ММ-ДД.

Строка

date_ts

Дата прогноза в формате Unixtime.

Число

week

Порядковый номер недели.

Число

rise_begin

Время начала восхода Солнца, локальное время (может отсутствовать для полярных регионов).

Строка

sunrise

Время окончания восхода Солнца, локальное время (может отсутствовать для полярных регионов).

Строка

sunset

Время начала заката Солнца, локальное время (может отсутствовать для полярных регионов).

Строка

set_end

Время окончания заката Солнца, локальное время (может отсутствовать для полярных регионов).

Строка

moon_code

Код фазы Луны. Возможные значения:

• 0 — полнолуние.
• 1-3 — убывающая Луна.
• 4 — последняя четверть.
• 5-7 — убывающая Луна.
• 8 — новолуние.
• 9-11 — растущая Луна.
• 12 — первая четверть.
• 13-15 — растущая Луна.

Число

moon_text

Текстовый код для фазы Луны. Возможные значения:

• moon-code-0 — полнолуние.
• moon-code-1 — убывающая луна.
• moon-code-2 — убывающая луна.
• moon-code-3 — убывающая луна.
• moon-code-4 — последняя четверть.
• moon-code-5 — убывающая луна.
• moon-code-6 — убывающая луна.
• moon-code-7 — убывающая луна.
• moon-code-8 — новолуние.
• moon-code-9 — растущая луна.
• moon-code-10 — растущая луна.
• moon-code-11 — растущая луна.
• moon-code-12 — первая четверть.
• moon-code-13 — растущая луна.
• moon-code-14 — растущая луна.
• moon-code-15 — растущая луна.

Строка

parts

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

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

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

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

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

Объект

night

Объект с прогнозом погоды на ночь. Содержит следующие поля:

• temp_min

• temp_max

• temp_avg

• feels_like

• icon

• condition

• daytime

• polar

• wind_speed

• wind_gust

• wind_dir

• pressure_mm

• pressure_pa

• humidity

• prec_mm

• prec_period

• prec_type

• prec_strength

• cloudness

  Внимание

  Начало ночного периода соответствует времени начала суток. Для указания предстоящей ночной температуры используйте объект ночного прогноза следующего дня.

Объект

temp_min

Минимальная температура для времени суток (°C).

Число

temp_max

Максимальная температура для времени суток (°C).

Число

temp_avg

Средняя температура для времени суток (°C).

Число

feels_like

Ощущаемая температура (°C).

Число

icon

Код иконки погоды. Иконка доступна по адресу https://yastatic.net/weather/i/icons/funky/dark/<значение из поля icon>.svg.

Строка

condition

Код расшифровки погодного описания. Возможные значения:

• clear — ясно.
• partly-cloudy — малооблачно.
• cloudy — облачно с прояснениями.
• overcast — пасмурно.
• light-rain — небольшой дождь.
• rain — дождь.
• heavy-rain — сильный дождь.
• showers — ливень.
• wet-snow — дождь со снегом.
• light-snow — небольшой снег.
• snow — снег.
• snow-showers — снегопад.
• hail — град.
• thunderstorm — гроза.
• thunderstorm-with-rain — дождь с грозой.
• thunderstorm-with-hail — гроза с градом.

Строка

daytime

Светлое или темное время суток. Возможные значения:

• «d» — светлое время суток.
• «n» — темное время суток.

Строка

polar

Признак того, что время суток, указанное в поле daytime, является полярным.

Логический

wind_speed

Скорость ветра (в м/с).

Число

wind_gust

Скорость порывов ветра (в м/с).

Число

wind_dir

Направление ветра. Возможные значения:

• «nw» — северо-западное.
• «n» — северное.
• «ne» — северо-восточное.
• «e» — восточное.
• «se» — юго-восточное.
• «s» — южное.
• «sw» — юго-западное.
• «w» — западное.
• «c» — штиль.

Строка

pressure_mm

Давление (в мм рт. ст.).

Число

pressure_pa

Давление (в гектопаскалях).

Число

humidity

Влажность воздуха (в процентах).

Число

soil_temp

Температура почвы (°C).

Число

soil_moisture

Влажность почвы (в процентах).

Число

prec_mm

Прогнозируемое количество осадков (в мм).

Число

prec_period

Прогнозируемый период осадков (в минутах).

Число

prec_prob

Вероятность выпадения осадков (в процентах).

Число

prec_type

Тип осадков. Возможные значения:

• 0 — без осадков.
• 1 — дождь.
• 2 — дождь со снегом.
• 3 — снег.

Число

prec_strength

Сила осадков. Возможные значения:

• 0 — без осадков.
• 0.25 — слабый дождь/слабый снег.
• 0.5 — дождь/снег.
• 0.75 — сильный дождь/сильный снег.
• 1 — сильный ливень/очень сильный снег.

Число

fresh_snow_mm

Количество свежего снега (в мм). Вычисляется на основе значения поля prec_mm.

Число

cloudness

Облачность. Возможные значения:

• 0 — ясно.
• 0.25 — малооблачно.
• 0.5 — облачно с прояснениями.
• 0.75 — облачно с прояснениями.
• 1 — пасмурно.

Число

uv_index

Ультрафиолетовый индекс.

Число

day_short

Объект с 12-часовым прогнозом на день. Содержит следующие поля:

• temp
• temp_min
• feels_like
• icon
• condition
• wind_speed
• wind_gust
• wind_dir
• pressure_mm
• pressure_pa
• humidity
• prec_type
• prec_strength
• cloudness

Объект

temp

Максимальная дневная или минимальная ночная температура (°C).

Число

hours

Объект почасового прогноза погоды. Содержит 96 частей (часов), после возвращается пустая строка. Каждая часть имеет следующие поля:

• hour
• hour_ts
• temp
• feels_like
• icon
• condition
• wind_speed
• wind_gust
• wind_dir
• pressure_mm
• pressure_pa
• humidity
• prec_mm
• prec_period
• prec_type
• prec_strength
• is_thunder
• cloudness

Объект

hour

Значение часа, для которого дается прогноз (0-23), локальное время.

Строка

hour_ts

Время прогноза в Unixtime.

Число