<!-- block-id: intro -->

## US Precipitation Map

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

<!-- block-id: features -->

## Features of US Precipitation Map

1. Current, forecast and historical weather maps
2. - Forecast US precipitation map for the next 5 hours
  - Historical weather map for the previous 2 days
3. Update period is every 10 minutes
4. Resolution less than 1 km
5. Coverage: for US only
6. Weather sources
US Precipitatoin Map is based on global weather models, satellites, radars and our OWM NWP-ML technology.
7. There is the [OpenWeather Interactive Weather Maps](/weathermap.md?basemap=map&cities=true&layer=radar&lat=56.9510&lon=24.1064&zoom=5) with Global Precipitation layer, which provide users with free access to visual data.

<!-- block-id: url -->

## URL format and parameters

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

### API call

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

| Parameters |  |  |
| --- | --- | --- |
| `{z}` | Yes | Number of zoom level The minimum value is **3**, and the maximum value is **7** |
| `{x}` | Yes | Number of x tile coordinate |
| `{y}` | Yes | Number of y tile coordinate |
| `appid` | Yes | Your unique API key (you can always find it on your account page under the ["API key" tab](https://home.openweathermap.org/api_keys)) |
| `tm` | Yes | 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.

### URL example

```text
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](#library).

<!-- block-id: library -->

## Libraries to connect weather layers

### Open Layers

The following functions are available for the OpenLayers library:

- Classes of weather layer and weather stations layer
- Possibility to set your own style
- Classes with clustered markers
- Support of marker server clustering

### Leaflet

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

- Embedding of layer with current weather in cities
- Embedding of layer with weather stations
- The library supports customer clustering