Warning :
this endpoint is a beta version, input and output contracts might change.
This endpoint returns the historical route of a given vessel between two ports leaving the first port after a given date. The historical route searched is built from the historical AIS positions of the vessel.
Vessel information
The vessel can be identified either by its imo
number or its mmsi
. In the case both are given, the mmsi
will be taken into account.
Origin, destination and date.
This endpoint takes two UNLOCODE port locations (fromLocode
and toLocode
, both required) and a date (leavesAfterDateTime
(ISO 8601 format) or leavesAfter
(unix time in milliseconds)).
Response
The response is a Geojson FeatureCollection
. The route is represented as a Feature
: its geometry is a MultiLineString (cut at the antimeridian if crossed) and its properties give information about the route (distance, areas crossed, average speed).
Total distance + distances in Seca zones and HRA are returned.
Note that the average speed is computed for the entire trace. If the vessel stops multiple days, the average speed can be low.