Fire Weather Index map
Fire Weather Index map concept
Using simple URL you can get the following Fire Weather Index maps:
-
Current Fire Weather index maps
-
Forecast Fire Weather index maps: The forecast for 5 days with a daily step
To recieve infromation about current and forecast fire weather index data in JSON format please read here.
Fire Weather Index map is designed to help users to estimate current and forecast fire danger. Predictions of fire danger conditions based on the Canadian Forest Service Fire Weather Index Rating System (FWI).
Fire Weather Index (FWI) is a numerical rating of the potential frontal fire intensity and indicates fire intensity by combining the rate of fire spread with the amount of fuel being consumed.
Fire Weather Index range values
FWI is classified in 6 classes of danger (very low, low, medium, high, very high and extreme). The fire danger classes are the same for all countries and maps show a harmonized picture of the spatial distribution of fire danger level. The following are the FWI values used as thresholds of the fire danger classes:
| Fire danger class number | Fire danger class name | FWI ranges (upper bound excluded) |
|---|---|---|
| 0 | Very low | <5.2 |
| 1 | Low | 5.2-11.2 |
| 2 | Moderate | 11.2-21.3 |
| 3 | High | 21.3-38.0 |
| 4 | Very high | 38.0-50.0 |
| 5 | Extreme | ≥50 |
URL format and parameters
Use the following URL format and parameters to get Fire weather Index maps. Please pay attention to the URL example.
API call
https://maps.openweathermap.org/maps/2.0/fwi/{z}/{x}/{y}?appid={API key}&date={date}
| Parameters | ||
|---|---|---|
{z} |
required | Number of zoom level. You could find information about correlation between zoom levels, X, Y tile coordinate numbers and level scale here. |
{x} |
required | Number of x tile coordinate. You could find information about correlation between zoom levels, X, Y tile coordinate numbers and level scale here. |
{y} |
required | Number of y tile coordinate. You could find information about correlation between zoom levels, X, Y tile coordinate numbers and level scale here. |
appid |
required | Your unique API key (you can always find it on your account page under the "API key" tab) |
date |
optional | Date and time of (Unix time, UTC), e.g. date=1527811200. If you do not specify any date and time, you will get Current Fire Weather Index map. More information about how to get Current, and Forecast fire weather index maps you can find here. |
URL example
https://maps.openweathermap.org/maps/2.0/fwi/4/1/6?appid={API key}&date=1600780200
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.
How to get Current and Forecast Fire Weather Index maps using only 'date' parameter?
To get Current and Forecast Fire Weather Index maps you just need to change only
date parameter in the URL request:
1. Current Fire Weather Index maps. Specify the current date and time to get Current Fire Weather Index map. The date and time specified in the request will be rounded to the midday local time of the current day. If you do not specify any date and time, you will get Current Fire Weather Index map.
2. Forecast Fire Weather Index maps. You can specify any date and time within the next 5 days to get the Forecast Fire Weather Index maps for the specified time.The date and time specified in the request will be rounded to the midday local time of the forecasted day. If you do not specify any date and time, you will get Current Fire Weather Index map.
Example of Fire Index maps
Please pay attention that for geographical coordinates with zero probobility of Fire Weather
Index filling is absent.
Fire Weather Index map
Fire Weather Index map default palette
By default in Fire Weather Index maps used the palette below:
0:126E00;35:FFEB3B;75:ED8E3E;150:FF0000;200:890000;300:FF00FB
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
