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

Внимание.

Данная версия API устарела. Используйте новую версию.

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

Формат запроса

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

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

X-Yandex-API-Key: <значение ключа>
Заголовки запроса:
X-Yandex-API-Key
Ключ, полученный на этапе подключения к API Яндекс.Погоды.

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

lat

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

lon

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

lang

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

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

Формат ответа

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

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

Объект info

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

Поле Описание Формат
lat Широта (в градусах). Число
lon Долгота (в градусах). Число
url Страница населенного пункта на сайте Яндекс.Погода. Строка
Поле Описание Формат
lat Широта (в градусах). Число
lon Долгота (в градусах). Число
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. Число
Поле Описание Формат
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. Число

Объект forecast

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

Поле Описание Формат
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 Прогнозы по времени суток. Содержит следующие поля:

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

Ответ содержит прогноз на 2 ближайших периода.

Объект
part_name Название времени суток. Возможные значения:
  • night — ночь.
  • morning — утро.
  • day — день.
  • evening — вечер.
Строка.
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_prob Вероятность выпадения осадков. Число
Поле Описание Формат
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 Прогнозы по времени суток. Содержит следующие поля:

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

Ответ содержит прогноз на 2 ближайших периода.

Объект
part_name Название времени суток. Возможные значения:
  • night — ночь.
  • morning — утро.
  • day — день.
  • evening — вечер.
Строка.
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_prob Вероятность выпадения осадков. Число

Пример

Запрос:

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

X-Yandex-API-Key: 3fc...7

Ответ:

{
  "now": 1470220206,
  "now_dt": "2016-08-03T10:30:06.238Z",
  "info": {
    "lat": 55.833333,
    "lon": 37.616667,
    "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",
    "obs_time": 1470214800
  },
  "forecast": {
    "date": "2016-08-03",
    "date_ts": 1522702800,
    "week": 15,
    "sunrise": "04:38",
    "sunset": "20:31",
    "moon_code": 1,
    "moon_text": "decreasing-moon",
    "parts": [
      {
        "part_name": "day",
        "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_prob": 0
      },
      {
        "part_name": "evening",
        ...
      },
      {...}
    ]
  }
}