--- metadata: - name: generator content: Diplodoc Platform v5.39.6 alternate: - https://yandex.com/dev/weather/doc/en/concepts/nowcast.md - https://yandex.com/dev/weather/doc/ru/concepts/nowcast.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/weather/doc/en/llms.txt ## Rain API {#nowcast} {% note tip "" %} Data on precipitation from this section are available as part of the enterprise plan of Yandex Weather. Details can be requested through [feedback form](https://yandex.ru/dev/weather/doc/ru/concepts/troubleshooting). {% endnote %} 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. {% note info "Пример" %} 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. {% endnote %} To get nowcasting for a selected geographical point, the `nowcast` object must be specified in the request: {% include [button](../_includes/button-cd154f71d142.md) %}
Run in playground
```graphql { 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 } } } } ``` {% cut "Response" %} ```json { "data": { "weatherByPoint": { "nowcast": { "region": "default", "steps": [ { "[time](*time)": "2022-12-09T06:00:00+01:00", "[bounds](*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](*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 } ] } } } } ``` {% endcut %} 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. {% cut "Empty response" %} ```json { "errors": [ { "message": "TNowcastTimeline not found", "path": [ "weatherByPoint", "nowcast_timeline" ] } ], "data": { "weatherByPoint": { "nowcast": { "region": "default", "steps": [] } } } } ``` {% endcut %} ## 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](https://ru.wikipedia.org/wiki/Tiled_web_map), 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) and `EPSG:3857` are supported. [*time]: Step time (in this field an ISO file is used, which includes information about the timezone). [*bounds]: A rectangular area where nowcast data is available (lat – latitude, lon – longitude). [*isLongterm]: The flag marking 10-minute data (false) and hourly (true). [*genTime]: Timestamp of map generation. Used for synchronization when requesting data about tiles. [*timestamp]: Timestamp step of forecast data.