MetAlerts

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.

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