DAdatalastic
Sea Routes

Calculate sea route between two points

Changed on

Calculates the optimal navigable sea route between two points. Each endpoint can be given as coordinates, a port UUID, or a port UN/LOCODE. Returns a GeoJSON LineString with waypoints and the total distance in nautical miles.

Uses the extended base URL https://api.datalastic.com/api/ext/.

Credit cost: 1 credit per request. Requires an Add-Ons plan tier.

get/api/ext/route

Request

Query parameters

port_unlocode_fromstring

Origin port UN/LOCODE (alternative to lat_from/lon_from).

port_uuid_fromstring uuid

Origin port UUID (alternative to lat_from/lon_from).

lat_fromnumber float

Origin latitude.

lon_fromnumber float

Origin longitude.

port_unlocode_tostring

Destination port UN/LOCODE (alternative to lat_to/lon_to).

port_uuid_tostring uuid

Destination port UUID (alternative to lat_to/lon_to).

lat_tonumber float

Destination latitude.

lon_tonumber float

Destination longitude.

Response

Calculated route with waypoints and total distance.

Example response

{
  "meta": {
    "duration": 0.012,
    "endpoint": "/api/v0/vessel",
    "success": true,
    "next": "00e32b7a-4067-d6b2-8d73-2bdda4fe72bb"
  }
}

Changes

  • a29cf323d1c3Revision changes
    • warning

      deleted the query request parameter api-key

    • info

      added the new optional query request parameter port_uuid_from

    • info

      added the new optional query request parameter port_uuid_to

    • info

      added the media type application/json for the response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property / to the response with the status

  • 0b2f634e7f91Revision changes
    • info

      endpoint added