--- metadata: - name: generator content: Diplodoc Platform v5.56.0 alternate: - https://yandex.com/dev/weather/doc/en/concepts/releases.md - https://yandex.com/dev/weather/doc/ru/concepts/releases.md - href: ru/concepts/releases.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 # История изменений API Текущие актуальные версии API Яндекс Погоды — 2 и 3. **Адрес для отправки запросов к версии 2:** `https://api.weather.yandex.ru/v2` **Адрес для отправки запросов к версии 3:** `https://api.weather.yandex.ru/graphql/query` #### Ноябрь 2019 года Новая версия API (v2). Изменены возможные значения в полях ответа: - [fact.condition](https://yandex.com/dev/weather/doc/ru/concepts/forecast-info.md#fact) и [forecast.condition](https://yandex.com/dev/weather/doc/ru/concepts/forecast-info.md#forecasts) для тарифа «Погода на вашем сайте» и «Тестовый». - [forecast.moon_text](https://yandex.com/dev/weather/doc/ru/concepts/forecast-info.md#forecasts) для тарифа «Погода на вашем сайте» и «Тестовый». - [fact.prec_type](https://yandex.com/dev/weather/doc/ru/concepts/forecast-rest.md#fact) и [forecast.prec_type](https://yandex.com/dev/weather/doc/ru/concepts/forecast-rest.md#forecast) для тарифа «Тестовый». Добавлено новое поле [fact.is_thunder](https://yandex.com/dev/weather/doc/ru/concepts/forecast-rest.md#fact) для тарифа «Тестовый». #### Февраль 2024 года Новая версия API (v3). Полностью переработан протокол взаимодействия и заменен с REST на GraphQL. Добавлены: * Новые параметры (полный список параметров доступен по [ссылке](https://yandex.com/dev/weather/doc/ru/concepts/parameters.md)): * [aqi](*aqi), [iaqi](*iaqi), [dominant](*dominant) (индексы качества воздуха); * [co](*co), [density](*density), [no2](*no2), [o3](*o3), [pm10](*pm10), [pm2p5](*pm2p5), [so2](*so2) (концентрации веществ в атмосфере); * [dewPoint](*dewPoint), [leafWetnessIndex](*leafWetnessIndex) (параметры точки росы); * [dustStormStrength](*dustStormStrength) (риск возникновения пылевой бури); * [imfBt](*imfBt), [imfBx](*imfBx), [imfBy](*imfBy), [imfBz](*imfBz) (характеристики межпланетного магнитного поля); * [oceanTide](*oceanTide), [seaCurrentAngle](*seaCurrentAngle), [seaCurrentSpeed](*seaCurrentSpeed), [waveHeight](*waveHeight), [wavePeriod](*wavePeriod) (океанические и морские параметры); * [solarIrradiation](*solarIrradiation), [solarWindDensity](*solarWindDensity), [solarWindSpeed](*solarWindSpeed) (характеристики солнечной радиации и ветра); * [cloudinessOnHeight](*cloudinessOnHeight), [temperatureOnHeight](*temperatureOnHeight), [windAngleOnHeight](*windAngleOnHeight), [windSpeedOnHeight](*windSpeedOnHeight) (параметры на различных высотах); * [referenceEvapotranspiration](*referenceEvapotranspiration) (поток испаряемой влаги); * [Сырые данные метеорологических станций](https://yandex.com/dev/weather/doc/ru/concepts/stations.md) и [архив показаний с них](https://yandex.com/dev/weather/doc/ru/concepts/stations.md#station-by-period); * Исторические данные прогнозов на неделю в прошлое; [Актуальная документация](https://yandex.com/dev/weather/doc/ru/concepts/index-v3.md) [*aqi]: Индекс качества воздуха (AQI). **Возможные значения:** `[0, 500]` [*iaqi]: Индивидуальный AQI для определенного загрязнителя. Подробнее см. здесь: www.airnow.gov/aqi/aqi-basics/ Можно запросить несколько значений этого поля, используя следующий синтаксис: `coIAQI: iaqi(pollutant: CO)` **Возможные значения:** `[0, 500]` [*dominant]: Загрязнитель, доля которого является наибольшей при вычислении AQI. Можно считать, что `aqi` является IAQI этого загрязнителя. Подробнее см. здесь: www.airnow.gov/aqi/aqi-basics/ **Возможные значения:** [Pollutant](https://yandex.com/dev/weather/doc/ru/concepts/spectaql.md#definition-Pollutant) [*co]: Угарный газ (CO) — это бесцветный, высокотоксичный, огнеопасный газ без запаха и вкуса, немного менее плотный, чем воздух. **Единицы измерения:** `µg⋅m⁻³` **Возможные значения:** `[0, +Infinity)` [*density]: Плотность воздуха в атмосфере — характеристика атмосферы Земли (масса, деленная на объем). **Единицы измерения:** `kg⋅m⁻³` **Возможные значения:** `[0, +Infinity)` [*no2]: Основными источниками антропогенных выбросов NO2 являются процессы сгорания (отопление, производство электроэнергии и работа двигателей внутреннего сгорания наземных и водных транспортных средств). Подробнее см. здесь: www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health **Единицы измерения:** `µg⋅m⁻³` **Возможные значения:** `[0, +Infinity)` [*o3]: Приземный озон (O3), также называемый приповерхностным озоном и тропосферным озоном, представляет собой следовой газ в тропосфере. Подробнее см. здесь: www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health **Единицы измерения:** `µg⋅m⁻³` **Возможные значения:** `[0, +Infinity)` [*pm10]: Частицы PM2.5 — твердые микрочастицы диаметром 2,5 мкм (микрона) и менее, содержащиеся в воздухе. Подробнее см. здесь: www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health **Единицы измерения:** `µg⋅m⁻³` **Возможные значения:** `[0, +Infinity)` [*pm2p5]: Частицы PM10 — взвешенные крупные твердые частицы диаметром 10 мкм (микрон) и менее, содержащиеся в воздухе. Подробнее см. здесь: www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health **Единицы измерения:** `µg⋅m⁻³` **Возможные значения:** `[0, +Infinity)` [*so2]: SO2 — это бесцветный газ с едким запахом, который образуется в результате сгорания горючих полезных ископаемых и плавления минеральной руды, содержащей серу. Подробнее см. здесь: www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health **Единицы измерения:** `µg⋅m⁻³` **Возможные значения:** `[0, +Infinity)` [*dewPoint]: Значение точки росы в тени на высоте двух метров над земной поверхностью. **Возможные значения:** [TemperatureUnit](https://yandex.com/dev/weather/doc/ru/concepts/spectaql.md#definition-TemperatureUnit) [*leafWetnessIndex]: Обозначает наличие влаги на листьях (`true`) или ее отсутствие (`false`). Это значение рассчитывается на основе таких факторов, как выпадение осадков, температура воздуха, температура поверхности земли и точка росы. **Возможные значения:** [Boolean](https://yandex.com/dev/weather/doc/ru/concepts/spectaql.md#definition-Boolean) [*dustStormStrength]: Сила пыльной бури. Вычисляется исходя из скорости ветра и количества пылевых частиц в атмосфере. **Возможные значения:** [DustStormStrength](https://yandex.com/dev/weather/doc/ru/concepts/spectaql.md#definition-DustStormStrength) [*imfBt]: Межпланетное магнитное поле в нТл. Bt — общая мощность межпланетного магнитного поля. Подробнее: www.spaceweatherlive.com/en/help/the-interplanetary-magnetic-field-imf.html **Возможные значения:** [Float](https://yandex.com/dev/weather/doc/ru/concepts/spectaql.md#definition-Float) [*imfBx]: Межпланетное магнитное поле в нТл. Ось Bx. Подробнее: www.spaceweatherlive.com/en/help/the-interplanetary-magnetic-field-imf.html **Возможные значения:** [Float](https://yandex.com/dev/weather/doc/ru/concepts/spectaql.md#definition-Float) [*imfBy]: Межпланетное магнитное поле в нТл. Ось By. Подробнее: www.spaceweatherlive.com/en/help/the-interplanetary-magnetic-field-imf.html **Возможные значения:** [Float](https://yandex.com/dev/weather/doc/ru/concepts/spectaql.md#definition-Float) [*imfBz]: Межпланетное магнитное поле в нТл. Ось Bz. Подробнее: www.spaceweatherlive.com/en/help/the-interplanetary-magnetic-field-imf.html **Возможные значения:** [Float](https://yandex.com/dev/weather/doc/ru/concepts/spectaql.md#definition-Float) [*oceanTide]: Высота уровня океана относительно указанной величины в сантиметрах. **Единицы измерения:** `cm` **Возможные значения:** `(-Infinity, +Infinity)` [*seaCurrentAngle]: Начальный угол морского течения. **Единицы измерения:** `degrees` **Возможные значения:** `[0, 360)` [*seaCurrentSpeed]: Скорость морского течения. **Единицы измерения:** `cm/s` **Возможные значения:** `[0, +Infinity)` [*waveHeight]: Характерная высота сочетания ветровых волн и поверхности наката. **Единицы измерения:** `m` **Возможные значения:** `[0, +Infinity)` [*wavePeriod]: Средний период основной волны. **Единицы измерения:** `s` **Возможные значения:** `[0, +Infinity)` [*solarIrradiation]: Среднее значение прямого солнечного излучения на горизонтальной плоскости — en.wikipedia.org/wiki/Solar_irradiance **Единицы измерения:** `W⋅m⁻²` **Возможные значения:** `[0, +Infinity)` [*solarWindDensity]: Плотность солнечного ветра в p/см3 (количество частиц на кубический сантиметр). Подробнее: www.swpc.noaa.gov/phenomena/solar-wind **Возможные значения:** [Float](https://yandex.com/dev/weather/doc/ru/concepts/spectaql.md#definition-Float) [*solarWindSpeed]: Скорость солнечного ветра в км/с. Подробнее: www.swpc.noaa.gov/phenomena/solar-wind **Возможные значения:** [Float](https://yandex.com/dev/weather/doc/ru/concepts/spectaql.md#definition-Float) [*referenceEvapotranspiration]: Суммарный поток испаряемой влаги за предыдущий час или три часа. **Единицы измерения:** `mm/h` **Возможные значения:** `[0, +Infinity)` [*cloudinessOnHeight]: Облачный покров [%] в ближайшем к данной высоте (в метрах) над поверхностью земли. Используйте `height: 0`, если вам нужно общее покрытие облаками. **Возможные значения:** [CloudinessWithHeight](https://yandex.com/dev/weather/doc/ru/concepts/spectaql.md#definition-CloudinessWithHeight) [*temperatureOnHeight]: Значение температуры в ближайшей к данной высоте (в метрах) над поверхностью земли. **Возможные значения:** [TemperatureUnit](https://yandex.com/dev/weather/doc/ru/concepts/spectaql.md#definition-TemperatureUnit) [*windAngleOnHeight]: Угол направления ветра в градусах в ближайшей к данной высоте (в метрах) над поверхностью земли. **Возможные значения:** [WindAngleWithHeight](https://yandex.com/dev/weather/doc/ru/concepts/spectaql.md#definition-WindAngleWithHeight) [*windSpeedOnHeight]: Скорость ветра в ближайшей к данной высоте (в метрах) над поверхностью земли. **Возможные значения:** [WindSpeedUnit](https://yandex.com/dev/weather/doc/ru/concepts/spectaql.md#definition-WindSpeedUnit)