This version (2.0) is currently in beta and should not yet be used in production. [0]
 

NAME

Nowcast - Immediate weather forecast for specified locations in the Nordic area

DESCRIPTION

This service delivers a weather forecast for up to two hours for a location in Norway, Sweden, Finland and Denmark. Forecasts are updated every 5 minutes. It is our best estimate of the current weather conditions.

Coverage

This forecast is dependent on functional radar coverage of the specified locations. In some places this is not accessible due to topography or range. Radars might also be temporarily out of production due to technical issues. In such cases no forecast can be issued, please check the RadarCoverage parameter in the JSON output for one of the following conditions:

ok

Location is in radar coverage and the forecast is produced as normal

temporarily unavailable

The radar is on the blink, no forecast can be issued

no coverage

The location is outside radar range or blocked by geographical features

Note that this is different from Nowcast version 0.9, which returned a 422 Unprocessable Entity HTTP status code for locations outside radar range.

Due to changes in radar coverage we currently do not support downloading of shapefiles describing the supported area.

JSON format and variables

Version 2.0 defaults to JSON format for data. For an explanation of the various variables, see the Datamodel documentation. The JSON format is described in the General Forecast Format documentation.

Weather icons

Along with the new JSON format we also have a new set of weather icons, in PNG, SVG and PDF formats. They can be downloaded as a gzipped TAR archive using the WeatherIcon 2.0 service.

The filename (minus extension) corresponds to the symbol_code in the JSON format, including variations for day, night and polar day. This means there is no need for calculations or fetching data from the Sunrise service in order to present the correct weather icons.

Note: There is a typing error in lightssleetshowersandthunder and lightssnowshowersandthunder (extra "s" after "light"). Unfortunately, correcting this would mean breaking existing applications, so it has been postponed to the next version of weathericon/locationforecast.

Wind symbols

Wind direction denote where the wind is coming from, where 0° is north, 90° east, etc. For GUI applications use we suggest using arrows, like these:

0° (north)

90° (east)

180° (south)

270° (west)

USAGE

Parameters

lat

latitude in decimal degrees, mandatory

lon

longtitude in decimal degrees, mandatory

altitude

whole meters above sea level (integers), optional but recommended for precise values.

Sample request URLs:

Oslo
    https://api.met.no/weatherapi/nowcast/2.0/complete?lat=59.9333&lon=10.7166
Bergen
    https://api.met.no/weatherapi/nowcast/2.0/complete?lat=60.3894&lon=5.33
Trondheim
    https://api.met.no/weatherapi/nowcast/2.0/complete?lat=63.4308&lon=10.4034
Tromsø
    https://api.met.no/weatherapi/nowcast/2.0/complete?lat=69.6827&lon=18.9427
Vardø
    https://api.met.no/weatherapi/nowcast/2.0/complete?lat=70.3705&lon=31.0241

Status

Operational status for this product can be checked at https://api.met.no/weatherapi/nowcast/2.0/status .

Schema

The JSON schema is included in the OpenAPI (Swagger) feed:

    https://api.met.no/weatherapi/nowcast/2.0/swagger # Not yet implemented 

AUTHENTICATION

Due to poor adherence to the identification requirements in the Terms of Service, we have implemented more stringent checks on sending a unique identifier in the User-Agent header. Any requests with a prohibited or missing User-Agent will receive a 403 Forbidden error.

Examples of banned User-Agents include:

CHANGELOG

version 2.0 beta, 2020-09-11

New version using JSON and FORTI in development.

2017-09-11

Added coverage method

2017-06-21

New schema, now returns empty XML when no radar data available

version 0.9, 2016-05-01

Initial version