[GET] /fleet

이 API는 Fleet에 등록된 선박 목록의 선박 제원 정보와 실시간 시간 위치 정보를 조회할 수 있습니다. 또한, Seavantage가 분석한 예측 도착 시간(PTA, Predicted Time of Arrival)도 함께 제공합니다.

Swagger 문서 바로가기

인증 방법

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

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

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

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

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

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

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

선박 위치 정보 조회

요청 정보

Request URL : [GET] https://insight.seavantage.com/api/fleet

실행 순서

Swagger 문서에서 우측 상단의 Select a definition 메뉴에서 Fleet 을 선택합니다.

/fleet 경로로 이동합니다.

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

아래 요청 Parameters 조건에 따라 입력합니다.

•

미입력 : 워크스페이스에 등록된 전체 선박 조회

•

categoryId만 입력: 해당 메뉴에 등록된 선박 목록 조회

◦

categoryId: UUID 형식의 값

◦

categoryId 추가 및 확인을 원하실 경우 cx@seavantage.com 으로 문의

•

shipId만 입력: 해당 선박만 조회

◦

shipId: /ship/search API를 통해 확인할 수 있는 UUID 형식의 값

•

categoryId + shipId 입력: 해당 카테고리 내 지정된 선박만 조회

[Execute] 버튼을 클릭합니다.

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

응답 정보

응답 예시

{
  "code": 200,
  "message": "success",
  "error": false,
  "timestamp": "2025-05-20T10:58:44.269119315",
  "response": [
    {
      "ship": {
        "shipId": "aaa9dcf0-6af2-4f89-a6d5-c25594ed9837",
        "imoNo": "9637076",
        "mmsi": "538005248",
        "callSign": "V7CD9",
        "shipName": "ARDMORE SEAVANTAGE",
        "shipAliasName": null,
        "shipType": "PRODUCT_TANKER",
        "shipTypeBySize": "PRODUCT_TANKER01",
        "shipTypeCargo": "product tanker",
        "built": 2014,
        "dwt": 49997,
        "hullType": "Double Hull",
        "gt": 30030,
        "builtBy": "SPP Shipbuilding Company Limited",
        "builtAt": "Sacheon",
        "loa": 183,
        "depth": 19.1,
        "maxDraught": 13.08,
        "engineBuiltBy": "Doosan Engine Company Limited",
        "designedBy": "B&W Diesel A/S",
        "serviceSpeed": null,
        "nationCode": "MH",
        "breadth": 32.2,
        "teuCapacity": null,
        "liquidCapacity": null,
        "destinationPortId": null,
        "pta": null,
        "ptb": null,
        "destinationTerminalName": null,
        "destinationUnlocode": null,
        "destinationPortName": null
      },
      "position": {
        "imoNo": "9637076",
        "mmsi": "538005248",
        "deviceType": "AIS",
        "callSign": "V7CD9",
        "shipName": "ARDMORE SEAVANTAGE",
        "aisShipType": 80,
        "aisDimA": 150,
        "aisDimB": 33,
        "aisDimC": 8,
        "aisDimD": 24,
        "aisEta": "07092000",
        "aisDestination": "USBOS",
        "staticDateTime": "2025-07-08T22:22:56Z",
        "timestamp": "2025-07-08T22:34:18Z",
        "aisClass": "A",
        "nvgStatus": 0,
        "rateOfTurn": 0,
        "speedOverGround": 11.899999618530273,
        "positionAccuracy": 0,
        "longitude": -70.946235,
        "latitude": 40.47621333,
        "courseOverGround": 132.5,
        "trueHeading": 136,
        "elapsed": 0,
        "utcSecond": 16,
        "dte": 0,
        "specialManeuverIndicator": "0",
        "raimFlag": "0",
        "staticMessageNo": 5,
        "locationMessageNo": 1,
        "aisMaxDraught": 8.5
      },
      "categoryIds": "123e4567-e89b-12d3-a456-426614174000"
    }
  ]
}
JavaScript
복사

응답 필드 상세 설명

응답 항목별 정의

