## Global Precipitation Maps History&Forecast Get current, forecast and historical global precipitation weather maps with a 10 minutes-step via the easy-to-work API. ## Features of Global Precipitation Map 1. This product includes two types of forecasts: 2. - Forecast for the next **6 hours** for the US territory - Forecast for the next **2 hours** for other global areas 3. Historical weather map for the previous 2 days 4. Update period: every 10 minutes 5. Resolution: less than 1 km 6. Global coverage 7. Weather map layers: Precipitation layer 8. Weather sources: Global Precipitatoin Map is based on global weather models, satellites, radars and our OWM NWP-ML technology. 9. 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. ## 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/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**.You could find information about correlation between zoom levels, X, Y tile coordinate numbers and level scale [here](/faq.md#zoom_levels) | | `{x}` | Yes | Number of x tile coordinate. You could find information about correlation between zoom levels, X, Y tile coordinate numbers and level scale [here](/faq.md#zoom_levels) | | `{y}` | Yes | Number of y tile coordinate. You could find information about correlation between zoom levels, X, Y tile coordinate numbers and level scale [here](/faq.md#zoom_levels) | | `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. 1600782000. To get historical or forecast data, please specify the date in your API request. To get current data, please specify the the nearest time in the past rounded up to 10 minutes | > Please pay attention to the points below 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 6 hours from the current time. ### URL example ```text https://maps.openweathermap.org/maps/2.0/radar/forecast/6/13/24?&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). ## Example of Global Precipitation Map layer Please find below Global Precipitation Map layer example. ### URL example to the timestamp in the past ```text https://maps.openweathermap.org/maps/2.0/radar/forecast/7/4/2?&appid={API key}&tm=1703235600 ``` ### URL example to the timestamp in the future ```text https://maps.openweathermap.org/maps/2.0/radar/forecast/7/4/2?&appid={API key}&tm=1703241000 ```  - [Preview weathermap](/weathermap.md?basemap=map&cities=false&layer=precipitation&lat=30&lon=-20&zoom=3) ## Default palette ranges | Range (dBZ) | Colour | Hex | RGB | | --- | --- | --- | --- | | 0 to < 7.01 |  | `#000000` | `0, 0, 0` | | 7.01 to < 9.83 |  | `#00B2FF` | `0, 178, 255` | | 9.83 to < 12.17 |  | `#00A7FF` | `0, 167, 255` | | 12.17 to < 15.91 |  | `#00FA96` | `0, 250, 150` | | 15.91 to < 20.02 |  | `#00FA64` | `0, 250, 100` | | 20.02 to < 21.96 |  | `#00E600` | `0, 230, 0` | | 21.96 to < 23.98 |  | `#00D300` | `0, 211, 0` | | 23.98 to < 26.01 |  | `#00BA00` | `0, 186, 0` | | 26.01 to < 28 |  | `#00A000` | `0, 160, 0` | | 28 to < 29.99 |  | `#008C00` | `0, 140, 0` | | 29.99 to < 31.01 |  | `#007800` | `0, 120, 0` | | 31.01 to < 32.01 |  | `#006400` | `0, 100, 0` | | 32.01 to < 33 |  | `#005A00` | `0, 90, 0` | | 33 to < 34 |  | `#005000` | `0, 80, 0` | | 34 to < 35.01 |  | `#004600` | `0, 70, 0` | | 35.01 to < 36 |  | `#EFF800` | `239, 248, 0` | | 36 to < 37 |  | `#F3EB00` | `243, 235, 0` | | 37 to < 39 |  | `#FADC00` | `250, 220, 0` | | 39 to < 40 |  | `#FFCD00` | `255, 205, 0` | | 40 to < 41 |  | `#FF9600` | `255, 150, 0` | | 41 to < 42 |  | `#FF5B00` | `255, 91, 0` | | 42 to < 45.09 |  | `#FF0000` | `255, 0, 0` | | 45.09 to < 47.91 |  | `#FF0064` | `255, 0, 100` | | 47.91 to < 53.01 |  | `#FF0092` | `255, 0, 146` | | 53.01 to < 59.83 |  | `#AA2BC3` | `170, 43, 195` | | 59.83 to < 70 |  | `#7609A4` | `118, 9, 164` | | 70 and above |  | `#3D015E` | `61, 1, 94` | ## 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 Using OpenWeatherMap weather tiles with leaflet: [PDF](https://)