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.

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