Vessel Future Positions by Coordinates

Get vessel future positions from coordinates

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

import requests

url = "https://api.terminal49.com/v2/vessels/{id}/future_positions_with_coordinates"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.terminal49.com/v2/vessels/{id}/future_positions_with_coordinates', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.terminal49.com/v2/vessels/{id}/future_positions_with_coordinates",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.terminal49.com/v2/vessels/{id}/future_positions_with_coordinates"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.terminal49.com/v2/vessels/{id}/future_positions_with_coordinates")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "type": "vessel",
    "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>"
  }
}

{
  "errors": [
    {
      "status": "403",
      "title": "Forbidden",
      "detail": "Routing data feature is not enabled for this account"
    }
  ]
}

GET

vessels

{id}

future_positions_with_coordinates

Get vessel future positions from coordinates

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

import requests

url = "https://api.terminal49.com/v2/vessels/{id}/future_positions_with_coordinates"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.terminal49.com/v2/vessels/{id}/future_positions_with_coordinates', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.terminal49.com/v2/vessels/{id}/future_positions_with_coordinates",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.terminal49.com/v2/vessels/{id}/future_positions_with_coordinates"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.terminal49.com/v2/vessels/{id}/future_positions_with_coordinates")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "type": "vessel",
    "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>"
  }
}

{
  "errors": [
    {
      "status": "403",
      "title": "Forbidden",
      "detail": "Routing data feature is not enabled for this account"
    }
  ]
}

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

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

data

Vessel with positions model · object

Show child attributes

links

object

Show child attributes

Get vessel future positions

Get a terminal

⌘I

Tracking Requests

Shipments

Containers

Documents

Email Submissions

Document Schemas

Document Representations

Search

Webhooks

Webhook Notifications

Custom Field Definitions

Custom Field Options

Custom Fields

Shipping Lines

Metro Areas

Ports

Vessels

Terminals

Parties

Get vessel future positions from coordinates

Authorizations

Path Parameters

Query Parameters

Response