필드명	예시 값	설명
code	200	응답 상태 코드 (HTTP status code와 동일하게 사용됨) (아래 별도 응답 상태 코드표 참조)
message	success	응답 메시지 (상태에 따른 설명)
error	false	오류 여부 true: 오류 발생 false: 정상 처리
timestamp	2025-05-15T10:56:59.034880881	응답 생성 시각 (UTC 기준)
response	배열 또는 빈배열	선박 존재시 배열, 미존재시 빈배열

응답 코드 종류

코드	설명
200	정상 처리 (Success)
400	잘못된 파라미터 (Bad request)
401	인증 필요 (Unauthorized)
403	권한 없음 (Forbidden)
422	처리 불가 (Unprocessable entity)
429	요청 과다 (Too many requests)

응답 상세 설명

Depth 1 필드 설명 (ship 객체)

필드명	예시 값	설명	데이터 타입
shipId	aaa9dcf0-6af2-4f89-a6d5-c25594ed9837	SeaVantage 자체 선박 고유 아이디	varchar(36) - UUID
imoNo	9637076	선박 IMO 등록번호	varchar(10)
mmsi	538005248	선박 고유 식별 번호	varchar(10)
callSign	V7CD9	호출부호	varchar(7)
shipName	ARDMORE SEAVANTAGE	선명	varchar(100)
shipAliasName	null	선박 별칭	varchar(36)
shipType	PRODUCT_TANKER	선종 (아래 AIS Ship Type 표 참고)	varchar(36)
shipTypeBySize	PRODUCT_TANKER01	선종/사이즈 (아래 AIS Ship Type 표 참고)	varchar(36)
shipTypeCargo	product tanker	선박 화물 종류	varchar(50)
built	2014	건조년도	smallint
dwt	49997	총재화중량	integer
hullType	Double Hull	선형 종류	varchar(36)
gt	30030	총 톤수	integer
builtBy	SPP Shipbuilding Company Limited	건조 회사	varchar(200)
builtAt	Sacheon	건조 위치	varchar(50)
loa	183	전체 길이	real
depth	19.1	전체 깊이	real
maxDraught	13.08	최대 흘수	real
engineBuiltBy	Doosan Engine Company Limited	엔진 제작사	varchar(200)
designedBy	B&W Diesel A/S	엔진 설계사	varchar(200)
serviceSpeed	null	운항속도 (knots)	real
nationCode	MH	국적	varchar(3)
breadth	32.2	선박 너비	real
teuCapacity	null	TEU 용량	integer
liquidCapacity	null	액체 용량	integer
destinationPortId	9cca705a-a39c-47b9-9a30-629731c80b41	내부적으로 사용하는 port 구분 값	varchar(36) - UUID
pta	2025-05-12T00:00:00Z	Predicted Time of Arrival (씨벤티지)	timestamp
ptb	2025-05-12T00:00:00Z	Predicted Time of Berth (씨벤티지)	timestamp
destinationTerminalName	KAO MING TERMINAL (W108-W111)	목적지 터미널명	varchar(128)
destinationUnlocode	TWKHH	목적지 UNLOCODE	varchar(36)
destinationPortName	Kaohsiung	목적지 항구명	varchar(255)

Depth 2 필드 설명 (position 객체)

