---
metadata:
  - name: generator
    content: Diplodoc Platform v5.56.0
alternate:
  - https://yandex.com/dev/weather/doc/en/concepts/forecast-info.md
  - https://yandex.com/dev/weather/doc/ru/concepts/forecast-info.md
  - href: ru/concepts/forecast-info.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/weather/doc/ru/llms.txt

# Тариф «Погода на вашем сайте»

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

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

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

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

```
GET https://api.weather.yandex.ru/v2/informers?
 [lat](*lat)=<широта>
 & [lon](*lon)=<долгота>
 & [[lang](*lang)=<язык ответа>]

[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» — международный английский.

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

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

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

<!-- source: ru/_includes/concepts/forecast-response-full/id-forecast-response-full/info-text.md -->
Объект содержит информацию о населенном пункте.
<!-- endsource: ru/_includes/concepts/forecast-response-full/id-forecast-response-full/info-text.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>-->
<!--<row conref="forecast-response-full.dita#forecast-response-full/info-tzinfo"><entry/></row>-->
<!--<row conref="forecast-response-full.dita#forecast-response-full/info-offset"><entry/></row>-->
<!--<row conref="forecast-response-full.dita#forecast-response-full/info-name"><entry/></row>-->
<!--<row conref="forecast-response-full.dita#forecast-response-full/info-abbr"><entry/></row>-->
<!--<row conref="forecast-response-full.dita#forecast-response-full/info-dst"><entry/></row>-->
<!--<row conref="forecast-response-full.dita#forecast-response-full/info-def-pressure-mm"><entry/></row>-->
<!--<row conref="forecast-response-full.dita#forecast-response-full/info-def-pressure-pa"><entry/></row>-->
|| `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" id="table_zqs_gzk_zcb"><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}

<!-- source: ru/_includes/concepts/forecast-response-full/id-forecast-response-full/fact-text.md -->
Объект содержит информацию о погоде на данный момент.
<!-- endsource: ru/_includes/concepts/forecast-response-full/id-forecast-response-full/fact-text.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` — пасмурно.
- `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. | Число ||
|#
<!--<row conref="forecast-response-full.dita#forecast-response-full/fact-prec-type"><entry/></row>-->
<!--<row conref="forecast-response-full.dita#forecast-response-full/fact-prec-strength"><entry/></row>-->
<!--<row conref="forecast-response-full.dita#forecast-response-full/fact-cloudness"><entry/></row>-->
<!--<row conref="forecast-response-full.dita#forecast-response-full/fact-temp-color"><entry/></row>-->
### Объект forecast {#forecasts}

<!-- source: ru/_includes/concepts/forecast-response-full/id-forecast-response-full/forecasts-text.md -->
Объект содержит данные прогноза погоды.
<!-- endsource: ru/_includes/concepts/forecast-response-full/id-forecast-response-full/forecasts-text.md -->

#|
|| **Поле** | **Описание** | **Формат** ||
|| `date` | Дата прогноза в формате ГГГГ-ММ-ДД. | Строка ||
|| `date_ts` | Дата прогноза в формате Unixtime. | Число ||
|| `week` | Порядковый номер недели. | Число ||
|| `sunrise` | Время окончания восхода Солнца, локальное время (может отсутствовать для полярных регионов). | Строка ||
|| `sunset` | Время начала заката Солнца, локальное время (может отсутствовать для полярных регионов). | Строка ||
|| `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` | Прогнозы по времени суток. Содержит следующие поля:
- [part_name](*part_name)
- [temp_min](*temp_min)
- [temp_max](*temp_max)
- [temp_avg](*temp_avg)
- [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_prob](*prec_prob)

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

