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

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

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

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

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

X-Yandex-API-Key: <значение ключа>

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

X-Yandex-API-Key

Ключ, полученный на этапе подключения к API Яндекс Погоды.

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

lat

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

lon

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

lang

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

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

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

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

Поле

Описание

Формат

now

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

Число

now_dt

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

Строка

info

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

Объект

fact

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

Объект

forecast

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

Объект

Объект info

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

Поле

Описание

Формат

lat

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

Число

lon

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

Число

url

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

Строка

Объект fact

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

Поле

Описание

Формат

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.

Число

Объект forecast

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

Поле

Описание

Формат

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
  • 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_prob

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

Ответ содержит прогноз на 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/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

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

Число

Пример

Запрос:

GET https://api.weather.yandex.ru/v2/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": "moon-code-1",
    "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",
        ...
      },
      {...}
    ]
  }
}