Route Planner API
The shortest sea route and distance between any two points
Overview
Route Planner - the Distance service in the API - calculates the shortest navigable sea route between two points and returns it with the distance. The API response is returned in GeoJSON format.
Returned in each response
- Coordinates of the route path
- Straits and canals crossed
- Total distance
- Distance sailed inside ECA zones, stated separately
Controlling the route
- Canals are excluded unless you permit them. Eleven canals, straits and passages, including Suez, Panama, Kiel, Malacca and the Oresund, are closed by default and must be named in the request. Other straits, such as the Bosporus, are always open. A route calculated without them will be returned successfully - it will simply take the long way round.
- ECA zones can be permitted, avoided, or kept to a minimum, so the route can be optimised for compliance cost rather than distance alone.
Credits
This is a credit-based service. Buy a package of credits and spend them across any credit-based service:
Vessels,
PortCalls,
Expected Arrivals,
MasterData,
Distance.
A request that returns no route costs nothing.
Credits are valid for 12 months, and every purchase resets the expiry across your entire balance. An account that keeps topping up does not lose credits.
The service charges 1 credit per route returned.
Credit Prices
- 5,000 credits: 175 EUR
- 10,000 credits: 330 EUR
- 20,000 credits: 625 EUR
- 50,000 credits: 1470 EUR
All credits are valid for 12 months after purchase.
Prices do not include VAT.
Sample use cases
1) Voyage estimate between two ports. One call returns the route, its waypoints and the total distance - 1 credit.
2) Distance remaining on a live voyage. Take the vessel's current position from Vessel Positions, and calculate the route from there to the discharge port - 1 credit for the route.
Full parameters, response fields and sample requests are in the API documentation.
For pricing, data samples or a trial, contact us.