History of changes to the API
The current version of the Yandex Weather API is v2 and v3.
Address for sending requests to v2:
https://api.weather.yandex.ru/v2
Address for sending requests to v3:
https://api.weather.yandex.ru/graphql/query
November 2019
New API version (v2).
Possible values changed for the following response fields:
- fact.condition and forecast.condition for the “Yandex Weather on your site” and “Test” rates.
- forecast.moon_text for the “Yandex Weather on your site” and “Test” rates.
- fact.prec_type and forecast.prec_type for the “Test” rate.
February 2024
New API version (v3).
The interaction protocol has been completely redesigned and replaced from REST to Graphql.
Added:
- New parameters (full list of parameters is available by link):
- aqi, iaqi, dominant (Air quality indices);
- co, density, no2, o3, pm10, pm2p5, so2 (concentration of pollutants in the atmosphere);
- dewPoint, leafWetnessIndex (parameters of the dew point);
- dustStormStrength (risk of dust storm);
- imfBt, imfBx, imfBy, imfBz (characteristics of the interplanetary magnetic field);
- oceanTide, seaCurrentAngle, seaCurrentSpeed, waveHeight, wavePeriod (ocean and sea parameters);
- solarIrradiation, solarWindDensity, solarWindSpeed (characteristics of solar radiation and wind);
- cloudinessOnHeight, temperatureOnHeight, windAngleOnHeight, windSpeedOnHeight (parameters at various heights);
- referenceEvapotranspiration (evaporated moisture);
- Raw observations of meteorological stations and archive;
- Historical data of forecasts for the week into the past;
Air quality index (AQI).
See more here www.airnow.gov/aqi/aqi-basics/
Possible values: [0, 500]
The individual AQI for a specific pollutant.
See more here www.airnow.gov/aqi/aqi-basics/
You can request multiple values of this field, using following syntax:
coIAQI: iaqi(pollutant: CO)
Possible values: [0, 500]
The pollutant that makes the greatest contribution to the calculation of AQI.
You can assume that aqi is the IAQI of this pollutant.
See more here www.airnow.gov/aqi/aqi-basics/
Possible values: Pollutant
Carbon monoxide (CO) is a colorless, highly poisonous, odorless,
tasteless, flammable gas that is slightly less dense than air.
See more here www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health
Units: µg⋅m⁻³
Possible values: [0, +Infinity)
The density of air or atmospheric density,
is the mass per unit volume of Earth's atmosphere.
Units: kg⋅m⁻³
Possible values: [0, +Infinity)
The major sources of anthropogenic emissions of NO2 are
combustion processes (heating, power generation, and engines in vehicles and ships).
See more here www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health
Units: µg⋅m⁻³
Possible values: [0, +Infinity)
Ground-level ozone (O3), also known as surface-level ozone and
tropospheric ozone, is a trace gas in the troposphere.
See more here www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health
Units: µg⋅m⁻³
Possible values: [0, +Infinity)
PM10 is a suspended large solid particles,
with a diameter of 10 micrometers (microns) or less.
See more here www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health
Units: µg⋅m⁻³
Possible values: [0, +Infinity)
PM2.5 is a fine particulate matter,
with a diameter of 2.5 micrometers (microns) or less.
See more here www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health
Units: µg⋅m⁻³
Possible values: [0, +Infinity)
SO2 is a colorless gas with a pungent odor,
which is formed during the burning of fossil fuels
and the melting of mineral ores containing sulfur.
See more here www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health
Units: µg⋅m⁻³
Possible values: [0, +Infinity)
The dew point value in the shade
at a height of 2 meters from the ground surface.
Possible values: TemperatureUnit
Indicates whether there is moisture on leaves (true) or not (false).
This value is calculated based on factors such as precipitation,
air temperature, surface temperature, and dew point.
Possible values: Boolean
Strength of a duststorm. Based on wind speed and
amount of dust particles in the atmosphere.
Possible values: DustStormStrength
Interplanetary Magnetic Field in nT. Bt - the total strength of the IMF. More information: www.spaceweatherlive.com/en/help/the-interplanetary-magnetic-field-imf.html
Possible values: Float
Interplanetary Magnetic Field in nT. Bx axis. More information: www.spaceweatherlive.com/en/help/the-interplanetary-magnetic-field-imf.html
Possible values: Float
Interplanetary Magnetic Field in nT. By axis. More information: www.spaceweatherlive.com/en/help/the-interplanetary-magnetic-field-imf.html
Possible values: Float
Interplanetary Magnetic Field in nT. Bz axis. More information: www.spaceweatherlive.com/en/help/the-interplanetary-magnetic-field-imf.html
Possible values: Float
The height of the ocean water level relative to the specified datum in centimeters.
Units: cm
Possible values: (-Infinity, +Infinity)
Sea current angle from.
Units: degrees
Possible values: [0, 360)
Sea current speed.
Units: cm/s
Possible values: [0, +Infinity)
Significant height of combined wind waves and swell surface.
Units: m
Possible values: [0, +Infinity)
Primary wave mean period surface.
Units: s
Possible values: [0, +Infinity)
Average direct solar irradiation on the horizontal plane
en.wikipedia.org/wiki/Solar_irradiance
Possible values: SolarIrradiationUnit
Solar wind density in p/cm3. More information: www.swpc.noaa.gov/phenomena/solar-wind
Possible values: Float
Solar wind speed in km/sec. More information: www.swpc.noaa.gov/phenomena/solar-wind
Possible values: Float
Preceding 1h or 3h evaporative water flux sum.
Units: mm/h
Possible values: [0, +Infinity)
Cloud cover [%] at the closest to the given height (in meters). Use height: 0 if you need total cloud cover.
Possible values: CloudinessWithHeight
The temperature value in the closest to this height (in meters) above the surface of the earth.
Possible values: TemperatureUnit
The angle of the wind direction in degrees in the closest to this height (in meters) above the surface of the earth.
Possible values: WindAngleWithHeight
The speed of wind in this height (in meters) above the surface of the earth.
Possible values: WindSpeedUnit