NAME

Radar - Radar images from various locations

DESCRIPTION

Returns image or animation for a specified radarsite. The image/animation can originate from one specific radar or a composite of two or more radars. Either latest available image or image at a requested time. Only one animation pr. radarsite (most recent) is available. Note that a specific radarsite may sometimes become unavailable. This is usually due to technical problems at the radarsite, caused by lightning/difficult weather conditions.

Restrictions

The nordic radar composite is restricted, and is not freely available. Please refer to our general documentation regarding this topic.

Parameters

Please note that there are many combinations of parameter values for which we have no data, so refer to https://aa0206x0905nfqpv5.api.met.no/weatherapi/radar/1.5/available for an updated list of available data.

radarsite (mandatory)

Area covered by the image/animation (composite) or name of the radar location (single radar).

Values: andoya, avinoreast, avinorwest, berlevaag, bomlo, central_norway, east_norway, finnmark, hafjell, hagebostad, hasvik, hurum, mobileradar, nordic, nordland, nordland_troms, norway, rissa, rost, somna, south_norway, southeast_norway, southwest_norway, stad, trlagnordland, troms_finnmark, western_norway

avinoreast and avinorwest are only available for the type reflectivity_tma, bomlo (previously spelled boemlo) is available for the type rainrate_with_phase_tma and reflectivity_hires.

The single place images (andoya, berlevaag, bomlo, hasvik, hagebostad, hurum, rissa, rost, stad and somna) are available as reflectivity_hires and size normal.

mobileradar is only available for type xband.

For an authorative list, see https://aa0206x0905nfqpv5.api.met.no/weatherapi/radar/1.5/radaroptions

size (optional)

Size of image. Defaults to normal, in which the size of the image maps correctly to grid of the data source (one pixel for one data point).

Sizes medium and large are no longer produced, any requests for these will return normal size instead.

Size small is available for only some radar types, see https://aa0206x0905nfqpv5.api.met.no/weatherapi/radar/1.5/available or https://aa0206x0905nfqpv5.api.met.no/weatherapi/radar/1.5/radaroptions .

Values: small, normal

type (mandatory)

Type of radar information. Note that 'tma' is short for (Terminal control area).

Values: accumulated_12h, accumulated_1h, accumulated_24h, accumulated_3h, accumulated_6h, lightning, rainrate_with_phase, rainrate_with_phase_tma, reflectivity, reflectivity_hires, reflectivity_tma, xband

content

Type of data to be returned:

image (default)

Static image for a given time (defaults to latest). This is usually in PNG format, although radartypes with animations will return GIF for both static images and animations.

animation

Composite of the 8 most recent images in GIF format. time parameter not supported for this type. Animation is only available for the types reflectivity, xband and lightning.

Values: image, animation

time (optional)

The time the radarimage was captured in ISO 8601 format. If omitted, the latest available image will be returned. This parameter can not be specified if value of parameter 'type' is set to 'animation'.

Value format: yyyy-mm-ddThh:mm:ssZ.

Example requests:

Available

A list of available data may be retrieved using the 'available' action. The radarsite, type, size and content parameters can be specified to reduce the size of the list, which is highly recommended as the full list consists of over 3000 URLs and is very slow to generate and download.

https://aa0206x0905nfqpv5.api.met.no/weatherapi/radar/1.5/available
https://aa0206x0905nfqpv5.api.met.no/weatherapi/radar/1.5/available?radarsite=central_norway&size=normal
https://aa0206x0905nfqpv5.api.met.no/weatherapi/radar/1.5/available?type=reflectivity_hires&size=normal&content=image
https://aa0206x0905nfqpv5.api.met.no/weatherapi/radar/1.5/available?content=animation

Radaroptions

This returns a list in JSON with all legal parameter values for each type:

    https://aa0206x0905nfqpv5.api.met.no/weatherapi/radar/1.5/radaroptions

Note: This feature is experimental, the values may be changed without further notice.

Status

Check operational status of all radars, returns JSON with the following fields:

Note: This feature is experimental, new fields may be added without further notice.

Area

Radar code

Sitename

Proper name of radar site

Stability

Uptime in percent during last 2 hours

Last

Time of last communication

Products

Array of API radar products which are using this radar

FaultCode

Optional code designating type of error:

PS

Power Supply

VP

Planned maintenance

CO

Communications error

TE

Technical error

DueDate

Optional date when radar is expected back in operation

Example requests:

Changelog

2019-07-01: New radar Hafjell, hack for missing animations

Hafjell has been added for types lightning, reflectivity_hires and rainrate_with_phase.

Unfortunately, due to increased server load and shorter production cycles we have not been able to re-enable production of the animations for reflectivity_hires, rainrate_with_phase and most lightning radars. As a workaround, we will be substituting reflectivity_hires and rainrate_with_phase animations with the closest matching reflectivity animation. Similarly, all lightning radarsites will now return the "norway" animation. None of these will appear in the available lists, and are used solely to avoid breaking existing code.

Static images will be delivered as normal, which will not match the animation in content and dimensions. This means you should not use the "small" images as thumbnails for the animations until further notice.

We are working on replacements for the missing lightning animations, as well as a new, improved Radar product version which should be more user-friendly.

2019-06-19: update of v1.5

Radars now produce images every 5 minutes (instead of every 7.5).

Animations are currently only available for reflectivity, xband and lightning (as per the documentation). The undocumented reflectivity_hires animation is now discontinued.

The little-used sizes "large" and "medium" have been discontinued, any requests for these will return "normal" instead. Also, animations are now only available in "normal", use a static image for thumbnails instead of "small".

For a list of allowed options, see /radaroptions (experimental).

2017-01-25: update of v1.5

New xband radar "mobileradar"

2016-10-31: update of v1.5

New composite east_norway available (including images from new radar hafjell)

2016-10-03: update of v1.5

Radar helsfyr/x-band is not available any more

2015-10-28: new version 1.5

New size medium which are fixed to 460px. For types lightning and reflectivity the images that were delivered as size normal are moved to size medium and new images are available as size normal (unscaled).

Version 1.4 will expire on 2016-02-15

2015-09-09: update of v1.4

New radar type lightning available for norway, new site helsfyr available for type xband.

2015-03-17: update of v1.4

New radar sites 'nordland' and 'trlagnordland' added (radar location: Somna).

2013-11-12: new version 1.4

Parameter width has been replaced with size. Width and size of an image or animation may vary in width and height, even within the same size value.

Several new radar types. See documentation above.

Version 1.3 expires at 2014-03-25.

2012-03-26: new version 1.3

Parameter type has been changed. It will now signify type of radar information. Parameter content now has same function as parameter type in version 1.2.

Version 1.2: expires at 2012-05-15.

2010-08-31: new composite image of norway.

New parameter to radarsite: norway.

2009-10-27: version 1.2

New parameteres to radarsite: central_norway and western_norway. Rissa is no longer a valid radarsite.

Version 1.1 is available until 2010-02-16

2008-09-23: version 1.1

New radarsite: troms_finnmark.

version 1.1 : 2007-09-06

Røst is no longer valid as radarsite. New radarsite is nordland_troms