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.
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.
Dates
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 (departureDateTime and arrivalDateTime) or the unix time in milliseconds (departure and arrival).
Response
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.