Are you getting 403 Forbidden errors? Read the FAQ and check your User-Agent header!

 

NAME

Tidalwater - Tidal water information

DESCRIPTION

Water level forecast for a selected set of harbors in Norway. Weather condition adjustments are generally available for the immediate three days.

OUTPUT FORMAT

Data is delivered as a fixed-column plaintext file. Values are given as meters above mean sea level (middelvannstand), and all times are in UTC.

Water level have two components: Tidal forces (TIDE) and the influence of weather (SURGE). Tidal forces is the basis for calculating water level. Forecast of weather conditions for the specified harbor is then used to adjust this basis (TOTAL). Waves are not included in the forecast, only long period phenomena.

See https://kartverket.no/sehavniva/data-pa-se-havniva/viktige-vannstandsniva/ for further information on the reference water level.

Columns

AAR, MND, DAG, TIM

Year, month, day and hour (in UTC) respectively

PROG

Prognosis length (time since model run)

SURGE

Influence of weather (wind, air pressure)

TIDE

Tidal forces (astronomical data from Kartverket)

TOTAL

Total water level (sum of SURGE and TIDE)

0p, 25p, 50p, 75p, 100p

Percentiles of SURGE, i.e. how many of the ensemble forecasts are below the indicated (absolute) value. E.g. if 75p is 0.14, this means 75% of the forecasts are below 0.14 while 25% are more than that.

Example output (Bergen harbor)

MET - PROGNOSER

    VANNSTANDSVARSEL --- MET STORMFLO ---

    SIST OPPDATERT: 20200330 10:05 UTC
    ==========================================
    BERGEN
    ------------------------------
     AAR MND DAG TIM PROG  SURGE  TIDE   TOTAL  0p     25p    50p    75p    100p
    2020   3  30   0    0  -0.18   0.30   0.12  -0.18  -0.18  -0.18  -0.18  -0.18
    2020   3  30   1    1  -0.20   0.36   0.16  -0.20  -0.20  -0.20  -0.20  -0.19
    2020   3  30   2    2  -0.22   0.31   0.09  -0.22  -0.20  -0.20  -0.20  -0.19
    2020   3  30   3    3  -0.22   0.16  -0.06  -0.23  -0.22  -0.21  -0.21  -0.20
    2020   3  30   4    4  -0.22  -0.07  -0.29  -0.23  -0.22  -0.21  -0.21  -0.20
    2020   3  30   5    5  -0.23  -0.30  -0.53  -0.23  -0.22  -0.21  -0.21  -0.20
    2020   3  30   6    6  -0.23  -0.45  -0.68  -0.25  -0.23  -0.23  -0.23  -0.22
    2020   3  30   7    7  -0.23  -0.49  -0.72  -0.24  -0.23  -0.23  -0.23  -0.22
    2020   3  30   8    8  -0.23  -0.42  -0.65  -0.24  -0.23  -0.23  -0.23  -0.22

Available

Available is implemented at https://api.met.no/weatherapi/tidalwater/1.1/available which lists all harbors which we have forecasts for.

Parameters

A request must specify the harbour of interest. Datatype and content-type are optional.

harbor (mandatory)

Specify the harbor of interest.

Available harbors:

andenes, bergen, bodø, hammerfest, harstad, heimsjø, helgeroa, honningsvåg, kabelvåg, kristiansund, mausund, måløy, narvik, ny-ålesund, oscarsborg, oslo, rørvik, stavanger, tregde, tromsø, trondheim, vardø, viker, ålesund

content_type (optional)

Specify content type for the returned data.

Currently only valid value is text/plain (default), so can be ignored

datatype (optional)

Specify type of data, currently only valid value is weathercorrection (default), so can be ignored

Example requests

    https://api.met.no/weatherapi/tidalwater/1.1/?harbor=bergen

    https://api.met.no/weatherapi/tidalwater/1.1/?harbor=trondheim&content_type=text/plain&datatype=weathercorrection

Changelog

Documentation errata, 2020-03-30

Corrected to say that levels are in meters (not centimeters as previously stated) and times in UTC, as well as explanations of the percentile columns.

New harbour Mausund, 2020-02-05

Data for Mausund added to harbour list

1.1 2018-07-04

Available implemented, only harbor is now a mandatory parameter

1.1 2013-01-28

- weather correction data is changed
- old product like tidal is removed

1.1 2008-02-25

- New version 1.1 available
- Changed name of parameter: type => datatype.
- Parameter datatype is now mandatory.
- Access to tidal data has been restricted.
- Old version, 1.0, expires 1.april 2008.