Weather maps 2.0
Updated Weather maps! Now available Forecast, Historical and Current weather maps.
15 weather map layers. You can get all of them using only one simple URL!
Using the one simple URL you can get the following weather maps:
URL format and Parameters to get Weather maps
Use the following URL format and parameters to get weather maps. Please pay attention on URL example.URL format
http://maps.openweathermap.org/maps/2.0/weather/{op}/{z}/{x}/{y}Parameters:
op - Weather map layer. Full list of available weather map layers here.
z - Number of zoom level
x - Number of x tile coordinate
y - Number of y tile coordinate
appid - Personal API key
date - Date and time of (Unix time, UTC), e.g. date=1527811200. If you do not specify any date and time, you will get Current weather map. More information about how to get Current, Forecast and Historical maps you can find here.
Optional parameters:
opacity - Degree of layer opacity. Available value from 0 to 1 (default - 0.8)
palette - Color palette. You can use custom palettes for each layer. You can also create a palette for yourself and pass it to the URL as follows {value}:{HEX color};..;{value}:{HEX color}. More information about it here.
fill_bound - 'true' or 'false'. If 'true', then all weather values outside the specified set of values will be filled by color corresponding to the nearest specified value (default value - 'false': all weather values outside the specified set of values are not filled).
arrow_step - Step of values for drawing wind arrows, specify in pixels (default - 32). Parameter only for wind layers (WS10, WND).
use_norm - 'true' or 'false'. If 'true', then the length of the arrows is normalizing (default - 'false': the length of the arrows is proportional to the speed wind value). Parameter only for wind layers (WS10, WND).
Example of URL
http://maps.openweathermap.org/maps/2.0/weather/TA2/{z}/{x}/{y}?date=1527811200&
opacity=0.9&fill_bound=true&appid={api_key}You need to insert the generated URL into the special plugins. For example, Leaflet, OpenLayers. You can also use any other apps that support the display of layers. More information about it you can find here.
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 and 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 9 February 2018, 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 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.
Example of URL for pass your palette:
http://maps.openweathermap.org/maps/2.0/weather/TA2/{z}/{x}/{y}?date=1527811200&
opacity=0.9&fill_bound=true&palette=0:FF0000;10:00FF00;20:0000FF&appid={api key}Examples of Weather maps
Air temperature at a height of 2 meters weather layer
Default parameters
- op: TA2
- fill_bound: false
Example of URL:
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
- Custom palette (see Example of URL)
Example of URL:
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:fc8014Accumulated precipitation weather layer
Default parameters
- op: PA0
Example of URL:
http://maps.openweathermap.org/maps/2.0/weather/PA0/{z}/{x}/{y}?date=1527811200&
appid={api_key}Atmospheric pressure on mean sea level weather layer
Default parameters
- op: APM
Example of URL:
http://maps.openweathermap.org/maps/2.0/weather/PA0/{z}/{x}/{y}?date=1527811200&
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
Example of URL:
http://maps.openweathermap.org/maps/2.0/weather/WND/{z}/{x}/{y}?date=1527811099&
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
Example of URL:
http://maps.openweathermap.org/maps/2.0/weather/WND/{z}/{x}/{y}?date=1527811099&
use_norm=true&arrow_step=16&appid={api_key}Libraries to connect weather layers
Open Layers
- Classes of weather layer and weather stations layer
- Possibility to set your own style
- Classes with clustered markers
- Support of marker server clustering
Leaflet
- 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