Weather maps 2.0

URL format and parameters

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

API call

URL example

How to get current, forecast and historical weather maps using only 'date' parameter?

To get current, forecast or historical weather maps you just need to change only date parameter in the URL request:

1. Current weather maps. Specify the current date and time to get Current weather map. The date and time specified in the request will be rounded to the previous 3-hour interval.

2. Forecast weather maps. You can specify any date and time within the next 10 days to get the Forecast weather maps for the specified time. If you do not specify any date and time, you will get Current weather map.

Not available for TS0 and TS10 layers.

3. Historical weather maps. If you specify any date and time since 18 March 2019, you will receive Historical weather maps for the selected date and time. If you do not specify any date and time, you will get Current weather map.

What layers are there in the new weather maps?

To specify the selected layer in the URL, insert instead of the {op} parameter one of the following values:

How to pass my palette in the map?

For each layer we have custom palettes, but you can use your own palette and pass it to the URL as shown {value}:{HEX color};..;{value}:{HEX color}.

The number of values in the custom palette can be any, but not less than 2. You can set the color for any value with any precision.

To pass the code of color, use the HEX format.

URL Example

Examples of Weather maps

Air temperature at a height of 2 meters weather layer

Default parameters

op : TA2

fill_bound : false

URL example

http://maps.openweathermap.org/maps/2.0/weather/TA2/{z}/{x}/{y}?appid={API key}

Air temperature at a height of 2 meters weather layer

Custom palette

op : TA2

opacity : 0.6

fill_bound : true

palette : custom (see example)

URL example

http://maps.openweathermap.org/maps/2.0/weather/TA2/{z}/{x}/{y}?appid={API key}&fill_bound=true&opacity=0.6&palette=-65:821692;-55:821692;-45:821692;-40:821692;-30:8257db;-20:208cec;-10:20c4e8;0:23dddd;10:c2ff28;20:fff028;25:ffc228;30:fc8014

Accumulated precipitation weather layer

Default parameters

op : PA0

URL example

http://maps.openweathermap.org/maps/2.0/weather/PA0/{z}/{x}/{y}?date=1552861800&appid={API key}

Atmospheric pressure on mean sea level weather layer

Default parameters

op : APM

URL example

http://maps.openweathermap.org/maps/2.0/weather/PA0/{z}/{x}/{y}?date=1552861800&appid={API key}

Joint display of speed wind (color) and wind direction (arrows) weather layer

Default parameters

op : WND

use_norm : false

arrow_step : 32

URL example

http://maps.openweathermap.org/maps/2.0/weather/WND/{z}/{x}/{y}?date=1552861800&appid={API key}

Joint display of speed wind (color) and wind direction (arrows) weather layer

Custom parameters

op : WND

use_norm : true

arrow_step : 16

URL example

http://maps.openweathermap.org/maps/2.0/weather/WND/{z}/{x}/{y}?date=1552861800&use_norm=true&arrow_step=16&appid={API key}

Default palettes

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

Leaflet library

Another implementation of map based on Leaflet technology supports OWM's TileLayers and current city/station data. It is configurable with many options. For current city/station data the library supports refreshing the data in intervals, some types of client-side clustering (show only the station/city with the highest rank for a defined pixel square), custom image set (if you provide one), different languages (en, de, ru, fr, but translation is incomplete), minZoom and others.

Source and documentation (README.md) is available on GitHub https://github.com/buche/leaflet-openweathermap

Example of weather map: https://github.com/owm-inc/VANE-intro/tree/master/apps