Ncagalewarnings

NAME

NCAgalewarnings - gale warnings for the Norwegian Coastal Administration (Kystverket)

DESCRIPTION

This service delivers gale warnings for the areas defined in Sjøtrafikkforskriften kap. 4, which must be avoided by ships over 150 m in length carrying passengers during wind conditions over 17.2 m/s.

The following areas are included:

  • Stadt, stretch between Sildegapet and Runde lighthouse
  • Hustadvika, stretch between Buadjupet and Grip lighthouse
  • Folda, stretch between Buholmråsa fyr and Rørvik
  • Fugløykalven, stretch between Hekkingen and Fugløykalven
  • Sørøya, stretch between Hasvik and Tarhalsen
  • Honningsvåg, stretch between Fruholmen and Helneset

The alerts are delivered in CAP format, see MetAlerts for details. All alerts have the event code thresholdGale and geographicDomain marine.

USAGE

Methods

/current - show active alerts

Use the RSS feed to get a list of CAP warnings, optionally filtered by query parameters.

https://api.met.no/weatherapi/ncagalewarnings/1.0/current.rss
https://api.met.no/weatherapi/ncagalewarnings/1.0/current.xml
https://api.met.no/weatherapi/ncagalewarnings/1.0/current.json

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.

/all - show active and inactive alerts

Normally only active alerts are listed, with expired alerts filtered out. Using /all will list all alerts issued during the last 30 days, both active and inactive.

https://api.met.no/weatherapi/ncagalewarnings/1.0/all.rss
https://api.met.no/weatherapi/ncagalewarnings/1.0/all.xml
https://api.met.no/weatherapi/ncagalewarnings/1.0/all.json

/test - Test alerts (active)

See next paragraph

/test_all - Test alerts (all)

Meteorologists sometimes want to test fictional CAP warnings to check that they work upstream. /test now only shows active warnings. To show all warnings issues in the last 30 days, use /test_all.

https://api.met.no/weatherapi/ncagalewarnings/1.0/test.rss
https://api.met.no/weatherapi/ncagalewarnings/1.0/test.xml
https://api.met.no/weatherapi/ncagalewarnings/1.0/test.json
https://api.met.no/weatherapi/ncagalewarnings/1.0/test?cap=...
https://api.met.no/weatherapi/ncagalewarnings/1.0/test_all.rss
https://api.met.no/weatherapi/ncagalewarnings/1.0/test_all.json

Parameters

cap

Retrieve CAP XML message with given guid

lang

Output language, currently "no" or "en" for Norwegian and English, respectively

lat, lon

Coordinates for geographical search (returns all alerts covered by the search location)

sort

Sort RSS items on field (in ascending order). The following fields are available:

  • area
  • t_onset
  • t_published
  • type

Example requests

https://api.met.no/weatherapi/ncagalewarnings/1.0/current.json?lang=en
https://api.met.no/weatherapi/ncagalewarnings/1.0/all.xml?lang=no
https://api.met.no/weatherapi/ncagalewarnings/1.0/current.xml?cap=... (check RSS feed above for working URLs)

CHANGELOG

Version 1.0, 2026-03-24

Initial version in beta

 

Changelog