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

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

• Формат запроса
• Формат ответа
• Пример

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

Населенный пункт указывается при помощи значений широты (параметр lat) и долготы (параметр lon). Если данные параметры заданы некорректно, ответ будет содержать код ошибки 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

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

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

lat

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

lon

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

lang

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

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

limit

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

Для тарифа «Тестовый» максимально допустимое значение — 7.

hours

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

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

extra

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

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

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

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

Объект info

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

Объект fact

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

Объект forecasts

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

Пример

Запрос:

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)

Формат

Объект

[*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]:

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

Для тарифа «Тестовый» максимально допустимое значение — 7.

[*hours]:

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

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

[*extra]:

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

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

[*X_Yandex_Weather_Key]:

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

[*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-индекс. Возможные значения в диапазоне [0, 9]. Рассчитывается как максимум в интервале суток или в интервале части дня.

Формат

Объект

[*now]:

Описание

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

Формат

Число

[*now_dt]:

Описание

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

Формат

Строка

[*tzinfo]:

Описание

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

Формат

Объект

[*def_pressure_mm]:

Описание

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

Формат

Число

[*def_pressure_pa]:

Описание

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

Формат

Число

[*url]:

Описание

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

Формат

Строка

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

Формат

Объект

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

Формат

Объект