Retrieve the optimal voyage route between two specified locations.
  Authentication
The Route API uses Basic Authorization on Swagger UI.
Authentication Steps
1.
Click the [Authorize] button in the top right corner.
2.
Enter the provided username and password in the pop-up window.
3.
Click [Authorize] again to proceed with authentication.
4.
After successful login, click [Close] to close the window.
All API requests from Swagger UI will automatically include the authorization token.
Request Information
Request URL
Request URL : [POST] https://insight.seavantage.com/api/route/point-to-point
Execution Steps
1.
2.
Navigate to the /route/point-to-point endpoint.
3.
Click [Try it out] to activate input fields.
4.
5.
Click the [Execute] button.
6.
View results in the response section.
Request body Example
{
"startDateTime": "2026-06-04T13:22:06Z",
"shipTypeBySize": "CONTAINER01",
"routeMethod": "frequency",
"debug": false,
"maxSpeed": 17,
"requestedArrivalDateTime": "2026-06-30T23:59:59Z",
"options": {
"eca": 0,
"hra": 0,
"jwc": 0,
"cyclone": 0,
"avoid": [
"string"
],
"frequencyPercentage": 0,
"speedType": "string",
"validAreaAngle": 0,
"startNodeCount": 0
},
"wayPoints": [
{
"no": 1,
"name": "Waypoint Name",
"latitude": -90,
"longitude": -180,
"seaStayHours": 0.1,
"portStayHours": 0.1
}
]
}
JavaScript
복사
Field Descriptions
•
startDateTime
•
•
routeMethod: Routing preference
â—¦
distance: Prioritize shortest distance
â—¦
time: Prioritize shortest travel time
â—¦
frequency: Prioritize most frequently traveled route
•
debug
•
maxSpeed: Maximum vessel speed (in knots)
•
requestedArrivalDateTime
•
options.eca: Emission Control Area (ECA) routing option
1.
Take the shortest route through the ECA
2.
Ignore ECA and proceed
3.
Avoid the ECA entirely
•
options.hra: High-Risk Area (HRA) routing option
1.
Take the shortest route through the HRA
2.
Ignore the HRA and proceed
3.
Avoid the HRA entirely
•
options.jwc: Joint War Committee (JWC) routing option
1.
Take the shortest route through the JWC
2.
Ignore the JWC and proceed
3.
Avoid the JWC entirely
•
options.cyclone: Cyclone zone routing option
1.
Take the shortest route through the area
2.
Ignore the cyclone area and proceed
3.
Avoid the cyclone area entirely
•
options.avoid: Canal(s) to avoid during route planning
â—¦
88f3f52e-2b8a-11e9-8abd-54802853d888: Suez Canal
â—¦
3f298f0e-2b89-11e9-8abd-54802853d888: Panama Canal
â—¦
7addce3a-5927-11ea-87d0-54802853d888: Kiel Canal
•
options.frequencyPercentage: Percentage weight applied when using frequency-based routing
•
options.speedType: Speed setting for route estimation
â—¦
top: Maximum speed
â—¦
average: Average speed
â—¦
upper10: Top 10% speed
â—¦
lower10: Bottom 10% speed
•
options.validAreaAngle
•
options.startNodeCount
•
wayPoints.no
•
wayPoints.name
•
wayPoints.latitude: Latitude
•
wayPoints.longitude: Longitude
•
wayPoints.seaStayHours
•
wayPoints.portStayHours
Response Information
Sample Response Format
{
"code": 0,
"message": "string",
"error": true,
"timestamp": "2026-07-21T13:55:09.466Z",
"response": {
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"coordinates": [
[
0.1
]
],
"type": "string",
"emptyCoordinate": true
},
"properties": {
"distanceHra": 0.1,
"atNoonPoints": [
{
"dateTime": "2026-07-21T13:55:09.466Z",
"longitude": 0.1,
"latitude": 0.1
}
],
"startDateTime": "2026-07-21T13:55:09.466Z",
"hours": 0.1,
"portStayHours": 0.1,
"arrivalName": "string",
"startNo": 0,
"distance": 0.1,
"startName": "string",
"maxSpeed": 0.1,
"seaStayHours": 0.1,
"arrivalDateTime": "2026-07-21T13:55:09.466Z",
"requestedArrivalDateTime": "2026-07-21T13:55:09.466Z",
"originalArrivalDateTime": "2026-07-21T13:55:09.466Z",
"speedAdjustmentFactor": 0.1,
"courseHours": 0.1,
"distanceEca": 0.1,
"planPoints": [
{
"speed": 0.1,
"dateTime": "2026-07-21T13:55:09.466Z",
"longitude": 0.1,
"latitude": 0.1,
"eca": true,
"hra": true,
"jwc": true
}
],
"distanceJwc": 0.1,
"arrivalNo": 0
}
}
]
}
}
JSON
복사
Response Field Descriptions
Top-Level Response Fields
Field | Example Value | Description |
code | 200 | Response status code (used in the same way as standard HTTP status codes).
(See the list of codes below for reference.) |
message | success | Response message (description based on status) |
error | false | Error flag
true: error occurred
false: successful processing |
timestamp | 2025-05-14T01:09:00.834665213 | Time of response creation (UTC) |
response | Object | Returns an object if a predicted route exists. |
Response Codes
Code | Description |
200 | Success |
400 | Bad request |
401 | Unauthorized |
403 | Forbidden |
422 | Unprocessable entity |
429 | Too many requests, standard rate limit of 100 requests per minute exceeded |
Detailed Response Description
Depth 1 Field Description (response object)
Returns a GeoJSON object
Field | Example Value | Description | Data Type |
type | Feature | Line type | varchar |
Depth 2 Field Description (geometry object)
Field | Example Value | Description | Data Type |
coordinates | [0.1] | Voyage route coordinates | double precision |
type | string | ||
emptyCoordinate | true | boolean |
Depth 3 Field Description (properties object)
Field | Example Value | Description | Data Type |
distanceHra | 0.1 | Distance through Emission Control Areas (ECA) | double precision |
startDateTime | 2026-07-21T13:55:09.466Z | Departure time (last received vessel position timestamp) | timestamp |
hours | 0.1 | Total elapsed time | double precision |
portStayHours | 0.1 | Time spent at port | double precision |
arrivalName | string | Port ID of the arrival port | varchar |
startNo | 0 | Departure waypoint number | integer |
distance | 0.1 | Distance | double precision |
startName | string | IMO number of the departure vessel | varchar |
maxSpeed | 17 | Target speed (knots) | double precision |
seaStayHours | 0.1 | Time spent at sea | double precision |
arrivalDateTime | 2026-07-21T13:55:09.466Z | PTA: Predicted Time of Arrival | timestamp |
requestedArrivalDateTime | 2026-06-30T23:59:59Z | ||
originalArrivalDateTime | 2026-07-21T13:55:09.466Z | ||
speedAdjustmentFactor | 0.1 | ||
courseHours | 0.1 | Voyage time from departure to arrival | double precision |
distanceEca | 0.1 | Distance through Emission Control Areas (ECA) | double precision |
distanceJwc | 0.1 | Distance through High-Risk Areas (HRA) | double precision |
arrivalNo | 0 | Distance through War Risk Areas (JWC) | integer |
Arrival waypoint number |
Depth 4 Field Description (atNoonPoints object)
Field | Example Value | Description | Data Type |
dateTime | 2026-07-21T13:55:09.466Z | Estimated time | timestamp |
longitude | 0.1 | Longitude | double precision |
latitude | 0.1 | Latitude | double precision |
Depth 5 Field Description (planPoints object)
Field | Example Value | Description | Data Type |
speed | 0.1 | Speed (knots) | integer |
dateTime | 2026-07-21T13:55:09.466Z | Estimated time | timestamp |
longitude | 0.1 | Longitude | double precision |
latitude | 0.1 | Latitude | double precision |
eca | true | Within ECA zone | boolean |
hra | true | Within HRA zone | boolean |
jwc | true | Within JWC zone | boolean |
Appendix
Ship Type by Size Classification
Bulk Carrier
Classification Code | Classification | Lower Range (DWT) | Higher Range (DWT) |
BULK 05 | Handysize | 0 | 34,999 |
BULK 04 | Handymax | 35,000 | 59,999 |
BULK 03 | Panamax | 60,000 | 79,999 |
BULK 02 | Capesize | 80,000 | 179,999 |
BULK 01 | VLBC | 180,000 |
Cargo
Classification Code | Classification | Lower Range (DWT) | Higher Range (DWT) |
CARGO 04 | General Cargo | 0 | 2,999 |
CARGO 03 | General Cargo | 3,000 | 7,499 |
CARGO 02 | General Cargo | 7,500 | 37,999 |
CARGO 01 | General Cargo | 38,000 |
Chemical Tanker
Classification | Vessel Type | Classification |
CHEMICAL_TANKER01 | Chemical Tanker | Chemical tanker, combined chemical and oil tanker |
Container
Classification Code | Classification | Lower Range (TEU) | Higher Range (TEU) |
CONTAINER 07 | Small Feeder | 0 | 1,000 |
CONTAINER 06 | Feeder Containership | 1,001 | 2,000 |
CONTAINER 05 | Feedermax Containership | 2,001 | 3,000 |
CONTAINER 04 | Panamax Containership | 3,001 | 5,100 |
CONTAINER 03 | Post-Panamax Containership | 5,101 | 10,000 |
CONTAINER 02 | Neo-Panamax Containership | 10,001 | 14,500 |
CONTAINER 01 | ULCV Containership | 14,501 |
LNG
Classification Code | Classification | Lower Range (Gross Tonnes) | Higher Range (Gross Tonnes) |
LNG 03 | LNG Gas Carrier | 0 | 73,000 |
LNG 02 | LNG Gas Carrier | 73,001 | 147,000 |
LNG 01 | LNG Gas Carrier | 147,001 |
LPG
Classification Code | Classification | Lower Range (Gross Tonnes) | Higher Range (Gross Tonnes) |
LPG 03 | LPG Gas Carrier | 0 | 4,500 |
LPG 02 | LPG Gas Carrier | 4,501 | 26,000 |
LPG 01 | LPG Gas Carrier | 26,001 |
Pure Car Carrier (PCC)
Classification Code | Classification | Lower Range (Gross Tonnes) | Higher Range (Gross Tonnes) |
PCC 03 | PCC/PCTC | 0 | 35,000 |
PCC 02 | PCC/PCTC | 35,001 | 61,000 |
PCC 01 | PCC/PCTC | 61,001 |
Ro-ro
Classification Code | Classification | Lower Range (Gross Tonnes) | Higher Range (Gross Tonnes) |
RORO 03 | Ro-ro Cargo | 0 | 0 |
RORO 02 | Ro-ro Cargo | 8,501 | 48,000 |
RORO 01 | Ro-ro Cargo | 48,001 |
Tanker
Classification Code | Vessel Type | Classification |
TANKER 05 | Crude Oil Tanker | Tanker- Panamax |
TANKER 04 | Crude Oil Tanker | Tanker- Aframax |
TANKER 03 | Crude Oil Tanker | Tanker- Suezmax |
TANKER 02 | Crude Oil Tanker | Tanker- VLCC |
TANKER 01 | Crude Oil Tanker | Tanker- ULCC |
Product Tanker
Classification | Vessel Type |
PRODUCT_TANKER01 | Product Tanker |
Tug
Classification | Vessel Type |
TUG01 | Tug |
FPSO
Classification | Vessel Type | Classification |
FPSO01 | FPSO | Floating drilling production tanker,
floating gas production,
floating gas storage,
floating LNG production and storage FLNG,
floating power station,
floating production tanker,
floating storage tanker |
ETC
Classification | Vessel Type |
ETC01 | ETC All |