Route Planner API

Maritime RoutePlanner API

Calculate optimal sea routes between any two ports. Get precise distances, ETA predictions, ECA zone tracking, and canal crossings—all in one request.

Start Free Trial Try in Playground

1 Credit per Request

response.json

distance8,432 nm

duration17d 6h

crossingSuez, Malacca

pathPoints14 waypoints

Credits used1 credit

Global

Port Coverage

Gateways Supported

~300nm

Waypoint Spacing

1 Credit

Per Request

Popular Trade Routes

Click to explore route details. Our API calculates optimal paths through major canals and straits.

Route Analysis

From

Rotterdam

Singapore

8,432 nm

Total Distance

17 days

Est. Duration

Canals & Straits

SuezMalacca

Try This Route in Playground →

Complete API Response

Every request returns comprehensive route data including distance, duration, canal crossings, and waypoint coordinates for map visualization.

sample_response.json

{
  "distance": {
    "distance": 8432,
    "unit": "nm"
  },
  "distanceInEca": {
    "distance": 120,
    "unit": "nm"
  },
  "crossing": [
    "Suez Canal",
    "Strait of Malacca"
  ],
  "estimatedArrival": "2026-05-18T14:30:00Z",
  "duration": {
    "years": 0,
    "months": 0,
    "days": 17,
    "hours": 6
  },
  "pathPoints": [
    [
      51.9225,
      4.4792
    ],
    [
      35.9,
      -5.6
    ],
    [
      32.3,
      30.6
    ],
    [
      1.3,
      103.8
    ]
  ]
}

distanceobject

Total route distance in nautical miles along the optimal sea path.

{ "distance": 8432, "unit": "nm" }

distanceInEcaobject

Distance traveled within Emission Control Areas (ECAs). Use this for fuel planning and compliance.

{ "distance": 120, "unit": "nm" }

crossingarray

List of canals and straits the route passes through. Useful for understanding transit fees and restrictions.

["Suez Canal", "Strait of Malacca"]

estimatedArrivalstring

Calculated arrival time in ISO 8601 format, based on departure time and vessel speed provided.

"2026-05-18T14:30:00Z"

durationobject

Voyage duration broken down by time components for easy display.

{ "years": 0, "months": 0, "days": 17, "hours": 6 }

pathPointsarray

Array of [latitude, longitude] coordinates along the route, sampled approximately every 300 nautical miles.

[[51.9225, 4.4792], [51.4, 3.2], ...]

Route Waypoints for Map Visualization

The pathPoints array provides coordinate waypoints sampled approximately every 300 nautical miles along the calculated route. This spacing is optimized to:

Visualize routes accurately — enough points to show the actual path vessels take, including canal transits and strait crossings
Keep response sizes small — typically 10-30 waypoints per route instead of thousands of coordinates
Enable easy integration — use with Mapbox, Leaflet, Google Maps, or any mapping library to draw polylines

Example: Rotterdam to Singapore (8,432 nm)

14 waypoints•~600 nm average spacing•Includes Suez & Malacca transit points

What You Get

One API request, complete route intelligence

Distance

8,432 nm

Precise nautical miles via optimal path

ETA

17d 6h

Based on your specified speed

Crossings

2 canals

Suez Canal, Strait of Malacca

ECA Distance

120 nm

For emissions planning

11 Maritime Gateways

Route through or exclude any major canal or strait using the exclude_gateways parameter

🇪🇬suez

Suez Canal

Middle East

🇵🇦panama

Panama Canal

Americas

🇸🇬malacca

Strait of Malacca

Asia

🇩🇪kiel

Kiel Canal

Europe

🇮🇹messina

Strait of Messina

Europe

🇩🇰oresund

Oresund Strait

Europe

🇨🇱drake

Drake Passage

Americas

🇨🇱magellan

Strait of Magellan

Americas

❄️northeast

Northeast Passage

Arctic

❄️northwest

Northwest Passage

Arctic

🇬🇷corinth

Corinth Canal

Europe

Combine with Vessel Location for Real-Time ETAs

Get the vessel's current position, extract coordinates and speed, then calculate precise arrival predictions that update in real-time.

View Full Workflow

Location → Route → Precise ETA

FAQs

What ports are supported?

The Route Planner supports any port worldwide using UN/LOCODE identifiers. Simply provide the departure and arrival port codes (e.g., NLRTM for Rotterdam, SGSIN for Singapore).

How accurate is the ETA calculation?

ETA is calculated based on the vessel speed you provide and the optimal route distance. The calculation assumes constant speed throughout the voyage. For real-time accuracy, combine with Vessel Location API data.

Can I exclude specific canals or straits?

Yes, use the exclude_gateways parameter with a comma-separated list of gateways to avoid (e.g., "suez,panama"). The API will calculate an alternative route.

What are ECA zones?

Emission Control Areas (ECAs) are designated maritime zones with stricter emission standards. Set eca=avoid to route around these zones for fuel planning purposes.

How are the pathPoints coordinates spaced?

The pathPoints array contains coordinates sampled approximately every 300 nautical miles along the route. This provides enough waypoints to visualize the route on a map while keeping the response size manageable.

Start Planning Maritime Routes

Just 1 credit per request. Global port coverage. Real-time ETA calculations.

Start Free Trial Read Documentation