NAME
MetAlerts - Weather alerts from the Norwegian Meteorological Institute
DESCRIPTION
Delivers weather alerts in CAP format plus an RSS 2.0 feed of such.
Documentation (in Norwegian) of the MetAlerts service and warnings in CAP format may be found in the MET report Samordning av farevarsler ved MET og NVE (20-2017).
The Farevarselplan (in Norwegian) describes the criteria for issuing alerts.
Also see the instructions on how to use the RSS feed (in Norwegian).
USAGE
Use the RSS feed to get a list of CAP warnings, optionally filtered by query parameters.
Do not download each CAP file more than once, and certainly not every time you download the RSS feed! (this is liable to getting you throttled). Once issued the CAP file never changes, so it should be downloaded only once and stored locally.
Parameters
none
Unless the cap parameter is given, we return an RSS 2.0 feed of alerts
cap
Retrieve CAP XML message with given guid (Note: From 1.0 this is the CAP identifier, not a date!)
lang
Output language, currently "no" or "en" for Norwegian and English, respectively
event
Filter by CAP eventType (experimental)
incidentName
Filter by incident
county
Filter by Norwegian county number where available (only land areas, not gale warnings etc). The county number is defined as always having 2 digits, so the counties Østfold to Aust-Agder must be zero prefixed. Currently one single county allowed per request.
Note that the list of counties is undergoing several changes in the period 2018-2020. For an updated list, please see the list from Kartverket.
lat, lon
Coordinates for geographical search (returns all alerts covered by the search location)
Note: This feature is experimental, and may be changed without prior notice!
show
Alerts to be listed, either "all" to include expired/updated alerts (up to one month past), or nothing to list only current
sort
Sort RSS items on field (in ascending order). The following fields are available:
- area
- event
- incidentName
- t_published
- t_onset
- type
Example requests:
https://aa0206x0905nfqpv5.api.met.no/weatherapi/metalerts/1.1/
https://aa0206x0905nfqpv5.api.met.no/weatherapi/metalerts/1.1?lang=en
https://aa0206x0905nfqpv5.api.met.no/weatherapi/metalerts/1.1?show=all
https://aa0206x0905nfqpv5.api.met.no/weatherapi/metalerts/1.1/?county=42
(show alerts for Agder county)https://aa0206x0905nfqpv5.api.met.no/weatherapi/metalerts/1.1/?cap=2.49.0.1.578.0.170912185028.1114
(non-functional example - check RSS feed above for working URLs)
HEALTHCHECK
To check if any files that should be available are missing,
please use https://aa0206x0905nfqpv5.api.met.no/weatherapi/metalerts/1.1/healthcheck
.
Change log
2019-11-01
The eventCode drivingConditions
has now been replaced by the eventCodes ice
and blowingSnow
to better reflect actual causes instead of consequences
2018-06-19
Support for filter on incidentName
2018-03-08
Support for search by county number (for warnings issued after 2018-03-15)
2017-07-22
Experimental support for search by coordinates
1.1, 2017-05-20
New version of CAP format (1.0). MetAlerts 1.0 will expire 2017-12-01
1.0, 2016-09-01
More search parameters, improved stability
0.2, 2016-04-20
Format officially changed to RSS 2.0
RSS now validates, using RFC-822 date format and no duplicate items
0.1, 2016-03-02
Renamed to MetAlerts. Format claimed to be Atom, but is in fact RSS 2.0 (invalid)
0.1, 2016-01-19
New product for testing