--- metadata: - name: generator content: Diplodoc Platform v5.56.0 alternate: - https://yandex.com/dev/weather/doc/en/concepts/forecast-info.md - https://yandex.com/dev/weather/doc/ru/concepts/forecast-info.md - href: en/concepts/forecast-info.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/en/llms.txt # “Yandex Weather on your site” rate Use this request to get the current weather and forecast for the specified locality. - [Request format](#req-format) - [Response format](#resp-format) - [Example](#req-ex) ## Request format {#req-format} The locality is indicated using the latitude ([lat](#lat-param) parameter) and longitude ([lon](#lon-param) parameter). If these parameters are set incorrectly, the response will contain a 404 error code. ``` GET https://api.weather.yandex.ru/v2/informers? [lat](*lat)= & [lon](*lon)= & [[lang](*lang)=] [X-Yandex-Weather-Key](*X_Yandex_Weather_Key): ``` Request headers: #### X-Yandex-Weather-Key {#X-Yandex-Weather-Key-param} The key you received when [enabling the Yandex Weather API](https://yandex.com/dev/weather/doc/en/concepts/api.md#onboarding). Request parameters: #### lat {#lat-param} The latitude in degrees. Required field. #### lon {#lon-param} The longitude in degrees. Required field. #### lang {#lang-param} 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 {#resp-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](#info). | Object || || `fact` | [Current weather information object](#fact). | Object || || `forecast` | [Weather forecast object](#forecasts). | Object || |# ### info object {#info} 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](https://yandex.ru/pogoda/). | String || |# ### fact object {#fact} 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/\.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 {#forecasts} 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](*part_name) - [temp_min](*temp_min) - [temp_max](*temp_max) - [temp_avg](*temp_avg) - [feels_like](*feels_like) - [icon](*icon) - [condition](*condition) - [daytime](*daytime) - [polar](*polar) - [wind_speed](*wind_speed) - [wind_gust](*wind_gust) - [wind_dir](*wind_dir) - [pressure_mm](*pressure_mm) - [pressure_pa](*pressure_pa) - [humidity](*humidity) - [prec_mm](*prec_mm) - [prec_period](*prec_period) - [prec_prob](*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/\.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 {#req-ex} Request: ``` GET https://api.weather.yandex.ru/v2/informers?lat=55.75396&lon=37.620393 X-Yandex-Weather-Key: 3fc...7 ``` Response: ``` { "[now](*now)": 1470220206, "[now_dt](*now_dt)": "2016-08-03T10:30:06.238Z", "info": { "[lat](*lat_2)": 55.833333, "[lon](*lon_2)": 37.616667, "[url](*url)": "https://yandex.ru/pogoda/moscow" }, "fact": { "[temp](*temp)": 20, "[feels_like](*feels_like)": 21, "[icon](*icon)": "ovc", "[condition](*condition)": "overcast", "[wind_speed](*wind_speed)": 2, "[wind_gust](*wind_gust)": 5.9, "[wind_dir](*wind_dir)": "n", "[pressure_mm](*pressure_mm)": 745, "[pressure_pa](*pressure_pa)": 994, "[humidity](*humidity)": 83, "[daytime](*daytime)": "d", "[polar](*polar)": false, "[season](*season)": "summer", "[obs_time](*obs_time)": 1470214800 }, "forecast": { "[date](*date)": "2016-08-03", "[date_ts](*date_ts)": 1522702800, "[week](*week)": 15, "[sunrise](*sunrise)": "04:38", "[sunset](*sunset)": "20:31", "[moon_code](*moon_code)": 1, "[moon_text](*moon_text)": "moon-code-1", "parts": [ { "[part_name](*part_name)": "day", "[temp_min](*temp_min)": 20, "[temp_max](*temp_max)": 21, "[temp_avg](*temp_avg)": 21, "[feels_like](*feels_like)": 23, "[icon](*icon)": "bkn_n", "[condition](*condition)": "cloudy", "[daytime](*daytime)": "n", "[polar](*polar)": false, "[wind_speed](*wind_speed)": 0.9, "[wind_gust](*wind_gust)": 4, "[wind_dir](*wind_dir)": "nw", "[pressure_mm](*pressure_mm)": 746, "[pressure_pa](*pressure_pa)": 995, "[humidity](*humidity)": 81, "[prec_mm](*prec_mm)": 0, "[prec_period](*prec_period)": 360, "[prec_prob](*prec_prob)": 0 }, { "part_name": "evening", ... }, {...} ] } } ``` [*prec_prob]: **Description** Chance of precipitation. **Format** Number [*temp_min]: **Description** Minimum temperature for the time of day (°C). **Format** Number [*temp_max]: **Description** Maximum temperature for the time of day (°C). **Format** Number [*temp_avg]: **Description** Average temperature for the time of day (°C). **Format** Number [*feels_like]: **Description** What the temperature feels like (°C). **Format** Number [*icon]: **Description** The code of the weather icon. The icon is available at https://yastatic.net/weather/i/icons/funky/dark/\.svg. **Format** String [*polar]: **Description** Indicates that the time of day specified in the `daytime` field is polar. **Format** Boolean [*wind_speed]: **Description** Wind speed (meters per second). **Format** Number [*wind_gust]: **Description** Speed of wind gusts (meters per second). **Format** Number [*pressure_mm]: **Description** Atmospheric pressure (mm Hg). **Format** Number [*pressure_pa]: **Description** Atmospheric pressure (hPa). **Format** Number [*humidity]: **Description** Humidity (percent). **Format** Number [*prec_mm]: **Description** Predicted amount of precipitation (mm). **Format** Number [*prec_period]: **Description** Predicted duration of precipitation (minutes). **Format** Number [*part_name]: **Description** Name of the time of day. Possible values: - `night` — Night. - `morning` — Morning. - `day` — Day. - `evening` — Evening. **Format** String [*condition]: **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 [*daytime]: **Description** Light or dark time of the day. Possible values: - “d” — Light time of day. - “n” — Dark time of day. **Format** String [*wind_dir]: **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 [*lat]: The latitude in degrees. Required field. [*lon]: The longitude in degrees. Required field. [*lat_2]: **Description** The latitude (in degrees). **Format** Number [*lon_2]: **Description** The longitude (in degrees). **Format** Number [*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. [*X_Yandex_Weather_Key]: The key you received when [enabling the Yandex.Weather API](https://yandex.com/dev/weather/doc/en/concepts/api.md#onboarding). [*now]: **Description** The time on the server in Unix time. **Format** Number [*now_dt]: **Description** The time on the server in UTC. **Format** String [*url]: **Description** Locality page on [Yandex Weather](https://yandex.com/pogoda/en-US?lat=53.339046&lon=83.69133). **Format** String [*temp]: **Description** Temperature (°C). **Format** Number [*season]: **Description** Time of year in this locality. Possible values: - “summer” — Summer. - “autumn” — Autumn. - “winter” — Winter. - “spring” — Spring. **Format** String [*obs_time]: **Description** The time when weather data was measured, in Unix time. **Format** Number [*date]: **Description** Date of the forecast, in the format YYYY-MM-DD. **Format** String [*date_ts]: **Description** The date of the forecast in Unix time. **Format** Number [*week]: **Description** Week number. **Format** Number [*sunrise]: **Description** Time of the sunrise in local time (may be omitted for polar regions). **Format** String [*sunset]: **Description** Time of the sunset in local time (may be omitted for polar regions). **Format** String [*moon_code]: **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 [*moon_text]: **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