Sofar API
Search…
Marine Weather
Gives access to our advanced Marine Weather data.
Restful endpoints in the Marine Weather API provide a few different types of information:
Data type
Description
These endpoints provide information about currently available models, variables, and categories of data that can be used throughout the Weather API.
These endpoints can be used to retrieve forecast output for specific times and locations.
Hindcast data
These endpoints can be used to retrieve hindcast output for specific times and locations.
Tile Server
These endpoints return raster tiles (images) of our weather data
Available Variables
Sofar Waves
Variable
Significant Wave Height
SofarOperationalWaveModel-significantWaveHeightMean Wave Direction
SofarOperationalWaveModel-meanDirectionMean Wave Directional Spread
SofarOperationalWaveModel-meanDirectionalSpreadMean Wave Period
SofarOperationalWaveModel-meanPeriodPeak Wave Frequency
SofarOperationalWaveModel-peakFrequencyPeak Wave Direction
SofarOperationalWaveModel-peakDirectionSignificant Wind Wave Height
SofarOperationalWaveModel-significantWaveHeightWindWavesMean Wind Wave Direction
SofarOperationalWaveModel-meanDirectionWindWavesMean Wind Wave Directional Spread
SofarOperationalWaveModel-meanDirectionalSpreadWindWavesPeak Wind Wave Period
SofarOperationalWaveModel-peakPeriodWindWavesSignificant First Swell Wave Height
SofarOperationalWaveModel-significantWaveHeightFirstSwellMean First Swell Direction
SofarOperationalWaveModel-meanDirectionFirstSwellMean First Swell Directional Spread
SofarOperationalWaveModel-meanDirectionalSpreadFirstSwellPeak First Swell Period
SofarOperationalWaveModel-peakPeriodFirstSwellSignificant Second Swell Wave Height
SofarOperationalWaveModel-significantWaveHeightSecondSwellMean Second Swell Direction
SofarOperationalWaveModel-meanDirectionSecondSwellMean Second Swell Directional Spread
SofarOperationalWaveModel-meanDirectionalSpreadSecondSwellPeak Second Swell Period
SofarOperationalWaveModel-peakPeriodSecondSwellSignificant Third Swell Wave Height
SofarOperationalWaveModel-significantWaveHeightThirdSwellWinds
Variable
Wind Velocity
GFS-magnitude10MeterWindWind Direction
GFS-direction10MeterWindEastward Wind Velocity
GFS-windVelocity10MeterEastwardNorthward Wind Velocity
GFS-windVelocity10MeterNorthwardHow to get a current marine weather forecast
Retrieving a current marine weather forecast is as simple as making a HTTP GET request to the correct URL with a valid API token. Here's an example:
An example request in Python might look like:
get_forecast.py
1
import requests
2
params = {
3
'token': 'YOUR_API_TOKEN',
4
'longitude': -152.0001,
5
'latitude': 37.0001,
6
'variableIDs': ['SofarOperationalWaveModel-significantWaveHeight', 'SofarOperationalWaveModel-meanDirection']
7
}
8
response = requests.get(
9
url='https://api.sofarocean.com/marine-weather/v1/models/SofarOperationalWaveModel/forecast/point',
10
params=params )
11
data = response.json()
12
print(data)
Copied!
Last modified 9mo ago
Copy link