“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

now

The time on the server in Unix time.

Number

now_dt

The time on the server in UTC.

String

info

Locality information object.

Object

fact

Current weather information object.

Object

forecast

Weather forecast object.

Object

info object

This object contains information about the locality.

Field

Description

Format

lat

The latitude (in degrees).

Number

lon

The longitude (in degrees).

Number

url

Locality page on Yandex Weather.

String

fact object

This object contains information about the current weather.

Field

Description

Format

temp

Temperature (°C).

Number

feels_like

What the temperature feels like (°C).

Number

temp_water

The water temperature (°C). This parameter is returned for localities where this information is relevant.

Number

icon

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

condition

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.

String

wind_speed

Wind speed (meters per second).

Number

wind_gust

Speed of wind gusts (meters per second).

Number

wind_dir

Wind direction. Possible values:

  • “nw” — Northwest.
  • “n” — North.
  • “ne” — Northeast.
  • “e” — East.
  • “se” — Southeast.
  • “s” — South.
  • “sw” — Southwest.
  • “w” — West.
  • “c” — Calm.

String

pressure_mm

Atmospheric pressure (mm Hg).

Number

pressure_pa

Atmospheric pressure (hPa).

Number

humidity

Humidity (percent).

Number

daytime

Light or dark time of the day. Possible values:

  • “d” — Light time of day.
  • “n” — Dark time of day.

String

polar

Indicates that the time of day specified in the daytime field is polar.

Boolean

season

Time of year in this locality. Possible values:

  • “summer” — Summer.
  • “autumn” — Autumn.
  • “winter” — Winter.
  • “spring” — Spring.

String

obs_time

The time when weather data was measured, in Unix time.

Number

Forecast object

This object contains weather forecast data.

Field

Description

Format

date

Date of the forecast, in the format YYYY-MM-DD.

String

date_ts

The date of the forecast in Unix time.

Number

week

Week number.

Number

sunrise

Time of the sunrise in local time (may be omitted for polar regions).

String

sunset

Time of the sunset in local time (may be omitted for polar regions).

String

moon_code

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.

Number

moon_text

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.

String

parts

Forecasts by time of day. Contains the following fields:

  • part_name
  • temp_min
  • temp_max
  • temp_avg
  • feels_like
  • icon
  • condition
  • daytime
  • polar
  • wind_speed
  • wind_gust
  • wind_dir
  • pressure_mm
  • pressure_pa
  • humidity
  • prec_mm
  • prec_period
  • prec_prob

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

part_name

Name of the time of day. Possible values:

  • night — Night.
  • morning — Morning.
  • day — Day.
  • evening — Evening.

String

temp_min

Minimum temperature for the time of day (°C).

Number

temp_max

Maximum temperature for the time of day (°C).

Number

temp_avg

Average temperature for the time of day (°C).

Number

feels_like

What the temperature feels like (°C).

Number

icon

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

condition

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.

String

daytime

Light or dark time of the day. Possible values:

  • “d” — Light time of day.
  • “n” — Dark time of day.

String

polar

Indicates that the time of day specified in the daytime, field is polar.

Boolean

wind_speed

Wind speed (meters per second).

Number

wind_gust

Speed of wind gusts (meters per second).

Number

wind_dir

Wind direction. Possible values:

  • “nw” — Northwest.
  • “n” — North.
  • “ne” — Northeast.
  • “e” — East.
  • “se” — Southeast.
  • “s” — South.
  • “sw” — Southwest.
  • “w” — West.
  • “c” — Calm.

String

pressure_mm

Atmospheric pressure (mm Hg).

Number

pressure_pa

Atmospheric pressure (hPa).

Number

humidity

Humidity (percent).

Number

prec_mm

Predicted amount of precipitation (mm).

Number

prec_period

Predicted duration of precipitation (minutes).

Number

prec_prob

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",
        ...
      },
      {...}
    ]
  }
}