NAME
Oceanforecast - Ocean forecasts for points at sea in Northwestern Europe
DESCRIPTION
Delivers wave and sea forecast in standard MET Forecast GeoJSON format.
The forecast is based on multiple wave and sea models. For more information on models and parameters, see the Oceanforecast data model documentation.
Requests outside the model area will get a 422 response. For requests inside the model but on land away from the coast, you will get a GeoJSON document with an error message. For requests near the coast, the system will "snap" to the nearest ocean point so that the coordinates in the GeoJSON might be different from the URL.
Wave direction
Version 0.9 followed oceanographic convention instead of meteorological convention, meaning that the value indicates where the waves are moving, not where they are coming from.
In the 2.0 JSON version,
this is now changed to the more common meteorological convention for waves,
while currents still use oceanographic convention.
This is indicated in the variable names,
sea_surface_wave_from_direction and sea_water_to_direction.
The MOX format directions has not changed as this format will be removed soon.
Model data
The raw model data used to construct the forecast can be found on THREDDS as NetCDF files or using the OPeNDAP protocol:
https://thredds.met.no/thredds/fou-hi/fou-hi.html
USAGE
Parameters
lat
Latitude in decimal degrees, mandatory
lon
Longtitude in decimal degrees, mandatory
Example urls:
/mox
This is a temporary version of the MOX format replacement FORTI backend for Oceanforecast/0.9, which made as a temporary fix for Yr since the model for 0.9 is going out of production. It will be removed after the summer of 2021.
While the MOX format will be the same as in 0.9 there might be some differences in the data values due to different models and interpolations, so we recommend you start porting to 2.0 JSON as soon as possible.
Coverage
A shapefile of the area covered can be downloaded as a ZIP archive at https://api.met.no/weatherapi/oceanforecast/2.0/converage .
Status
Operational status for this product can be checked at https://api.met.no/weatherapi/oceanforecast/2.0/status .
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:
- okhttp
- Dalvik
- fhttp
- Java
Changelog
Version 2.0 in production, 2021-05-10
Added coverage, improved error handling. Version 0.9 will expire on 2021-07-01.
Version 2.0 in beta, 2021-02-19
New, totally rewritten version using standard JSON format. Older MOX XML is no longer supported. Now snaps automatically to nearest coastal point for coordinates on land.
Update of 0.9, 2016-11-21
After upgrading model in backend, Oceanforecast will no longer return any data for locations on land
0.9, 2009-02-24
Initial version