지정한 두 지점 간의 최적 항로 정보를 조회하는 API입니다.
인증 방법
Route API는 사용자 인증을 위해 Swagger UI에서 Basic Authorize 인증 방식을 제공합니다.
인증 절차는 다음과 같습니다:
1.
우측 상단의 [Authorize] 버튼을 클릭합니다.
2.
팝업 창에 제공받은 인증 정보(아이디, 비밀번호)를 입력합니다.
3.
입력 후 다시 [Authorize] 버튼을 클릭하여 인증을 진행합니다.
4.
인증이 완료되면 [Close] 버튼을 클릭하여 인증 창을 닫습니다.
Swagger UI에서 호출되는 모든 API 요청에 인증 토큰이 자동으로 포함되어 전송됩니다.
요청 정보
요청 정보
Request URL : [POST] https://insight.seavantage.com/api/route/point-to-point
실행 순서
1.
2.
/route/point-to-point 경로로 이동합니다.
3.
[Try it out] 버튼을 클릭하여 입력창을 활성화합니다.
4.
아래 요청 Parameters 조건에 따라 입력합니다.
5.
[Execute] 버튼을 클릭합니다.
6.
하단 응답 영역에서 등록 결과를 확인합니다.
Request body 예시
{
"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
복사
필드 설명
•
startDateTime
•
•
routeMethod: 라우팅 설정 기준
◦
distance: 최단 거리 우선
◦
time: 최단 시간 우선
◦
frequency: 최대 빈도 우선
•
debug
•
maxSpeed: 최대 속도 (knot 단위)
•
requestedArrivalDateTime
•
options.eca: 배출 규제 구역(ECA) 옵션
1.
구역 내 최단거리 이동
2.
무시하고 이동
3.
회피하여 이동
•
options.hra: 고위험 지역(HRA) 옵션
1.
구역 내 최단거리 이동
2.
무시하고 이동
3.
회피하여 이동
•
options.jwc: 전쟁 위험 지역(JWC) 옵션
1.
구역 내 최단거리 이동
2.
무시하고 이동
3.
회피하여 이동
•
options.cyclone: 태풍 옵션
1.
구역 내 최단거리 이동
2.
무시하고 이동
3.
회피하여 이동
•
options.avoid: 회피 운하 선택
◦
88f3f52e-2b8a-11e9-8abd-54802853d888: 수에즈 운하
◦
3f298f0e-2b89-11e9-8abd-54802853d888: 파나마 운하
◦
7addce3a-5927-11ea-87d0-54802853d888: 키엘 운하
•
options.frequencyPercentage: 빈도 기반 경로 탐색 시 적용 비율
•
options.speedType: 속도 설정
◦
top: 최고 속도
◦
average: 평균 속도
◦
upper10: 상위 10% 속도
◦
lower10: 하위 10% 속도
•
options.validAreaAngle
•
options.startNodeCount
•
wayPoints.no
•
wayPoints.name
•
wayPoints.latitude: 위도
•
wayPoints.longitude: 경도
•
wayPoints.seaStayHours
•
wayPoints.portStayHours
응답 정보
응답 예시
{
"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
복사
응답 필드 상세 설명
응답 항목별 정의
필드명 | 예시 값 | 설명 |
code | 200 | 응답 상태 코드 (HTTP status code와 동일하게 사용됨)
(아래 별도 응답 상태 코드표 참조) |
message | success | 응답 메시지 (상태에 따른 설명) |
error | false | 오류 여부
true: 오류 발생
false: 정상 처리 |
timestamp | 2025-05-14T01:09:00.834665213 | 응답 생성 시각 (UTC 기준) |
response | Object | 예상 항적 존재시 Object 반환 |
응답 코드 종류
코드 | 설명 |
200 | 정상 처리 (Success) |
400 | 잘못된 파라미터 (Bad request) |
401 | 인증 필요 (Unauthorized) |
403 | 권한 없음 (Forbidden) |
422 | 처리 불가 (Unprocessable entity) |
429 | 요청 과다 (Too many requests, 분당 100회 초과 호출 시 발생) |
응답 객체 상세 설명
Depth 1 필드 설명 (response 객체)
geojson을 반환합니다.
필드명 | 예시 값 | 설명 | 데이터 타입 |
type | Feature | 선의 유형 | varchar |
Depth 2 필드 설명 (geometry 객체)
필드명 | 예시 값 | 설명 | 데이터 타입 |
coordinates | [0.1] | 항로 좌표점 목록 | double precision |
type | string | ||
emptyCoordinate | true | boolean |
Depth 3 필드 설명 (properties 객체)
필드명 | 예시 값 | 설명 | 데이터 타입 |
distanceHra | 0.1 | 고위험 지역 통과 거리 | double precision |
startDateTime | 2026-07-21T13:55:09.466Z | 출발 시간
(선박 위치 정보 마지막 수신 시간) | timestamp |
hours | 0.1 | 총 걸린 시간 | double precision |
portStayHours | 0.1 | 항구에서 머무는 시간 | double precision |
arrivalName | string | 도착 지점 항구 portId | varchar |
startNo | 0 | 출발 지점 Way Point 번호 | integer |
distance | 0.1 | 거리 | double precision |
startName | string | 출발 지점 선박 IMO | varchar |
maxSpeed | 17 | 대상 속도 (knot) | double precision |
seaStayHours | 0.1 | 해상에서 머무는 시간 | double precision |
arrivalDateTime | 2026-07-21T13:55:09.466Z | PTA (예상 도착 시간) | timestamp |
requestedArrivalDateTime | 2026-06-30T23:59:59Z | ||
originalArrivalDateTime | 2026-07-21T13:55:09.466Z | ||
speedAdjustmentFactor | 0.1 | ||
courseHours | 0.1 | 출발지 ~ 도착지 항해 시간 | double precision |
distanceEca | 0.1 | 배출 규제 구역 통과 거리 | double precision |
distanceJwc | 0.1 | 전쟁 위험 지역 통과 거리 | double precision |
arrivalNo | 0 | 도착 지점 Way Point 번호 | integer |
Depth 4 필드 설명 (atNoonPoints 객체)
필드명 | 예시 값 | 설명 | 데이터 타입 |
dateTime | 2026-07-21T13:55:09.466Z | 정오 시간 | timestamp |
longitude | 0.1 | 경도 | double precision |
latitude | 0.1 | 위도 | double precision |
Depth 5 필드 설명 (planPoints 객체)
필드명 | 예시 값 | 설명 | 데이터 타입 |
speed | 0.1 | 속도 (knot) | integer |
dateTime | 2026-07-21T13:55:09.466Z | 예상 시간 | timestamp |
longitude | 0.1 | 경도 | double precision |
latitude | 0.1 | 위도 | double precision |
eca | true | ECA에 위치 여부 | boolean |
hra | true | HRA에 위치 여부 | boolean |
jwc | true | JWC에 위치 여부 | boolean |
부록
선종별 사이즈 분류
Bulk Carrier
분류 코드 | 선박 등급 | 하한 (DWT) | 상한 (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
분류 코드 | 선박 등급 | 하한 (DWT) | 상한 (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
분류 코드 | 선박 유형 | 분류 설명 |
CHEMICAL_TANKER01 | Chemical Tanker | Chemical tanker, combined chemical and oil tanker |
Container
분류 코드 | 선박 등급 | 하한 (TEU) | 상한 (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
분류 코드 | 선박 등급 | 하한 (Gross Tonnes) | 상한 (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
분류 코드 | 선박 등급 | 하한 (Gross Tonnes) | 상한 (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)
분류 코드 | 선박 등급 | 하한 (Gross Tonnes) | 상한 (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
분류 코드 | 선박 등급 | 하한 (Gross Tonnes) | 상한 (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
분류 코드 | 선박 유형 | 분류 설명 |
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
분류 코드 | 선박 유형 |
PRODUCT_TANKER01 | Product Tanker |
Tug
분류 코드 | 선박 유형 |
TUG01 | Tug |
FPSO
분류 코드 | 선박 유형 | 분류 설명 |
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
분류 코드 | 선박 유형 |
ETC01 | ETC All |