Textforecast

NAME

Textforecast - Textual weather forecast for Norwegian land and sea areas

DESCRIPTION

This module returns text forecasts for land and sea areas in and around Norway.

Sea forecasts are in both English and Norwegian language (either bokmål or nynorsk), as well as special WMO terminology. This is indicated in the forecast name. Land forecasts are currently only issued in Norwegian.

If you are looking for aerodrome forecasts, please look at the Aviationforecast product.

Data format

GeoJSON (NEW)

In addition to the existing XML format, the land and coast forecasts are now also available in GeoJSON, complete with polygon coordinates.

The JSON format is described in the General Area Forecast Format documentation.

Note: This is currently in beta, and minor changes to the JSON format must be expected!

USAGE

Parameters

forecast

Valid forecasts are:

• coast_en
• coast_no
• landoverview

This can also be called directly, e.g.

    https://api.met.no/weatherapi/textforecast/3.0/landoverview
    https://api.met.no/weatherapi/textforecast/3.0/coast_en

Sample request URLs

https://api.met.no/weatherapi/textforecast/3.0/?forecast=landoverview

https://api.met.no/weatherapi/textforecast/3.0/coast_en

Schema

A JSON Schema will be included in the OpenAPI feed Real Soon Now FIXME

Available

A list of available forecasts is available in xml and json formats:

https://api.met.no/weatherapi/textforecast/3.0/available

https://api.met.no/weatherapi/textforecast/3.0/available.json

Change log

New beta version 3.0 with land and coast forecasts as GeoJSON, 2022-10-05

The landoverview and coast_xx forecasts is now produced in a new GeoJSON format. The sea_xx forecasts are expected to be added later, at which time version 2.0 will be deprecated.

New marine forecast sea_*, 2019-11-20

We have a new, auto-generated marine text forecast called sea, which replaces the manually written seabank and seahigh forecasts. The old forecasts will continue to be produced until 1st Feb 2020; until then all requests will return a 203 status code to indicate deprecation.

Version 1.6 deprecated, 2019-09-02

As mentioned on the mailing list, the aviation forecasts (aw_* and iga_*) have been moved to a separate product aviationforecast. Since the other forecasts (land and sea) have been reeimplemented in textforecast/2.0, version 1.6 will shortly be discontinued (planned date 2019-10-01).

New version 2.0, 2019-03-01

We are in the process of revamping all textforecast products, with a cleaner XML format which can be validated and clearly defined areas. New products will be launched on the 2.0 version after they have been migrated, while the old products will be available for some time on 1.6.

So far the ocean, seabank and seahigh products have been upgraded to 2.0. We have also launched a new landoverview product which will replace the land and landmerge products, as well as the textlocation service.

We expect to discontinue 1.6 late 2019, while removing disused products (mainly aviation forecasts) continously in collaboration with existing users.

land and seaoslofjord forecasts removed, 2019-03-01

Production of the "land" forecast will stop on March 1st, 2019, and will be removed as a valid parameter value.

The product "seaoslofjord" containing forecasts for Skagerrak and for the Norwegian coast from the Swedish border to Hordaland will be discontinued from our Textforecast service from March 1st. Forecasts for Skagerrak can be found in the "seabank" products, while forecasts for the complete Norwegian coastline can be found in the "coast" products.

aw_enry replaced by aw_ento, 2019-02-01

Rygge airport is currently closed, so no ENRY forecasts have been issued this year. Instead we are now producing aerodrome forecasts for Torp (ENTO). iga_fbno43 has also not been in production for a long time and has been removed.

several forecast types removed, 2019-02-01

On February 1st we will remove the following products:

route_fbno*

These will be replaced with the new routeforecast service for automatically generated graphical forecast. The old route_fbno forecasts will be available on NAIS for some time.

landday0-2, landlong, seabankday1 and metkyst0-1

These are temporary files included in the more comprehensive forecasts

easter, miskred_north, miskred_south, iga_fbno43

These have not been produced for several years

gale and obs removed, 2018-06-07

gale* and obs* are no longer permitted values in the forecast parameter

gale and obs soon to be discontinued, 2017-12-13

The gale and obs warnings are now available in CAP format from the metalerts section of the API, and will shortly be discontinued in textforecast. The following values will then no longer be allowed in the forecast parameter and will result in a 400 Bad Request:

gale

gale_id

obs

obs_va

obs_vn

obs_vv

version 1.6, 2012-05-10

New version 1.6 available:

Use of latitude and longitude is removed, use Textlocation instead for this functionality. extreme forecasts are moved to their own product

Version 1.5 available until 2012-09-04

version 1.5, 2009-03-11

New version 1.5 available:

New parameters latitude and longitude available

Version 1.4 is available until 2009-04-25

version 1.4, 2008-11-26

New version 1.4 available:

The format for Obsvarsel is reversed to be like 1.2. The format from 1.3 is available as forecast=obs_merge.

Version 1.3 is available until 2009-02-18

version 1.3, 2008-11-04

New version 1.3 available:

New tag in merged forecasts, origin_forecast which contains the name of the forecast this part is coming from.

obs forecast is changed to be a merged forecast. The XML-format is slightly changed, and might contain more than one time period.

extreme forecast might contain more than one situation at the time, following the merged syntax. Phase D forecasts will only be shown in six hours instead of 12 hours.

Version 1.2 is available until 2009-02-18

version 1.2, 2008-03-05

New version 1.2 available:

landday1 has changed XML. IDs are now consistent and counties are thin area-elements. land is also affected by this change.

Version 1.1 is available until 2008-06-01

version 1.1 : 2007-06-13

New version 1.1 available:

Landshort has changed name to landday1.

landday1, landday2 and landlong has a new element in their XML called area. This element is used to group the counties.

Two new merged forecasts, land and seabank.

Two new forecasts available, gale and extreme.

Version 1.0 is available until 2007-08-15