필드명	예시 값	설명	데이터 타입
imoNo	9637076	선박 IMO 등록번호	varchar(20)
mmsi	538005248	선박 고유 식별 번호	varchar(20)
deviceType	AIS	AIS 장비 타입	varchar(36)
callSign	V7CD9	UTC 기준 응답 받은 시간	varchar(7)
shipName	ARDMORE SEAVANTAGE	선명	varchar(36)
aisShipType	80	AIS로부터 수신된 선종 타입 (아래 AIS Ship Type 표 참고)	smallint
aisDimA	150	GPS 안테나로부터 선수까지의 거리 (아래 AIS Dimension 그림 참고)	smallint
aisDimB	33	GPS 안테나로부터 선수까지의 거리 (아래 AIS Dimension 그림 참고)	smallint
aisDimC	8	GPS 안테나로부터 선수까지의 거리 (아래 AIS Dimension 그림 참고)	smallint
aisDimD	24	GPS 안테나로부터 선수까지의 거리 (아래 AIS Dimension 그림 참고)	smallint
aisEta	05151000	AIS 예상 도착 시간	varchar(8)
aisDestination	HOUSTON FOR ORDER	AIS 목적지	varchar(32)
staticDateTime	2025-01-01T22:22:56Z	정적 정보 수신 시각	timestamp
timestamp	2025-01-01T22:34:18Z	위치 정보 수신 시각	timestamp
aisClass	A	AIS 종류 Class A (commercial) Class B (smaller vessels)	char
nvgStatus	0	운항 상태 코드 (아래 AIS Navigation Status 표 참고)	smallint
rateOfTurn	0	회전율	real
speedOverGround	1	선박 속도	real
positionAccuracy	0	위치 정확도 1 = high (<= 10 m) 0 = low (> 10 m) = default	smallint
longitude	-92.09995833	경도	numeric(12, 8)
latitude	27.45900833	위도	numeric(12, 8)
courseOverGround	312.8999938964844	선박 이동 각	real
trueHeading	229	선수각	smallint
elapsed	0	지연	integer
utcSecond	45	UTC 초	smallint
dte	0	데이터 터미널 장비(DTE) 준비 상태 0 = 사용 가능 1 = 사용 불가 (기본값)	smallint
specialManeuverIndicator	0	0 = 사용 불가 (기본값) 1 = 특수 기동 중 아님 2 = 특수 기동 중 (예: 내륙 수로에서의 지역 통과 절차 등)	char
raimFlag	0	RAIM (자율 무결성 모니터링) 사용 여부 0 = RAIM 미사용 (기본값) 1 = RAIM 사용 중	char
staticMessageNo	5	정적 메시지 번호	smallint
locationMessageNo	1	위치 메시지 번호	smallint
aisMaxDraught	8.1	최대 흘수	real

Depth 3 필드 설명 (categoryIds 객체)

필드명	예시 값	설명	데이터 타입
categoryIds	123e4567-e89b-12d3-a456-426614174000	SeaVantage 자체 카테고리 고유 아이디	varchar(36) - UUID

부록

선종별 사이즈 분류

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

AIS Dimension

	비트 수	비트 필드	거리 (단위: m)
