Datalastic Maritime API Logo

Ship Sea Route API for Maritime Route Planning

AIS Tracking

Ship Sea Route API for Maritime Route Planning

Need to find the best path from one port to another? Or from a precise coordinate at sea to a port halfway across the globe? The Global Ship Sea Route API makes that simple, fast, and reliable.

Whether you’re tracking container ships or planning full voyages, this API helps maritime companies calculate optimized sea routes with precision and flexibility.

What Is the Sea Route API?

The Sea Route API allows you to calculate the maritime route between two points on the globe, either between ports or between specific geographic coordinates (latitude and longitude). This makes it a powerful tool for ship tracking, maritime logistics, and operational planning.

  • Coordinates (latitude & longitude)

  • Port identifiers like UUIDs or UNLOCODEs

This flexibility makes the API fit a wide range of maritime uses, from logistics and route planning to real-time fleet tracking.

Example Use Cases:

  • Logistics planning: Calculate optimal shipping distances between your departure port and the destination to estimate fuel cost or voyage time.

  • Port call predictions: Estimate when a vessel will reach a specific port based on current location and typical route.

  • Historical analysis: Recreate common trade routes between high-volume ports like Rotterdam (NLRTM) and Singapore (SGSIN).

How to Use It: Calculating a Ship Sea Route

To calculate a route, you need to provide the starting point and the destination point. The API accepts these parameters:

1. Option 1: By Coordinates:

lat_from, lon_from – Latitude and longitude of the origin point
lat_to, lon_to – Latitude and longitude of the destination point

2. Option 2: By Port Identifiers:

port_uuid_from, port_unlocode_from – Origin port UUID or UNLOCODE
port_uuid_to, port_unlocode_to – Destination port UUID or UNLOCODE

    Examples of Global Ship Route API Requests

    1. Route Between Ports Using UNLOCODEs:

    https://api.datalastic.com/api/sandbox/route?api-key=[API_KEY]&port_unlocode_from=FIHEL&port_unlocode_to=EETLL

    2. Route From a Port to Geographic Coordinates:

    https://api.datalastic.com/api/sandbox/route?api-key=[API_KEY]&port_unlocode_from=FIHEL&lat_to=33.7&lon_to=-119

    How the Sea Route API Works: Supported Parameters and API Response

    The API returns a clean GeoJSON response, which makes it easy to integrate into mapping tools and dashboards.

    You can define the origin and destination using any combination of the following:

    • lat_from, lon_from — Start coordinates

    • lat_to, lon_to — End coordinates

    • port_uuid_from, port_uuid_to — Port UUIDs

    • port_unlocode_from, port_unlocode_to — Port UN/LOCODEs

    You only need one origin and one destination, using any format.

    Sample Global Ship Sea Route API Response:

    The response includes three GeoJSON objects:

    • from – Starting point (port or coordinate)

    • route – The LineString with all route coordinates

    • to – Ending point (port or coordinate)

    {
     "data": {
     "from": {
     "type": "Feature",
     "geometry": {
     "type": "Point",
     "coordinates": [24.9445, 60.1685]
     },
     "properties": {
     "type": "Port",
     "port_name": "HELSINKI",
     "port_uuid": "7d9ba108-52b4-47d7-a74d-13d4e1a80a51",
     "port_unlocode": "FIHEL"
     }
     },
     "route": {
     "type": "Feature",
     "geometry": {
     "type": "LineString",
     "coordinates": [[24.9445, 60.1685], …, [-119, 33.7]]
     },
     "properties": {
     "total_dist": 16357.2518
     }
     },
     "to": {
     "type": "Feature",
     "geometry": {
     "type": "Point",
     "coordinates": [-119, 33.7]
     },
     "properties": {
     "type": "Coordinate Point"
     }
     }
     },
     "meta": {
     "duration": 0.070373595,
     "endpoint": "/api/sandbox/route",
     "success": true
     }
    }

    Start Navigating with the Global Ship Sea Route API Today

    The Global Ship Sea Route API takes the complexity out of plotting maritime paths. It’s:

    • Fast: responds in milliseconds

    • Flexible: supports both ports and coordinates

    Plug it into your system, test it out, and simplify sea route planning today.

    Read Other Maritime Articles 

    Maritime Weather API: Current and Hourly Data

    Maritime Weather API: Current and Hourly Data

    If you've ever tried to bolt weather data onto a shipping or logistics tool, you know the annoying part isn't the weather data itself. It's that marine conditions and atmospheric conditions usually come from two different providers with two different schemas, and...

    AIS Spoofing in the Red Sea: What’s Really Happening

    AIS Spoofing in the Red Sea: What’s Really Happening

    A cargo ship off Yanbu suddenly reports a position it couldn’t possibly have reached. Its speed jumps to 45 knots, far beyond what a loaded tanker can realistically do. Minutes later, the signal disappears. Hours after that, the vessel reappears somewhere else...

    How To Use ChatGPT To Track Ships in Real Time?

    How To Use ChatGPT To Track Ships in Real Time?

    Tracking ships using ChatGPT is possible and an easy process when it is connected to a live maritime data source such as Datalastic. On its own, ChatGPT does not maintain a live database of ship positions. It may know general information about vessels, shipping...

    How to Connect Datalastic to Claude and ChatGPT?

    How to Connect Datalastic to Claude and ChatGPT?

    Connecting Datalastic to Claude and ChatGPT is an easy and fast process that you'll be surprised by it, following this tutorial. By connecting Datalastic through its Model Context Protocol (MCP) server, you can give AI assistants direct access to real-time maritime...

    Find Vessels In The Gulf Of Oman

    Find Vessels In The Gulf Of Oman

    Tracking vessels in the Gulf of Oman is essential for understanding maritime traffic in one of the world’s most strategically important shipping corridors. This region connects the Arabian Sea with the Strait of Hormuz, acting as a gateway for global oil shipments,...

    Enterprise Vessel Tracking API

    Enterprise Vessel Tracking API

    An enterprise vessel tracking API is not defined by features alone. It is defined by scale, reliability, and the ability to perform under real-world pressure. In maritime operations, where systems rely on continuous data flows, even small inefficiencies can quickly...