1. Home
  2. Track and Port Handling
  3. Basics
  4. Get historical track for a ship

Get historical track for a ship

To get a historical track for a ship use the following API operation:

POST /ship/historical/track

The payload for the request must define the start and end date of the track, as well as info about the ship (like MMSI, name etc.) and a desired resolution of the generated track. Sending the request an ID will be returned, that will be used to retrieve the data.

GET /ship/historical/track/<request ID>

The result will contain the historical track defined by a geoJSON-X LineString plus the distance (in meters) the ship has traveled.

Notice that the operation may take several seconds to complete and thus the POST will return a HTTP code 202 to indicate the operation is in progress, the subsequent GET operation will also return HTTP code 202 until the operation is completed. GET will then return HTTP code 200 along with the result. Further more the result will automatically be deleted after the GET operation has responded with HTTP code 200. Thus it is not required for the client to issue the DELETE request.

For usage example seeĀ Get historical track.