This endpoint is used to compute the Estimated Time of Arrival of any vessel.

Request

To compute the ETA of a vessel, we need information concerning the vessel, the departure (optional) and the arrival. These 3 elements are present in the request in 3 different fields.

It will allow you to compute the ETA of a vessel from the vessel position to a port or from a port to another port.

Vessel

To identify the vessel, you can use the IMO (International Maritime Organization) or the MMSI (Maritime Mobile Service Identity).

You can optionally set the vessel speed to use for computation, in nautical miles per hour. The maximum speed is 25.0

Departure

By default, the ETA is computed with the latest known position of the vessel as departure (time and position). The API allows you to compute an ETA of a vessel from a port to another port. In that case, you must use the field departure to define the departure port code and the departure date time (ISO 8601 format).

Note that you can't define a departure date time in case of vessel position to port ETA computation.

Arrival

Arrival field is used to define to where the eta must be computed. You need to indicate the port code of the arrival.

Response

You will find the response of the ETA in the field named arrivalTime in format ISO 8601

You will also find the confidence of the result which is a value from 1 to 5, 5 means high confidence.

You will also find the remaining distance which is in nautical miles

The fields from the request will also be added in the response.

Examples

You can find below 2 examples of payloads for the 2 ways to compute the ETA.