A	9	Bit 21 - Bit 29	0 - 511: (511 = 511m 이상
B	9	Bit 12 - Bit 20	0 - 511: (511 = 511m 이상
C	6	Bit 6 - Bit 11	0 - 63 63 = 63m 이상
D	6	Bit 0 - Bit 5	0 - 63 63 = 63m 이상

A 값은 항해 방향 기준으로 입력 되어야 합니다.

•

보고 위치 기준점은 없지만 치수 정보가 존재하는 경우:

◦

 A = C = 0이고, B ≠ 0, D ≠ 0

•

위치 기준점 및 치수 정보 모두 없는 경우:

◦

 A = B = C = D = 0 (기본값)

•

메시지 테이블 내에서:

◦

 A는 가장 중요한 필드, D는 가장 덜 중요한 필드

AIS Ship Type

타입 코드	설명	타입 코드	설명
0	Not available (default)	58	Medical Transport
1–19	Reserved for future use	59	Noncombatant ship according to RR Resolution No. 18
20	Wing in ground (WIG), all ships of this type	60	Passenger, all ships of this type
21	Wing in ground (WIG), Hazardous category A	61	Passenger, Hazardous category A
22	Wing in ground (WIG), Hazardous category B	62	Passenger, Hazardous category B
23	Wing in ground (WIG), Hazardous category C	63	Passenger, Hazardous category C
24	Wing in ground (WIG), Hazardous category D	64	Passenger, Hazardous category D
25–29	Wing in ground (WIG), Reserved for future use	65–68	Passenger, Reserved for future use
30	Fishing	69	Passenger, No additional information
31	Towing	70	Cargo, all ships of this type
32	Towing: length exceeds 200m or breadth exceeds 25m	71	Cargo, Hazardous category A
33	Dredging or underwater ops	72	Cargo, Hazardous category B
34	Diving ops	73	Cargo, Hazardous category C
35	Military ops	74	Cargo, Hazardous category D
36	Sailing	75–78	Cargo, Reserved for future use
37	Pleasure Craft	79	Cargo, No additional information
38–39	Reserved	80	Tanker, all ships of this type
40	High speed craft (HSC), all ships of this type	81	Tanker, Hazardous category A
41	High speed craft (HSC), Hazardous category A	82	Tanker, Hazardous category B
42	High speed craft (HSC), Hazardous category B	83	Tanker, Hazardous category C
43	High speed craft (HSC), Hazardous category C	84	Tanker, Hazardous category D
44	High speed craft (HSC), Hazardous category D	85–88	Tanker, Reserved for future use
45–48	High speed craft (HSC), Reserved for future use	89	Tanker, No additional information
49	High speed craft (HSC), No additional information	90	Other Type, all ships of this type
50	Pilot Vessel	91	Other Type, Hazardous category A
51	Search and Rescue vessel	92	Other Type, Hazardous category B
52	Tug	93	Other Type, Hazardous category C
53	Port Tender	94	Other Type, Hazardous category D
54	Anti-pollution equipment	95–98	Other Type, Reserved for future use
55	Law Enforcement	99	Other Type, no additional information
56–57	Spare - Local Vessel

AIS Navigation Status

코드	상태값	설명
0	엔진 사용 중 (Under way using engine)	선박이 엔진을 사용하여 이동 중인 상태를 나타냅니다.
1	닻을 내리고 정박 중 (At anchor)	선박이 닻을 내리고 정박해 있는 상태를 나타냅니다. 이동 하지 않고 고정된 상태입니다.
2	지휘 불능 (Not under command)	선박이 고장 등으로 인해 조종할 수 없는 상태를 나타냅니 다. 다른 선박들이 주의를 기울여야 합니다.
3	조종 제한 (Restricted maneuverability)	선박이 작업이나 기상 조건 등으로 인해 조종 능력이 제한 된 상태를 나타냅니다. 이 상태에서는 다른 선박들이 주의 를 기울여야 합니다.
4	흡수로 인해 제약을 받는 상태 (Constrained by her draught)	선박이 흘수(깊이)에 의해 항로 선택이 제한된 상태를 나 타냅니다.
5	계류 중 (Moored)	선박이 계류 로프 등으로 고정되어 있는 상태를 나타냅니 다. 항구나 부두에 묶여 있는 상태입니다.
6	좌초 (Aground)	선박이 얕은 물에 걸려 움직이지 못하는 상태를 나타냅니 다. 좌초된 상태입니다.
7	어업에 종사 중 (Engaged in fishing)	선박이 어업 활동 중인 상태를 나타냅니다. 이 상태에서는 어망이나 기타 어업 장비가 사용 중일 수 있습니다.
8	항해 중 (Under way sailing)	선박이 항해 중인 상태를 나타냅니다. 엔진이 아닌 돛을 사 용하여 이동할 수도 있습니다.
9	위험물, 유해 물질 또는 해양 오염 물질을 운반하는 선박의 미래 항해 상태 예약 (Reserved for future amendment)	이 값은 미래의 특정 항해 상태를 나타내기 위해 예약되어 있습니다.
10	위험물, 유해 물질 또는 해양 오염 물질을 운반하는 선박의 미래 항해 상태 예약 (Reserved for future amendment)	이 값도 미래의 특정 항해 상태를 나타내기 위해 예약되어 있습니다.
11	선미를 끄는 동력선 (지역 사용) (Power-driven vessel towing astern)	선박이 다른 선박을 선미로 끌고 있는 상태를 나타냅니다. 주로 예인선이 해당됩니다.
12	앞쪽을 미는 동력선 또는 옆에서 끄는 동력선 (지역 사용) (Power-driven vessel pushing ahead or towing alongside)	선박이 다른 선박을 앞쪽에서 밀거나 옆에서 끌고 있는 상 태를 나타냅니다.
13	미래 사용을 위해 예약됨 (Reserved for future use)	이 값은 미래에 특정 상태를 추가하기 위해 예약되어 있습 니다.
14	AIS-SART (활성화됨), MOB-AIS, EPIRB-AIS (AIS-SART (active), MOB-AIS, EPIRB-AIS)	이 값은 AIS-SART(수색 및 구조 트랜스폰더), MOB- AIS(사람 추락 경보 시스템), EPIRB-AIS(위치 표시 비상 라디오 비콘) 장치가 활성화된 상태를 나타냅니다.
15	정의되지 않음 = 기본값 (Undefined = default)	선박의 상태가 정의되지 않은 기본 상태를 나타냅니다.