“Yandex Weather on your site” rate
Use this request to get the current weather and forecast for the specified locality.
Request format
The locality is indicated using the latitude (lat parameter) and longitude (lon parameter). If these parameters are set incorrectly, the response will contain a 404 error code.
GET https://api.weather.yandex.ru/v2/informers?
lat=<latitude>
& lon=<longitude>
& [lang=<response language>]
X-Yandex-API-Key: <key value>
Request headers:
X-Yandex-API-Key
The key you received when enabling the Yandex Weather API.
Request parameters:
lat
The latitude in degrees. Required field.
lon
The longitude in degrees. Required field.
lang
The combination of language and country that weather information will be returned for. Possible values:
- “ru_RU” — Russian for the Russia locale.
- “be_BY” — Belarusian for the Belarus locale.
- “kk_KZ” — Kazakh for the Kazakhstan locale.
- “tr_TR” — Turkish for the Turkey locale.
- “en_US” — International English.
Response format
The response to the request is returned in JSON format. The information in the response contains:
Field |
Description |
Format |
|
The time on the server in Unix time. |
Number |
|
The time on the server in UTC. |
String |
|
Object |
|
|
Object |
|
|
Object |
info object
This object contains information about the locality.
Field |
Description |
Format |
|
The latitude (in degrees). |
Number |
|
The longitude (in degrees). |
Number |
|
Locality page on Yandex Weather. |
String |
fact object
This object contains information about the current weather.
Field |
Description |
Format |
|
Temperature (°C). |
Number |
|
What the temperature feels like (°C). |
Number |
|
The water temperature (°C). This parameter is returned for localities where this information is relevant. |
Number |
|
The code of the weather icon. The icon is available at https://yastatic.net/weather/i/icons/funky/dark/<value from the icon field>.svg. |
String |
|
The code for the weather description. Possible values:
|
String |
|
Wind speed (meters per second). |
Number |
|
Speed of wind gusts (meters per second). |
Number |
|
Wind direction. Possible values:
|
String |
|
Atmospheric pressure (mm Hg). |
Number |
|
Atmospheric pressure (hPa). |
Number |
|
Humidity (percent). |
Number |
|
Light or dark time of the day. Possible values:
|
String |
|
Indicates that the time of day specified in the |
Boolean |
|
Time of year in this locality. Possible values:
|
String |
|
The time when weather data was measured, in Unix time. |
Number |
Forecast object
This object contains weather forecast data.
Field |
Description |
Format |
|
Date of the forecast, in the format YYYY-MM-DD. |
String |
|
The date of the forecast in Unix time. |
Number |
|
Week number. |
Number |
|
Time of the sunrise in local time (may be omitted for polar regions). |
String |
|
Time of the sunset in local time (may be omitted for polar regions). |
String |
|
Code of the lunar phase. Possible values:
|
Number |
|
Text code for the lunar phase. Possible values:
|
String |
|
Forecasts by time of day. Contains the following fields:
All weather forecasts for a certain time of day have the same set of fields. The response contains a forecast for the next two periods. |
Object |
|
Name of the time of day. Possible values:
|
String |
|
Minimum temperature for the time of day (°C). |
Number |
|
Maximum temperature for the time of day (°C). |
Number |
|
Average temperature for the time of day (°C). |
Number |
|
What the temperature feels like (°C). |
Number |
|
The code of the weather icon. The icon is available at https://yastatic.net/weather/i/icons/funky/dark/<value from the icon field>.svg. |
String |
|
The code for the weather description. Possible values:
|
String |
|
Light or dark time of the day. Possible values:
|
String |
|
Indicates that the time of day specified in the |
Boolean |
|
Wind speed (meters per second). |
Number |
|
Speed of wind gusts (meters per second). |
Number |
|
Wind direction. Possible values:
|
String |
|
Atmospheric pressure (mm Hg). |
Number |
|
Atmospheric pressure (hPa). |
Number |
|
Humidity (percent). |
Number |
|
Predicted amount of precipitation (mm). |
Number |
|
Predicted duration of precipitation (minutes). |
Number |
|
Chance of precipitation. |
Number |
Example
Request:
GET https://api.weather.yandex.ru/v2/informers?lat=55.75396&lon=37.620393
X-Yandex-API-Key: 3fc...7
Response:
{
"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",
...
},
{...}
]
}
}
Description
Chance of precipitation.
Format
Number
Description
Minimum temperature for the time of day (°C).
Format
Number
Description
Maximum temperature for the time of day (°C).
Format
Number
Description
Average temperature for the time of day (°C).
Format
Number
Description
What the temperature feels like (°C).
Format
Number
Description
The code of the weather icon. The icon is available at https://yastatic.net/weather/i/icons/funky/dark/<value from the icon field>.svg.
Format
String
Description
Indicates that the time of day specified in the daytime
field is polar.
Format
Boolean
Description
Wind speed (meters per second).
Format
Number
Description
Speed of wind gusts (meters per second).
Format
Number
Description
Atmospheric pressure (mm Hg).
Format
Number
Description
Atmospheric pressure (hPa).
Format
Number
Description
Humidity (percent).
Format
Number
Description
Predicted amount of precipitation (mm).
Format
Number
Description
Predicted duration of precipitation (minutes).
Format
Number
Description
Name of the time of day. Possible values:
night
— Night.morning
— Morning.day
— Day.evening
— Evening.
Format
String
Description
The code for the weather description. Possible values:
clear
— Clear.partly-cloudy
— Partly cloudy.cloudy
— Cloudy.-overcast
— Overcast.drizzle
— Drizzle.light-rain
— Light rain.rain
— Rain.moderate-rain
— Moderate rain.heavy-rain
— Heavy rain.continuous-heavy-rain
— Continuous heavy rain.showers
— Showers.-wet-snow
— Sleet.light-snow
— Light snow.snow
— Snow.snow-showers
— Snowfall.hail
— Hail.thunderstorm
— Thunderstorm.thunderstorm-with-rain
— Rain, thunderstorm.thunderstorm-with-hail
— Thunderstorm, hail.
Format
String
Description
Light or dark time of the day. Possible values:
- “d” — Light time of day.
- “n” — Dark time of day.
Format
String
Description
Wind direction. Possible values:
- “nw” — Northwest.
- “n” — North.
- “ne” — Northeast.
- “e” — East.
- “se” — Southeast.
- “s” — South.
- “sw” — Southwest.
- “w” — West.
- “c” — Calm.
Format
String
The latitude in degrees. Required field.
The longitude in degrees. Required field.
Description
The latitude (in degrees).
Format
NumberDescription
The latitude (in degrees).
Format
Number
Description
The longitude (in degrees).
Format
Number
The combination of language and country that weather information will be returned for. Possible values:
- “ru_RU” — Russian for the Russia locale.
- “be_BY” — Belarusian for the Belarus locale.
- “kk_KZ” — Kazakh for the Kazakhstan locale.
- “tr_TR” — Turkish for the Turkey locale.
- “en_US” — International English.
The key you received when enabling the Yandex.Weather API.
Description
The time on the server in Unix time.
Format
Number
Description
The time on the server in UTC.
Format
String
Description
Locality page on Yandex Weather.
Format
String
Description
Temperature (°C).
Format
Number
Description
Time of year in this locality. Possible values:
- “summer” — Summer.
- “autumn” — Autumn.
- “winter” — Winter.
- “spring” — Spring.
Format
String
Description
The time when weather data was measured, in Unix time.
Format
Number
Description
Date of the forecast, in the format YYYY-MM-DD.
Format
String
Description
The date of the forecast in Unix time.
Format
Number
Description
Week number.
Format
Number
Description
Time of the sunrise in local time (may be omitted for polar regions).
Format
String
Description
Time of the sunset in local time (may be omitted for polar regions).
Format
String
Description
Code of the lunar phase. Possible values:
- 0 — Full moon.
- 1-3 — Waning crescent.
- 4 — Last quarter.
- 5-7 — Waning gibbous.
- 8 — New moon.
- 9-11 — Waxing gibbous.
- 12 — First quarter.
- 13-15 — Waxing crescent.
Format
Number
Description
Text code for the lunar phase. Possible values:
moon-code-0
— Full moon.moon-code-1
— Waning moon.moon-code-2
— Waning moon.moon-code-3
— Waning moon.moon-code-4
— Last quarter.moon-code-5
— Waning moon.moon-code-6
— Waning moon.moon-code-7
— Waning moon.moon-code-8
— New moon.moon-code-9
— Waxing moon.moon-code-10
— Waxing moon.moon-code-11
— Waxing moon.moon-code-12
— First quarter.moon-code-13
— Waxing moon.moon-code-14
— Waxing moon.moon-code-15
— Waxing moon.
Format
String