---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.6
alternate:
  - https://yandex.com/dev/weather/doc/en/concepts/forecast-test-v1.md
  - https://yandex.com/dev/weather/doc/ru/concepts/forecast-test-v1.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/weather/doc/ru/llms.txt

# Тариф «Тестовый»

{% note alert %}

Данная версия API устарела. Используйте [новую версию](https://yandex.com/dev/weather/doc/ru/concepts/forecast-rest.md).

{% endnote %}

Запрос позволяет узнать фактическое значение и прогноз погоды для указанного населенного пункта.

- [Формат запроса](#req-format)
- [Формат ответа](#resp-format)
- [Пример](#req-example)

## Формат запроса {#req-format}

Населенный пункт указывается при помощи значений широты (параметр [lat](#lat-param)) и долготы (параметр [lon](#lon-param)). Если данные параметры заданы некорректно, ответ будет содержать код ошибки 404.

```
GET https://api.weather.yandex.ru/v1/forecast?
 [lat](*lat)=<широта>
 & [lon](*lon)=<долгота>
 & [[lang](*lang)=<язык ответа>]
 & [[limit](*limit)=<срок прогноза>]
 & [[hours](*hours)=<наличие почасового прогноза>]
 & [[extra](*extra)=<подробный прогноз осадков>]

[X-Yandex-Weather-Key](*X_Yandex_Weather_Key): <значение ключа>
```

Заголовки запроса:

#### X-Yandex-Weather-Key {#X-Yandex-Weather-Key-param}

Ключ, полученный на этапе [подключения к API Яндекс Погоды](https://yandex.com/dev/weather/doc/ru/concepts/api.md#onboarding).

Параметры запроса:

#### lat {#lat-param}

Широта в градусах. Обязательное поле.

#### lon {#lon-param}

Долгота в градусах. Обязательное поле.

#### lang {#lang-param}

Сочетания языка и страны, для которых будут возвращены данные погодных формулировок. Допустимые значения:

- «ru_RU» — русский язык для домена России.
- «be_BY» — белорусский язык для домена Беларуси.
- «kk_KZ» — казахский язык для домена Казахстана.
- «tr_TR» — турецкий язык для домена Турции.
- «en_US» — международный английский.

#### limit {#limit-param}

Количество дней в прогнозе, включая текущий.

Для тарифа «[Тестовый](https://yandex.com/dev/weather/doc/ru/concepts/pricing.md#test)» максимально допустимое значение — 7.<!--<ph>, а для тарифа <q><xref href="pricing.dita#about/full">Полный</xref></q> — 10</ph>-->

#### hours {#hours-param}

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

- «true» — значение по умолчанию, почасовой прогноз возвращается.
- «false» — почасовой прогноз не возвращается.

#### extra {#extra-param}

Расширенная информация об осадках. Допустимые значения:

- «true» — расширенная информация об осадках возвращается.
- «false» — значение по умолчанию, расширенная информация об осадках не возвращается.

## Формат ответа {#resp-format}

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

#|
|| **Поле** | **Описание** | **Формат** ||
|| `now` | Время сервера в формате Unixtime. | Число ||
|| `now_dt` | Время сервера в UTC. | Строка ||
|| `info` | [Объект информации о населенном пункте](#info). | Объект ||
<!--<row><entry> <xmlelement>geo_object</xmlelement> </entry><entry><xref href="#forecast-response-test/geo-object">Объект расшифровки населенного пункта</xref>.</entry><entry>Объект</entry></row>-->
|| `fact` | [Объект фактической информации о погоде](#fact). | Объект ||
|| `forecasts` | [Объект прогнозной информации о погоде](#forecasts). | Объект ||
|#
<!--<row><entry> <xmlelement>l10n</xmlelement> </entry><entry><xref href="#forecast-response-test/l10n">Объект переводов</xref>.</entry><entry>Объект</entry></row>-->
### Объект info {#info}

{% include [forecast-response-full-info-text](../_includes/concepts/forecast-response-full/id-forecast-response-full/info-text-0ed84b813251.md) %}

#|
|| **Поле** | **Описание** | **Формат** ||
|| `lat` | Широта (в градусах). | Число ||
|| `lon` | Долгота (в градусах). | Число ||
<!--<row conref="forecast-response-full.dita#forecast-response-full/info-geoid"><entry/></row>-->
<!--<row conref="forecast-response-full.dita#forecast-response-full/info-slug"><entry/></row>-->
|| `tzinfo` | Информация о часовом поясе. Содержит поля [offset](*offset), [name](*name), [abbr](*abbr) и [dst](*dst). | Объект ||
|| `offset` | Часовой пояс в секундах от UTC. | Число ||
|| `name` | Название часового пояса. | Строка ||
|| `abbr` | Сокращенное название часового пояса. | Строка ||
|| `dst` | Признак летнего времени. | Логический ||
|| `def_pressure_mm` | Норма давления для данной координаты (в мм рт. ст.). | Число ||
|| `def_pressure_pa` | Норма давления для данной координаты (в гектопаскалях). | Число ||
|| `url` | Страница населенного пункта на сайте [Яндекс.Погода](https://yandex.ru/pogoda/). | Строка ||
|#
<!--<section id="geo-object"><title>Объект geo_object</title><p conref="forecast-response-full.dita#forecast-response-full/geo-obj-text"/><table frame="all"><tgroup cols="3"><colspec colname="c1" colwidth="20*"/><colspec colname="c2" colwidth="65*"/><colspec colname="c3" colwidth="15*"/><thead><row><entry>Поле</entry><entry>Описание</entry><entry>Формат</entry></row></thead><tbody><row conref="forecast-response-full.dita#forecast-response-full/geoobject-district"><entry/></row><row conref="forecast-response-full.dita#forecast-response-full/geoobject-id"><entry/></row><row conref="forecast-response-full.dita#forecast-response-full/geoobject-name"><entry/></row><row conref="forecast-response-full.dita#forecast-response-full/geoobject-locality"><entry/></row><row conref="forecast-response-full.dita#forecast-response-full/geoobject-province"><entry/></row><row conref="forecast-response-full.dita#forecast-response-full/geoobject-country"><entry/></row></tbody></tgroup></table></section>-->
### Объект fact {#fact}

{% include [forecast-response-full-fact-text](../_includes/concepts/forecast-response-full/id-forecast-response-full/fact-text-ac8584362fd7.md) %}

#|
|| **Поле** | **Описание** | **Формат** ||
|| `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` — пасмурно.
- `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» — западное.
- «c» — штиль. | Строка ||
|| `pressure_mm` | Давление (в мм рт. ст.). | Число ||
|| `pressure_pa` | Давление (в гектопаскалях). | Число ||
|| `humidity` | Влажность воздуха (в процентах). | Число ||
|| `daytime` | Светлое или темное время суток. Возможные значения:
- «d» — светлое время суток.
- «n» — темное время суток. | Строка ||
|| `polar` | Признак того, что время суток, указанное в поле `daytime`,
 является полярным. | Логический ||
|| `season` | Время года в данном населенном пункте. Возможные значения:
- «summer» — лето.
- «autumn» — осень.
- «winter» — зима.
- «spring» — весна. | Строка ||
|| `obs_time` | Время замера погодных данных в формате Unixtime. | Число ||
|| `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 — пасмурно. | Число ||
|#
<!--<row conref="forecast-response-full.dita#forecast-response-full/fact-temp-color"><entry/></row>-->
### Объект forecasts {#forecasts}

{% include [forecast-response-full-forecasts-text](../_includes/concepts/forecast-response-full/id-forecast-response-full/forecasts-text-1af29aebda93.md) %}

#|
|| **Поле** | **Описание** | **Формат** ||
|| `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](*night) — прогноз на ночь.
- morning — прогноз на утро.
- day — прогноз на день.
- evening — прогноз на вечер.
- [day_short](*day_short) — 12-часовой прогноз на день.
- night_short — прогноз на ночь, для которого исключены поля `temp_min` и `temp_max`, в поле `temp` указывается минимальная температура за ночной период.

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

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

{% note info %}

В последнем возвращаемом дне прогноза состав частей может быть неполным.

{% endnote %} | Объект ||
|| `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` — пасмурно.
- `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» — западное.
- «c» — штиль. | Строка ||
|| `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](*temp)
- [temp_min](*temp_min)
- [feels_like](*feels_like)
- [icon](*icon)
- [condition](*condition)
- [wind_speed](*wind_speed)
- [wind_gust](*wind_gust)
- [wind_dir](*wind_dir)
- [pressure_mm](*pressure_mm)
- [pressure_pa](*pressure_pa)
- [humidity](*humidity)
- [prec_type](*prec_type)
- [prec_strength](*prec_strength)
- [cloudness](*cloudness) | Объект ||
|| `temp` | Максимальная дневная или минимальная ночная температура (°C). | Число ||
|| `hours` | Объект почасового прогноза погоды. Содержит 96 частей (часов), после возвращается пустая строка. Каждая часть имеет следующие поля:
- [hour](*hour)
- [hour_ts](*hour_ts)
- [temp](*temp_2)
- [feels_like](*feels_like)
- [icon](*icon)
- [condition](*condition)
- [wind_speed](*wind_speed)
- [wind_gust](*wind_gust)
- [wind_dir](*wind_dir)
- [pressure_mm](*pressure_mm)
- [pressure_pa](*pressure_pa)
- [humidity](*humidity)
- [prec_mm](*prec_mm)
- [prec_period](*prec_period)
- [prec_type](*prec_type)
- [prec_strength](*prec_strength)
- [is_thunder](*is_thunder)
- [cloudness](*cloudness) | Объект ||
|| `hour` | Значение часа, для которого дается прогноз (0-23), локальное время. | Строка ||
|| `hour_ts` | Время прогноза в Unixtime. | Число ||
|#

## Пример {#req-example}

Запрос:

```
GET https://api.weather.yandex.ru/v1/forecast?lat=55.75396&lon=37.620393&extra=true

X-Yandex-Weather-Key: 4pa...3
```

Ответ:

```
{
  "[now](*now)": 1470220206,
  "[now_dt](*now_dt)": "2016-08-03T10:30:06.238Z",
  "info": {
    "[lat](*lat_2)": 55.833333,
    "[lon](*lon_2)": 37.616667,
    "[tzinfo](*tzinfo)": {
      "[offset](*offset)": 10800,
      "[name](*name)": "Europe/Moscow",
      "[abbr](*abbr)": "MSK",
      "[dst](*dst)": false
    },
    "[def_pressure_mm](*def_pressure_mm)": 746,
    "[def_pressure_pa](*def_pressure_pa)": 994,
    "[url](*url)": "https://yandex.ru/pogoda/moscow"
  },
  "fact": {
    "[temp](*temp)": 20,
    "[feels_like](*feels_like)": 21,
    "[icon](*icon)": "ovc",
    "[condition](*condition)": "overcast",
    "[wind_speed](*wind_speed)": 2,
    "[wind_gust](*wind_gust)": 5.9,
    "[wind_dir](*wind_dir)": "n",
    "[pressure_mm](*pressure_mm)": 745,
    "[pressure_pa](*pressure_pa)": 994,
    "[humidity](*humidity)": 83,
    "[daytime](*daytime)": "d",
    "[polar](*polar)": false,
    "[season](*season)": "summer",
    "[prec_type](*prec_type)": 1,
    "[prec_strength](*prec_strength)": 0.25,
    "[cloudness](*cloudness)": 1,
    "[obs_time](*obs_time)": 1470214800
  },
  "forecasts": [
    {
      "[date](*date)": "2016-08-03",
      "[date_ts](*date_ts)": 1470171600,
      "[week](*week)": 32,
      "[sunrise](*sunrise)": "04:38",
      "[sunset](*sunset)": "20:31",
      "[moon_code](*moon_code)": 8,
      "[moon_text](*moon_text)": "new-moon",
      "[parts](*parts)": {
        "[night](*night)": {
          "[temp_min](*temp_min)": 20,
          "[temp_max](*temp_max)": 21,
          "[temp_avg](*temp_avg)": 21,
          "[feels_like](*feels_like)": 23,
          "[icon](*icon)": "bkn_n",
          "[condition](*condition)": "cloudy",
          "[daytime](*daytime)": "n",
          "[polar](*polar)": false,
          "[wind_speed](*wind_speed)": 0.9,
          "[wind_gust](*wind_gust)": 4,
          "[wind_dir](*wind_dir)": "nw",
          "[pressure_mm](*pressure_mm)": 746,
          "[pressure_pa](*pressure_pa)": 995,
          "[humidity](*humidity)": 81,
          "[prec_mm](*prec_mm)": 0,
          "[prec_period](*prec_period)": 360,
          "[prec_type](*prec_type)": 1,
          "[prec_strength](*prec_strength)": 0.5,
          "[cloudness](*cloudness)": 0.75,
          "[biomet](*biomet)": {
            "index": 0,
            "condition": "magnetic-field_0"
          }
        },
        ...
        "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,
          "biomet": {
            "index": 0,
            "condition": "magnetic-field_0"
          }
        },
        "[day_short](*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,
          "biomet": {
            "index": 0,
            "condition": "magnetic-field_0"
          }
        },
        "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,
          "biomet": {
            "index": 0,
            "condition": "magnetic-field_0"
          }
        }
      },
      "[hours](*hours_2)": [
        {
          "[hour](*hour)": "0",
          "[hour_ts](*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
        },
        ...
        {
          "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
        }
      ]
    },
    ...
    {
      "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": [...]
    }
  ]
}
```

[*offset]:

**Описание**

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

**Формат**

Число

[*name]:

**Описание**

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

**Формат**

Строка

[*abbr]:

**Описание**

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

**Формат**

Строка

[*dst]:

**Описание**

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

**Формат**

Логический

[*temp_min]:

**Описание**

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

**Формат**

Число

[*temp_max]:

**Описание**

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

**Формат**

Число

[*temp_avg]:

**Описание**

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

**Формат**

Число

[*feels_like]:

**Описание**

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

**Формат**

Число

[*icon]:

**Описание**

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

**Формат**

Строка

[*polar]:

**Описание**

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

**Формат**

Логический

[*wind_speed]:

**Описание**

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

**Формат**

Число

[*wind_gust]:

**Описание**

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

**Формат**

Число

[*pressure_mm]:

**Описание**

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

**Формат**

Число

[*pressure_pa]:

**Описание**

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

**Формат**

Число

[*humidity]:

**Описание**

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

**Формат**

Число

[*prec_mm]:

**Описание**

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

**Формат**

Число

[*prec_period]:

**Описание**

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

**Формат**

Число

[*temp]:

**Описание**

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

**Формат**

Число

[*temp_min]:

**Описание**

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

**Формат**

Число

[*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 — пасмурно.

**Формат**

Число

[*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» — темное время суток.

**Формат**

Строка

[*wind_dir]:

**Описание**

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

**Формат**

Строка

[*is_thunder]:

**Описание**

Признак грозы. Возможные значения:
- `true` — гроза.
- `false` — нет грозы.

**Формат**

Логический

[*night]:

**Описание**

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

- [temp_min](*temp_min)
- [temp_max](*temp_max)
- [temp_avg](*temp_avg)
- [biomet](*biomet)
- [feels_like](*feels_like)
- [icon](*icon)
- [condition](*condition)
- [daytime](*daytime)
- [polar](*polar)
- [wind_speed](*wind_speed)
- [wind_gust](*wind_gust)
- [wind_dir](*wind_dir)
- [pressure_mm](*pressure_mm)
- [pressure_pa](*pressure_pa)
- [humidity](*humidity)
- [prec_mm](*prec_mm)
- [prec_period](*prec_period)
- [prec_type](*prec_type)
- [prec_strength](*prec_strength)
- [cloudness](*cloudness)

{% note alert %}

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

{% endnote %}

**Формат**

Объект

[*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`

**Формат**

Объект

[*limit]:

Количество дней в прогнозе, включая текущий.

Для тарифа «[Тестовый](https://yandex.ru/dev/weather/doc/dg/concepts/pricing.html#about__test)» максимально допустимое значение — 7.

[*hours]:

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

- «true» — значение по умолчанию, почасовой прогноз возвращается.
- «false» — почасовой прогноз не возвращается.

[*extra]:

Расширенная информация об осадках. Допустимые значения:

- «true» — расширенная информация об осадках возвращается.
- «false» — значение по умолчанию, расширенная информация об осадках не возвращается.

[*X_Yandex_Weather_Key]:

Ключ, полученный на этапе [подключения к API Яндекс Погоды](https://yandex.com/dev/weather/doc/ru/concepts/api.md).

[*lat]:

Широта в градусах. Обязательное поле.

[*lon]:

Долгота в градусах. Обязательное поле.

[*lat_2]:

**Описание**

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

**Формат**

Число

[*lon_2]:

**Описание**

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

**Формат**

Число

[*lang]:

Сочетания языка и страны, для которых будут возвращены данные погодных формулировок. Допустимые значения:

- «ru_RU» — русский язык для домена России.
- «be_BY» — белорусский язык для домена Беларуси.
- «kk_KZ» — казахский язык для домена Казахстана.
- «tr_TR» — турецкий язык для домена Турции.
- «en_US» — международный английский.

[*hour]:

**Описание**

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

**Формат**

Строка

[*hour_ts]:

**Описание**

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

**Формат**

Число

[*temp_2]:

**Описание**

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

**Формат**

Число

[*biomet]:

**Описание**

Планетарный Kp-индекс. Возможные значения в диапазоне <code>[0, 9]</code>. Рассчитывается как максимум в интервале суток или в интервале части дня.

**Формат**

Объект

[*now]:

**Описание**

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

**Формат**

Число

[*now_dt]:

**Описание**

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

**Формат**

Строка

[*tzinfo]:

**Описание**

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

**Формат**

Объект

[*def_pressure_mm]:

**Описание**

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

**Формат**

Число

[*def_pressure_pa]:

**Описание**

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

**Формат**

Число

[*url]:

**Описание**

Страница населенного пункта на сайте [Яндекс Погода](https://yandex.ru/pogoda/ru-RU?lat=53.338921&lon=83.691269).

**Формат**

Строка

[*season]:

**Описание**

Время года в данном населенном пункте. Возможные значения:
- «summer» — лето.
- «autumn» — осень.
- «winter» — зима.
- «spring» — весна.

**Формат**

Строка

[*obs_time]:

**Описание**

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

**Формат**

Число

[*phenom_icon]:

**Описание**

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

**Формат**

Строка

[*phenom-condition]:

**Описание**

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

**Формат**

Строка

[*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-часовые прогнозы имеют одинаковый набор полей.

{% note info %}

В последнем возвращаемом дне прогноза состав частей может быть неполным.

{% endnote %}

**Формат**

Объект

[*hours_2]:

**Описание**

Объект почасового прогноза погоды. Содержит 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`

**Формат**

Объект