Rain API
Data on precipitation from this section are available as part of the enterprise plan of Yandex Weather. Details can be requested through feedback form.
The Yandex Weather API provides nowcasting — a precipitation front forecast that uses machine learning, and is based on weather radar data, satellite images and user reports. Nowcasting is available at 10-minute intervals for the upcoming two hours and an hourly breakdown for the following 24 hours.
Пример
If the current time is 20:00, the data will be shown:
- from 20:00 to 22:00 – every 10 minutes;
- from 22:00 to 20:00 – hourly.
To get nowcasting for a selected geographical point, the nowcast object must be specified in the request:
{
weatherByPoint(request: { lat: 52.37125, lon: 4.89388 }) {
nowcast {
region
steps {
time
bounds {
lat { min max }
lon { min max }
}
cloudiness
condition
daytime
precType
precStrength
isLongterm
}
}
}
}
Response
{
"data": {
"weatherByPoint": {
"nowcast": {
"region": "default",
"steps": [
{
"time": "2022-12-09T06:00:00+01:00",
"bounds": {
"lat": {
"min": -47.92,
"max": 71.2
},
"lon": {
"min": -18,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": false
},
{
"time": "2022-12-09T06:10:00+01:00",
"bounds": {
"lat": {
"min": -47.92,
"max": 71.2
},
"lon": {
"min": -18,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": false
},
{
"time": "2022-12-09T06:20:00+01:00",
"bounds": {
"lat": {
"min": -47.92,
"max": 71.2
},
"lon": {
"min": -18,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": false
},
{
"time": "2022-12-09T06:30:00+01:00",
"bounds": {
"lat": {
"min": -47.92,
"max": 71.2
},
"lon": {
"min": -18,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": false
},
{
"time": "2022-12-09T06:40:00+01:00",
"bounds": {
"lat": {
"min": -47.92,
"max": 71.2
},
"lon": {
"min": -18,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": false
},
{
"time": "2022-12-09T06:50:00+01:00",
"bounds": {
"lat": {
"min": -47.92,
"max": 71.2
},
"lon": {
"min": -18,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": false
},
{
"time": "2022-12-09T07:00:00+01:00",
"bounds": {
"lat": {
"min": -47.92,
"max": 71.2
},
"lon": {
"min": -18,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": false
},
{
"time": "2022-12-09T07:10:00+01:00",
"bounds": {
"lat": {
"min": -47.92,
"max": 71.2
},
"lon": {
"min": -18,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": false
},
{
"time": "2022-12-09T07:20:00+01:00",
"bounds": {
"lat": {
"min": -47.92,
"max": 71.2
},
"lon": {
"min": -18,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": false
},
{
"time": "2022-12-09T07:30:00+01:00",
"bounds": {
"lat": {
"min": -47.92,
"max": 71.2
},
"lon": {
"min": -18,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": false
},
{
"time": "2022-12-09T07:40:00+01:00",
"bounds": {
"lat": {"min": 22, "max": 69.36},
"lon": {"min": -9.44, "max": 180}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": false
},
{
"time": "2022-12-09T07:50:00+01:00",
"bounds": {
"lat": {
"min": -47.92,
"max": 71.2
},
"lon": {
"min": -18,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": false
},
{
"time": "2022-12-09T08:00:00+01:00",
"bounds": {
"lat": {
"min": -47.92,
"max": 71.2
},
"lon": {
"min": -18,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": false
},
{
"time": "2022-12-09T08:10:00+01:00",
"bounds": {
"lat": {
"min": -47.92,
"max": 71.2
},
"lon": {
"min": -18,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": false
},
{
"time": "2022-12-09T08:20:00+01:00",
"bounds": {
"lat": {
"min": -47.92,
"max": 71.2
},
"lon": {
"min": -18,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": false
},
{
"time": "2022-12-09T08:30:00+01:00",
"bounds": {
"lat": {
"min": -47.92,
"max": 71.2
},
"lon": {
"min": -18,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": false
},
{
"time": "2022-12-09T08:40:00+01:00",
"bounds": {
"lat": {
"min": -47.92,
"max": 71.2
},
"lon": {
"min": -18,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "DAY",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": false
},
{
"time": "2022-12-09T08:50:00+01:00",
"bounds": {
"lat": {
"min": -47.92,
"max": 71.2
},
"lon": {
"min": -18,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "DAY",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": false
},
{
"time": "2022-12-09T09:00:00+01:00",
"bounds": {
"lat": {
"min": -47.92,
"max": 71.2
},
"lon": {
"min": -18,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "DAY",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": false
},
{
"time": "2022-12-09T09:10:00+01:00",
"bounds": {
"lat": {
"min": -47.92,
"max": 71.2
},
"lon": {
"min": -18,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "SLEET",
"daytime": "DAY",
"precType": "SLEET",
"precStrength": "WEAK",
"isLongterm": false
},
{
"time": "2022-12-09T09:20:00+01:00",
"bounds": {
"lat": {
"min": -47.92,
"max": 71.2
},
"lon": {
"min": -18,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "SLEET",
"daytime": "DAY",
"precType": "SLEET",
"precStrength": "WEAK",
"isLongterm": false
},
{
"time": "2022-12-09T09:30:00+01:00",
"bounds": {
"lat": {
"min": -47.92,
"max": 71.2
},
"lon": {
"min": -18,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "SLEET",
"daytime": "DAY",
"precType": "SLEET",
"precStrength": "WEAK",
"isLongterm": false
},
{
"time": "2022-12-09T09:40:00+01:00",
"bounds": {
"lat": {
"min": -47.92,
"max": 71.2
},
"lon": {
"min": -18,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "SLEET",
"daytime": "DAY",
"precType": "SLEET",
"precStrength": "WEAK",
"isLongterm": false
},
{
"time": "2022-12-09T09:50:00+01:00",
"bounds": {
"lat": {
"min": -47.92,
"max": 71.2
},
"lon": {
"min": -18,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "SLEET",
"daytime": "DAY",
"precType": "SLEET",
"precStrength": "WEAK",
"isLongterm": false
},
{
"time": "2022-12-09T10:00:00+01:00",
"bounds": {
"lat": {
"min": -47.92,
"max": 71.2
},
"lon": {
"min": -18,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "SLEET",
"daytime": "DAY",
"precType": "SLEET",
"precStrength": "WEAK",
"isLongterm": false
},
{
"time": "2022-12-09T10:00:00+01:00",
"bounds": {
"lat": {
"min": -90,
"max": 90
},
"lon": {
"min": -180,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "DAY",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": true
},
{
"time": "2022-12-09T11:00:00+01:00",
"bounds": {
"lat": {
"min": -90,
"max": 90
},
"lon": {
"min": -180,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "DAY",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": true
},
{
"time": "2022-12-09T12:00:00+01:00",
"bounds": {
"lat": {
"min": -90,
"max": 90
},
"lon": {
"min": -180,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "DAY",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": true
},
{
"time": "2022-12-09T13:00:00+01:00",
"bounds": {
"lat": {
"min": -90,
"max": 90
},
"lon": {
"min": -180,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "DAY",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": true
},
{
"time": "2022-12-09T14:00:00+01:00",
"bounds": {
"lat": {
"min": -90,
"max": 90
},
"lon": {
"min": -180,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "DAY",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": true
},
{
"time": "2022-12-09T15:00:00+01:00",
"bounds": {
"lat": {
"min": -90,
"max": 90
},
"lon": {
"min": -180,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "DAY",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": true
},
{
"time": "2022-12-09T16:00:00+01:00",
"bounds": {
"lat": {
"min": -90,
"max": 90
},
"lon": {
"min": -180,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "DAY",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": true
},
{
"time": "2022-12-09T17:00:00+01:00",
"bounds": {
"lat": {
"min": -90,
"max": 90
},
"lon": {
"min": -180,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": true
},
{
"time": "2022-12-09T18:00:00+01:00",
"bounds": {
"lat": {
"min": -90,
"max": 90
},
"lon": {
"min": -180,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": true
},
{
"time": "2022-12-09T19:00:00+01:00",
"bounds": {
"lat": {
"min": -90,
"max": 90
},
"lon": {
"min": -180,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": true
},
{
"time": "2022-12-09T20:00:00+01:00",
"bounds": {
"lat": {
"min": -90,
"max": 90
},
"lon": {
"min": -180,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": true
},
{
"time": "2022-12-09T21:00:00+01:00",
"bounds": {
"lat": {
"min": -90,
"max": 90
},
"lon": {
"min": -180,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": true
},
{
"time": "2022-12-09T22:00:00+01:00",
"bounds": {
"lat": {
"min": -90,
"max": 90
},
"lon": {
"min": -180,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": true
},
{
"time": "2022-12-09T23:00:00+01:00",
"bounds": {
"lat": {
"min": -90,
"max": 90
},
"lon": {
"min": -180,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": true
},
{
"time": "2022-12-10T00:00:00+01:00",
"bounds": {
"lat": {
"min": -90,
"max": 90
},
"lon": {
"min": -180,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": true
},
{
"time": "2022-12-10T01:00:00+01:00",
"bounds": {
"lat": {
"min": -90,
"max": 90
},
"lon": {
"min": -180,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": true
},
{
"time": "2022-12-10T02:00:00+01:00",
"bounds": {
"lat": {
"min": -90,
"max": 90
},
"lon": {
"min": -180,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": true
},
{
"time": "2022-12-10T03:00:00+01:00",
"bounds": {
"lat": {
"min": -90,
"max": 90
},
"lon": {
"min": -180,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": true
},
{
"time": "2022-12-10T04:00:00+01:00",
"bounds": {
"lat": {
"min": -90,
"max": 90
},
"lon": {
"min": -180,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": true
},
{
"time": "2022-12-10T05:00:00+01:00",
"bounds": {
"lat": {
"min": -90,
"max": 90
},
"lon": {
"min": -180,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": true
},
{
"time": "2022-12-10T06:00:00+01:00",
"bounds": {
"lat": {
"min": -90,
"max": 90
},
"lon": {
"min": -180,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": true
},
{
"time": "2022-12-10T07:00:00+01:00",
"bounds": {
"lat": {
"min": -90,
"max": 90
},
"lon": {
"min": -180,
"max": 180
}
},
"cloudiness": "OVERCAST",
"condition": "OVERCAST",
"daytime": "NIGHT",
"precType": "NO_TYPE",
"precStrength": "ZERO",
"isLongterm": true
}
]
}
}
}
}
Rain API availability depends on your product plan.
You may at times receive an “Empty” response. For example, if the given point lies outside the areas:
America:
- latitude – from -134.52 to -34.24;
- longitude – from 56.48 to 58.08.
Eurasia, Indonesia, Africa:
- latitude – from -12.0 to 69.3;
- longitude – from 58.52 to 180.0.
Empty response
{
"errors": [
{
"message": "TNowcastTimeline not found",
"path": [
"weatherByPoint",
"nowcast_timeline"
]
}
],
"data": {
"weatherByPoint": {
"nowcast": {
"region": "default",
"steps": []
}
}
}
}
Tiles
After the timeline is requested, you can get precipitation tiles:
https://api.weather.yandex.ru/frontend/nowcast/tile?x={x}&y={y}&z={z}&for_date=1673773200&nowcast_gen_time=1673948778
Or cloudiness:
https://api.weather.yandex.ru/frontend/nowcast/cloudiness_tile?x={x}&y={y}&z={z}&for_date=1673773200&nowcast_gen_time=1673948778
You need to work with such endpoint in the same way as tile maps, except required parameters needs to be passed:
for_date– step timestamp;nowcast_gen_time– generation timestamp.
The following optional parameters are also supported:
proj– tile projection,EPSG:3395(default) andEPSG:3857are supported.
Step time (in this field an ISO file is used, which includes information about the timezone).
A rectangular area where nowcast data is available (lat – latitude, lon – longitude).
The flag marking 10-minute data (false) and hourly (true).
Timestamp of map generation. Used for synchronization when requesting data about tiles.
Timestamp step of forecast data.
Was the article helpful?
Previous
Next