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 or other older forecasts, please look at version 1.6 of this product.

Data format

The forecasts are divided up into specific areas, identified by an id attribute:

    <location name="Inner Oslofjord" id="0816">...

To find the definition of each area, you should download the corresponding area file from https://api.met.no/weatherapi/textforecast/2.0/areas (using the type parameter) and look up the area with the specified id, which will give you the coordinates:

    <area id="0816">
        <areaDesc>Indre Oslofjord</areaDesc>
        <polygon>
            59.747500,10.592000 59.866167,10.666667 59.761333,10.733667 59.834667,10.789500
            59.917833,10.766667 59.881333,10.470167 59.688167,10.531667 59.666167,10.598667
            59.571167,10.621667 59.527167,10.532500 59.531167,10.605167 59.521667,10.645667
            59.508667,10.664167 59.491667,10.675167 59.493000,10.695167 59.747500,10.592000
        </polygon>
    </area>

(areaDesc is currently only showing the Norwegian title.)

USAGE

Parameters

forecast

Valid forecasts are:

coast_en
coast_no
landoverview
sea_en
sea_no
sea_wmo

This can also be called directly, e.g.

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

Sample request URLs

https://api.met.no/weatherapi/textforecast/2.0/?forecast=landoverview
https://api.met.no/weatherapi/textforecast/2.0/coast_en
https://api.met.no/weatherapi/textforecast/2.0/sea_no

Areas

A list of areas with corresponding coordinate polygons can be downloaded at

    https://api.met.no/weatherapi/textforecast/2.0/areas

Note: type=sea is temporarily missing FIXME

Schema

The XML Schema is available as https://api.met.no/weatherapi/textforecast/2.0/schema

Available

A list of available data may be retrieved using the 'available' action, using the url https://api.met.no/weatherapi/textforecast/2.0/available .

Changelog

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

Changelog

Other versions