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