---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.6
alternate:
  - https://yandex.com/dev/weather/doc/en/concepts/forecast-info-v1.md
  - https://yandex.com/dev/weather/doc/ru/concepts/forecast-info-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-info.md).

{% endnote %}

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

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

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

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

```
GET https://api.weather.yandex.ru/v1/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}

{% 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>-->
<!--<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}

{% 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. | Число ||
|#
<!--<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}

{% 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` | Прогнозы по времени суток. Содержит следующие поля:
- [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` — пасмурно.
- `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_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/v1/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)": "decreasing-moon",
    "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]: {% include [term-description](../_includes/terms/prec_prob-5e3034cc856f.md) %}

[*temp_min]: {% include [term-description](../_includes/terms/temp_min-d6b2b97a3461.md) %}

[*temp_max]: {% include [term-description](../_includes/terms/temp_max-cd6f45108fe2.md) %}

[*temp_avg]: {% include [term-description](../_includes/terms/temp_avg-129b27725d76.md) %}

[*feels_like]: {% include [term-description](../_includes/terms/feels_like-314d5e33fd43.md) %}

[*icon]: {% include [term-description](../_includes/terms/icon-549edc43c1b5.md) %}

[*polar]: {% include [term-description](../_includes/terms/polar-34740eb5c59f.md) %}

[*wind_speed]: {% include [term-description](../_includes/terms/wind_speed-82d1ad022e7f.md) %}

[*wind_gust]: {% include [term-description](../_includes/terms/wind_gust-163f629516dd.md) %}

[*pressure_mm]: {% include [term-description](../_includes/terms/pressure_mm-b4281ebfc266.md) %}

[*pressure_pa]: {% include [term-description](../_includes/terms/pressure_pa-a26f4a3717ef.md) %}

[*humidity]: {% include [term-description](../_includes/terms/humidity-ea8b0d267c17.md) %}

[*prec_mm]: {% include [term-description](../_includes/terms/prec_mm-42481d4256a7.md) %}

[*prec_period]: {% include [term-description](../_includes/terms/prec_period-bc98fe38586c.md) %}

[*part_name]: {% include [term-description](../_includes/terms/part_name-60774877e9f1.md) %}

[*condition]: {% include [term-description](../_includes/terms/condition-ef53c8313503.md) %}

[*daytime]: {% include [term-description](../_includes/terms/daytime-c5a5aed5da19.md) %}

[*wind_dir]: {% include [term-description](../_includes/terms/wind_dir-ae9a081d6540.md) %}

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

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

[*lat_2]: {% include [term-description](../_includes/terms/lat_2-5b76894fe733.md) %}

[*lon_2]: {% include [term-description](../_includes/terms/lon_2-2bd587136b5b.md) %}

[*lang]: {% include [term-description](../_includes/terms/lang-4b48c2e30bfa.md) %}

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

[*now]: {% include [term-description](../_includes/terms/now-f509392c4f5c.md) %}

[*now_dt]: {% include [term-description](../_includes/terms/now_dt-d6ffcb25eb73.md) %}

[*url]: {% include [term-description](../_includes/terms/url-20f131617935.md) %}

[*temp]: {% include [term-description](../_includes/terms/temp-6da32eb91a88.md) %}

[*season]: {% include [term-description](../_includes/terms/season-11d59dcc26e9.md) %}

[*obs_time]: {% include [term-description](../_includes/terms/obs_time-57f5b2d5a3f9.md) %}

[*date]: {% include [term-description](../_includes/terms/date-052e5c4dddd4.md) %}

[*date_ts]: {% include [term-description](../_includes/terms/date_ts-d6d0cf31eee6.md) %}

[*week]: {% include [term-description](../_includes/terms/week-4a8cdbfb3fee.md) %}

[*sunrise]: {% include [term-description](../_includes/terms/sunrise-5ea1d08d0177.md) %}

[*sunset]: {% include [term-description](../_includes/terms/sunset-5d9daac0bf91.md) %}

[*moon_code]: {% include [term-description](../_includes/terms/moon_code-0c4d3cf2405e.md) %}

[*moon_text]: {% include [term-description](../_includes/terms/moon_text-2aeea76975d1.md) %}