When using our /route/v2/ endpoint, users are returned suggested vessel routes, for a particular vessel and speed, through canals and straight. You can use our weather/v2/track endpoint to post the route you obtained from /route/v2/, in order to get the weather at each route point. This works both in the past, with historical values, or in the future, with forecasted values.

Alternatively, you can form your own GeoJSON object, and post it to our weather/v2/track endpoint to obtain weather on your route. A minima, your FeatureCollection should contain at least one Feature, with the properties departure and speed, and the corresponding geometry. Below an example of such a minimal object:

  "type": "FeatureCollection",
  "properties": {},
  "features": [
          "type": "Feature",
          "properties": {
              "departure": 1581166465000,
              "arrival": 1581191106000,
              "duration": 24641000,
              "speed": 42.0
          "geometry": {
              "type": "LineString",
              "coordinates": [[7.294921874999999,54.265224078605684],[3.076171875,54.13669645687002],[-1.318359375,57.9148477670092]]

Note that using our endpoint /route/v2/sea/<coords>/plan yields the best results, since we cap the vessel speed in canals and straights where there are vessel speed restrictions.

All values are expressed in the standard SI units (temperatures in Celcius degrees, humidity, cloud coverage and ice coverage in percentages, pressure in hectopascals, precipitation in millimeters, times in seconds, distances in meters, speeds in meters per second, salinity in PSU).

Click Try It! to start a request and see the response here!