Point Forecast API
Welcome to MetOcean Solutions' Forecast API, which offers point time-series data for any location on earth.
The API delivers atmospheric, hydrodynamic, and wave data from local high resolution and global forecast models.
Key Features
- Up to ten days forecast horizon
- Seven days of historical forecast
- Data for individual sites or along routes
- Forecast data from multiple forecast models
Available Data
- Wind
- Waves
- Air Temperature
- Precipitation
- Sea Surface Temperature
- Currents
- Visibility
- Cloud Cover
- Convective Potential Energy
Getting Started
To get started with the Forecast API you need an API key, which you can get by signing up here: console.metoceanapi.com.
Your API key should be passed to our API in the x-api-key request header.
Data Endpoints
These endpoints deliver actual forecast data:
- /point/time: Returns a time-series of the selected weather variables for the given point.
- /route/time: Returns selected weather variables for a route made of a series of point + time.
- /route/speed: Returns selected weather variables for a route made of a series of point + speed components.
- /point: Returns a single scalar value for the supplied points + variables (e.g.,
sea.depth.below-sea-level).
Detailed technical specifications for these endpoints can be found in the Technical Reference.
Information Endpoints
These endpoints supply reference information, including which variables and models are available.
- /variables: A list of all the variables you can select from the Forecast API, and the units associated with them.
- /units: A list of all units associated with warnings and possible unit conversions.
- /models: A list of model names.
- /models/{model}: Details of a specific model including data time range, variables, and geographic area.
- /modelsummaries: A high-level list of models with summary information.
Examples
The data endpoint pages linked above contain basic examples. More detailed examples are also available on GitHub.