[GET] /port-insight/statistics/ship-type-sizes

지정한 기간 동안 선종 사이즈별(Ship Type Size) 통계 정보를 반환하는 API입니다. 제공되는 통계에는 항구로 이동 중인 선박 수, 접안 대기 선박 수, 접안 중인 선박 수, 평균 대기 시간, 평균 작업 시간, 도착 선박 수, 출항 선박 수가 포함됩니다.

Swagger 문서 바로가기

인증 방법

Port Insight Statistics API는 사용자 인증을 위해 Swagger UI에서 Basic Authorize 인증 방식을 제공합니다.

인증 절차는 다음과 같습니다:

우측 상단의 [Authorize] 버튼을 클릭합니다.

팝업 창에 제공받은 인증 정보(아이디, 비밀번호)를 입력합니다.

입력 후 다시 [Authorize] 버튼을 클릭하여 인증을 진행합니다.

인증이 완료되면 [Close] 버튼을 클릭하여 인증 창을 닫습니다.

Swagger UI에서 호출되는 모든 API 요청에 인증 토큰이 자동으로 포함되어 전송됩니다.

요청 정보

Request URL : [GET] https://insight.seavantage.com/api/port-insight/statistics/ship-type-sizes

실행 순서

Swagger 문서에 접속한 후, 우측 상단의 Select a definition 메뉴에서 Port Insight 를 선택합니다.

/port-insight/statistics/ship-type-sizes 경로로 이동합니다.

[Try it out] 버튼을 클릭하여 입력창을 활성화합니다.

아래 요청 Parameters 조건에 따라 결과가 반환됩니다.

•

portId

◦

SeaVantage에서 발급한 고유 항구 식별자 (Port ID)

◦

[GET] /port API를 통해 확인 가능

•

from

◦

조회 시작 일시 (UTC 기준)

◦

예 : 2025-01-01T00:00:00Z

•

to

◦

조회 종료 일시 (UTC 기준)

◦

예 : 2025-01-01T00:00:00Z

•

shipTypeBySizes

◦

선종 사이즈 리스트 필터 (선종별 사이즈 분류표 참고)

◦

복수 입력 가능

[Execute] 버튼 클릭합니다.

 응답 영역에서 등록 결과를 확인합니다.

응답 정보

요청이 성공하거나 실패했을 때 공통적으로 아래와 같은 형식으로 응답이 반환됩니다.

응답 예시

{
  "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

부록

선종별 사이즈 분류

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

Chemical Tanker

분류 코드	선박 유형	분류 설명
CHEMICAL_TANKER01	Product 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

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

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