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 describes the criteria for issuing alerts, including descriptions of difficult driving conditions.

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:

Example requests:

https://external.api.met.no/weatherapi/metalerts/1.1/
https://external.api.met.no/weatherapi/metalerts/1.1?lang=en
https://external.api.met.no/weatherapi/metalerts/1.1?show=all
https://external.api.met.no/weatherapi/metalerts/1.1/?county=42 (show alerts for Agder county)
https://external.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://external.api.met.no/weatherapi/metalerts/1.1/healthcheck .

Change log

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