Ответ содержит прогноз на 2 ближайших периода.<!--<note>В последнем возвращаемом дне прогноза состав частей может быть неполным.</note>--> | Объект ||
|| `part_name` | Название времени суток. Возможные значения:
- `night` — ночь.
- `morning` — утро.
- `day` — день.
- `evening` — вечер. | Строка ||
<!--<row conref="forecast-response-full.dita#forecast-response-full/forecasts-night"><entry/></row>-->
|| `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` | Влажность воздуха (в процентах). | Число ||
|| `prec_mm` | Прогнозируемое количество осадков (в мм). | Число ||
|| `prec_period` | Прогнозируемый период осадков (в минутах). | Число ||
|| `prec_prob` | Вероятность выпадения осадков. | Число ||
|#
<!--<row conref="forecast-response-full.dita#forecast-response-full/forecast-prec-type"><entry/></row>-->
<!--<row conref="forecast-response-full.dita#forecast-response-full/forecast-prec-strength"><entry/></row>-->
<!--<row conref="forecast-response-full.dita#forecast-response-full/forecast-cloudness"><entry/></row>-->
<!--<row conref="forecast-response-full.dita#forecast-response-full/forecasts-dayshort-temp"><entry/></row>-->

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

Запрос:

```
GET https://api.weather.yandex.ru/v2/informers?lat=55.75396&lon=37.620393

X-Yandex-Weather-Key: 3fc...7
```

Ответ:

```
{
  "[now](*now)": 1470220206,
  "[now_dt](*now_dt)": "2016-08-03T10:30:06.238Z",
  "info": {
    "[lat](*lat_2)": 55.833333,
    "[lon](*lon_2)": 37.616667,
    "[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",
    "[obs_time](*obs_time)": 1470214800
  },
  "forecast": {
    "[date](*date)": "2016-08-03",
    "[date_ts](*date_ts)": 1522702800,
    "[week](*week)": 15,
    "[sunrise](*sunrise)": "04:38",
    "[sunset](*sunset)": "20:31",
    "[moon_code](*moon_code)": 1,
    "[moon_text](*moon_text)": "moon-code-1",
    "parts": [
      {
        "[part_name](*part_name)": "day",
        "[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_prob](*prec_prob)": 0
      },
      {
        "part_name": "evening",
        ...
      },
      {...}
    ]
  }
}
```
<!--<concept id="resp-example"><title>Пример ответа</title><conbody><section id="section_ym4_1zk_zcb"><p>Ниже приведен пример ответа на запрос прогноза погоды: </p></section></conbody></concept>-->

[*prec_prob]: **Описание**
 
Вероятность выпадения осадков.
 
**Формат**
 
Число

[*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]: **Описание**
 
Прогнозируемый период осадков (в минутах).
 
**Формат**
 
Число

[*part_name]: **Описание**
 
Название времени суток. Возможные значения:
- `night` — ночь.
- `morning` — утро.
- `day` — день.
- `evening` — вечер.
 
**Формат**
 
Строка

[*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» — штиль.
 
**Формат**
 
Строка

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

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

[*lat_2]: **Описание**
 
Широта (в градусах).
 
**Формат**
 
Число

[*lon_2]: **Описание**
 
Долгота (в градусах).
 
**Формат**
 
Число

[*lang]: Сочетания языка и страны, для которых будут возвращены данные погодных формулировок. Допустимые значения:
 
- «ru_RU» — русский язык для домена России.
- «be_BY» — белорусский язык для домена Беларуси.
- «kk_KZ» — казахский язык для домена Казахстана.
- «tr_TR» — турецкий язык для домена Турции.
- «en_US» — международный английский.

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

[*now]: **Описание**
 
Время сервера в формате Unixtime.
 
**Формат**
 
Число

[*now_dt]: **Описание**
 
Время сервера в UTC.
 
**Формат**
 
Строка

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

[*temp]: **Описание**
 
Температура (°C).
 
**Формат**
 
Число

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

[*obs_time]: **Описание**
 
Время замера погодных данных в формате Unixtime.
 
**Формат**
 
Число

[*date]: **Описание**
 
Дата прогноза в формате ГГГГ-ММ-ДД.
 
**Формат**
 
Строка

[*date_ts]: **Описание**
 
Дата прогноза в формате Unixtime.
 
**Формат**
 
Число

[*week]: **Описание**
 
Порядковый номер недели.
 
**Формат**
 
Число

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

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

[*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 — растущая луна.
 
**Формат**
 
Строка