NWA Request

You only need to specify this style URL in your client and it will automatically know what other URLs it has to request for other resources such as vector tiles and sprites:

https://api.meteomatics.com/mvt/weather_reports/nwa:0/style.json?<optionals>

Optional Fields

Optional fields can be attached to the query string as follows:

https://...?option_name=<option_value>&...

The following table describes all optional parameters:

FieldDescriptionValueExample
datetimeA date to retrieve the vector data
If no datetime is provided, the system defaults to the time of the request.
Dates and times are specified according to the ISO-86011 format (YYYY-MM-DDThh:mm:ssZ). All times are in UTC. Note that the part containing time specifications (Thh:mm:ss) is optional. The default setting is now. For more details see Date/Time Description 2018-04-12T12:45Z
access_tokenInstead of basic authentication, you can opt to use OAuth authentication as described here: OAuth AuthentificationString.eyJhbGciOicCI6 ... y2QT4fwpMeJ

Visual Representation

Nwa map
 
WhatDescription
PolygonRepresents where the National Weather Alert is applicable
Hazard TypeAbbreviated name of the hazard (phenomenon) of the given NWA
"Wind": "Wi",
"Snow or Ice": "SI",
"Thunderstorm": "TS",
"Fog": "Fo",
"High Temperature": "HT",
"Low Temperature": "LT",
"Coastal Event": "CE",
"Forest Fire": "FF",
"Avalanches": "Av",
"Rain": "Ra",
"Flooding": "Fl",
"Rain Flood": "RF"
SeverityColor of the region identify the severity of the event
"Extreme": "#ff0000" - red
"Severe": "#ff9300" - orange
"Moderate": "#ffda22" - yellow

Note: Before the 13.06.2024, all issued alerts are reported. After the 13.06.2024, in case of a revoke, the end of this alert's validity will be the time of the status change. For example, if there was a warning which was later cancelled, the end of the alert validity would be the time of the cancellation. Thus, alerts revoked before the start of the event are not shown on the map.

Note: Multiple alerts can be present in the same area simultaneously, which may lead to unclear hazard types.

Note: Depending on the zoom level some NWA's geometries may be too small to be added to MVT and will be excluded automatically.

Further Relevant NWA Informations

Apart from the information represented by the polygon representation above, we also encode other relevant information into the Protobuf file. These can be extracted and projected on your map by using a custom stylesheet. Here is a list of the additionally available fields:

KeyData TypeUnit
originator_namestring -
headlinestring -
eventstring -
descriptionstring -
instructionstring -
locationstring -
region_codestring -
beginsstring ISO time format string
endsstring ISO time format string
levelstring -
typestring -
cancelledstring ISO time format string