This endpoint returns the historical trace of a given vessel between two dates in the past. The successive positions of the vessel are retrieved from AIS and processed to determine the geometry and route statistics.
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.
This endpoint takes two dates for the beginning and the end of the trace. Both are required and can be passed using the ISO 8601 format (
arrivalDateTime) or the unix time in milliseconds (
The response is a Geojson
FeatureCollection. The trace 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.