Documentation

US Precipitation Map

Get current, forecast and historical US precipitation weather maps with a 10 minutes-step via the easy-to-work API.

Features of US Precipitation Map

Update period is every 10 minutes
Resolution less than 1 km
Coverage: for US only
Weather sourcesUS Precipitatoin Map is based on global weather models, satellites, radars and our OWM NWP-ML technology.
There is the OpenWeather Interactive Weather Maps with Global Precipitation layer, which provide users with free access to visual data.

URL format and parameters

Use the following URL format and parameters to get weather maps. Please pay attention to the URL example.

API call

https://maps.openweathermap.org/maps/2.0/radar/us/forecast/{z}/{x}/{y}?appid={API key}&tm={date}

Parameters
`{z}`	required	Number of zoom level The minimum value is 3, and the maximum value is 7
`{x}`	required	Number of x tile coordinate
`{y}`	required	Number of y tile coordinate
`appid`	required	Your unique API key (you can always find it on your account page under the "API key" tab)
`tm`	required	Date and time of (Unix time, UTC), e.g. 1600781192. To get historical or forecast data, please specify the date in your API request.

Please pay attention to the points bellow to avoid possible errors:

Please specify dates in all API requests.
Please specify dates with 10 minutes steps. For example, 1600780200, 1600780800, 1600781400, etc.
Please specify dates not earlier than 2 days from the current time and not later than 5 hours from the current time.
Please specify {x} and {y} for US locations only.

https://maps.openweathermap.org/maps/2.0/radar/us/forecast/3/1/3?&appid={API key}&tm=1600781400

You need to insert the generated URL into special plugins.

For example, Leaflet, OpenLayers. You can also use any other apps that support the display of layers. Learn more.

Libraries to connect weather layers

The following functions are available for the OpenLayers library:

The OpenWeatherMap javascript library is designed to work with the Leaflet mapping service. The current version of the library allows the following:

Parameters

{z}

required

Number of zoom level The minimum value is 3, and the maximum value is 7

{x}

required

Number of x tile coordinate

{y}

required

Number of y tile coordinate

appid

required

Your unique API key (you can always find it on your account page under the "API key" tab)

tm

required

Date and time of (Unix time, UTC), e.g. 1600781192. To get historical or forecast data, please specify the date in your API request.