지정한 기간 동안 선종 사이즈별(Ship Type Size) 통계 정보를 반환하는 API입니다. 제공되는 통계에는 항구로 이동 중인 선박 수, 접안 대기 선박 수, 접안 중인 선박 수, 평균 대기 시간, 평균 작업 시간, 도착 선박 수, 출항 선박 수가 포함됩니다. 통계 데이터는 항구 현지 시간 기준 정오를 기준 일 단위로 집계됩니다.
1. 인증 방법
Port Insight Statistics API는 사용자 인증을 위해 Swagger UI에서 Basic Authorize 인증 방식을 제공합니다.
인증 절차는 다음과 같습니다:
1.
우측 상단의 [Authorize] 버튼을 클릭합니다.
2.
팝업 창에 제공받은 인증 정보(아이디, 비밀번호)를 입력합니다.
3.
입력 후 다시 [Authorize] 버튼을 클릭하여 인증을 진행합니다.
4.
인증이 완료되면 [Close] 버튼을 클릭하여 인증 창을 닫습니다.
Swagger UI에서 호출되는 모든 API 요청에 인증 토큰이 자동으로 포함되어 전송됩니다.
2. 요청 정보
2-1. 요청 정보
Request URL : [GET] https://insight.seavantage.com/api/port-insight/statistics/ship-type-sizes
2-2. 실행 순서
1.
2.
/port-insight/statistics/ship-type-sizes 경로로 이동
3.
[Try it out] 클릭 → 입력창 활성화
4.
아래 요청 Parameters 조건에 따라 결과 반환
•
•
from
◦
조회 시작 일시 (UTC 기준)
◦
예 : 2025-01-01T00:00:00Z
•
to
◦
조회 종료 일시 (UTC 기준)
◦
예 : 2025-01-01T00:00:00Z
•
5.
[Execute] 버튼 클릭
6.
하단 응답 영역에서 등록 결과 확인
3. 응답 정보
요청이 성공하거나 실패했을 때 공통적으로 아래와 같은 형식으로 응답이 반환됩니다.
응답 예시
{
"code": 200,
"message": "OK",
"error": false,
"timestamp": "2024-12-01T12:00:00",
"response": [
{
"localAggregatedAt": "2025-01-01T00:00:00Z",
"aggregatedAt": "2025-01-01T00:00:00Z",
"onTheWayCount": 10.0,
"waitingCount": 10.0,
"workingCount": 10.0,
"avgStopHour": 12.3456,
"avgWaitingHour": 12.3456,
"avgWorkingHour": 12.3456,
"arrivalCount": 10.0,
"berthingCount": 10.0,
"departureCount": 10.0
}
]
}
JavaScript
복사
입력 필드 상세 설명
응답 항목별 정의
필드명 | 예시 값 | 설명 |
code | 200 | 응답 상태 코드 (HTTP status code와 동일하게 사용됨)
(아래 별도 응답 코드표 참조) |
message | "OK" | 응답 메시지 (상태에 따른 설명) |
error | false | 오류 여부
(true: 오류 발생, false: 정상 처리) |
timestamp | "2025-05-14T01:09:00.834665213" | 응답 생성 시각 (UTC 기준) |
response | 배열 또는 빈배열 | 데이터 존재시 배열, 미존재 시 빈배열 |
응답 코드 종류
코드 | 설명 |
200 | 정상 처리 (Success) |
400 | 잘못된 파라미터 (Bad Request) |
401 | 인증 필요 (Unauthorized) |
403 | 권한 없음 (Forbidden) |
422 | 처리 불가 (Unprocessable Entity) |
429 | 요청 과다 (Too Many Requests) |
응답 상세 설명
Depth 1 필드 설명 (response 객체)
필드명 | 예시 값 | 설명 | 데이터 타입 |
localAggregatedAt | 2025-01-01T11:30:00Z | 통계 집계 시각(항구 local time 기준) | timestamp |
aggregatedAt | 2025-01-01T02:30:00Z | 통계 집계 시각(UTC 기준) | timestamp |
onTheWayCount | 10.0 | 데이터 생성 시점 항구로 이동중인 선박 수 | real |
waitingCount | 10.0 | 데이터 생성 시점 항구 접안 대기중인 선박 수 | real |
workingCount | 10.0 | 데이터 생성 시점 항구 접안 선박 수 | real |
avgStopHour | 12.3456 | 대기 영역 바깥쪽에서 발생하는 평균 대기 시간 | real |
avgWaitingHour | 12.3456 | 대기 영역에서 발생하는 평균 대기 시간 | real |
avgWorkingHour | 12.3456 | 평균 작업 시간 | real |
arrivalCount | 10.0 | 24시간 내 도착 선박 수 | real |
berthingCount | 10.0 | 24시간 내 접안 선박 수 | real |
departureCount | 10.0 | 24시간 내 출항 선박 수 | real |
부록
부록 I. 선종별 사이즈 분류
Container
Classification | Lower Range (TEU) | Higher Range (TEU) |
CONTAINER 07 | 0 | 1000 |
CONTAINER 06 | 1001 | 2000 |
CONTAINER 05 | 2001 | 3000 |
CONTAINER 04 | 3001 | 5100 |
CONTAINER 03 | 5101 | 10,000 |
CONTAINER 02 | 10,001 | 14,500 |
CONTAINER 01 | 14,501 |
Bulk Carrier
Classification | Lower Range (DWT) | Higher Range (DWT) |
BULK 05 | 0 | 34,999 |
BULK 04 | 35,000 | 59,999 |
BULK 03 | 60,000 | 79,999 |
BULK 02 | 80,000 | 179,999 |
BULK 01 | 180,000 |
Cargo
Classification | Lower Range (DWT) | Higher Range (DWT) |
CARGO 04 | 0 | 2,999 |
CARGO 03 | 3,000 | 7,499 |
CARGO 02 | 7,500 | 37,999 |
CARGO 01 | 38,000 |
Ro-ro
Classification | Lower Range (Gross) | Higher Range (Gross) |
RORO 03 | 0 | 8,500 |
RORO 02 | 8,501 | 48,000 |
RORO 01 | 48,001 |
Pure Car Carrier (PCC)
Classification | Lower Range (Gross) | Higher Range (Gross) |
PCC 03 | 0 | 35,000 |
PCC 02 | 35,001 | 61,000 |
PCC 01 | 61,001 |
LNG
Classification | Lower Range (Gross) | Higher Range (Gross) |
LNG 03 | 0 | 73,000 |
LNG 02 | 73,001 | 147,000 |
LNG 01 | 147,001 |