Get vessel future positions from coordinates

Retrieve a vessel’s estimated future route between two coordinate pairs from the Terminal49 API, with one-minute spacing on returned position timestamps.

GET /vessels/{id}/future_positions_with_coordinates

Get vessel future positions from coordinates

cURL

curl --request GET \
  --url https://api.terminal49.com/v2/vessels/{id}/future_positions_with_coordinates \
  --header 'Authorization: <api-key>'

200

{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "attributes": {
      "name": "<string>",
      "imo": "<string>",
      "mmsi": "<string>",
      "latitude": 123,
      "longitude": 123,
      "nautical_speed_knots": 123,
      "navigational_heading_degrees": 123,
      "position_timestamp": "2023-11-07T05:31:56Z",
      "positions": [
        {
          "latitude": 123,
          "longitude": 123,
          "timestamp": "2023-11-07T05:31:56Z",
          "estimated": true,
          "heading": 123
        }
      ]
    }
  },
  "links": {
    "self": "<string>"
  }
}

Authorizations

Authorization · string · header · required

Use a Terminal49 API key in the Authorization header with the Token prefix.

Authorization: Token YOUR_API_KEY

Path Parameters

id · string · required

Query Parameters

port_id · string<uuid> · required

The destination port id

previous_port_id · string<uuid> · required

The previous port id

latitude · number · required

Starting latitude coordinate

longitude · number · required

Starting longitude coordinate

Response

200

application/json

OK

data · Vessel with positions model · object

Show child attributes

links · object

Show child attributes