해당 API는 선박의 위치 정보를 조회할 수 있습니다. 등록하지 않은 선박 조회 시 자동으로 워크스페이스에 등록됩니다.
인증 방법
Fleet API는 사용자 인증을 위해 Swagger UI에서 Basic Authorize 인증 방식을 제공합니다.
인증 절차는 다음과 같습니다:
1.
우측 상단의 [Authorize] 버튼을 클릭합니다.
2.
팝업 창에 제공받은 인증 정보(아이디, 비밀번호)를 입력합니다.
3.
입력 후 다시 [Authorize] 버튼을 클릭하여 인증을 진행합니다.
4.
인증이 완료되면 [Close] 버튼을 클릭하여 인증 창을 닫습니다.
Swagger UI에서 호출되는 모든 API 요청에 인증 토큰이 자동으로 포함되어 전송됩니다.
요청 정보
요청 정보
Request URL : [GET] https://insight.seavantage.com/api/fleet/snapshot
실행 순서
1.
2.
/fleet 경로로 이동합니다.
3.
[Try it out] 버튼을 클릭하여 입력창을 활성화합니다.
4.
아래 요청 Parameters 조건에 따라 입력합니다.
•
미입력: 워크스페이스에 등록된 전체 선박 조회
•
categoryId만 입력: 해당 메뉴에 등록된 선박 목록 조회
◦
•
shipId만 입력: 해당 선박만 조회
◦
•
categoryId + shipId 입력: 해당 카테고리 내 지정된 선박만 조회
5.
[Execute] 버튼을 클릭합니다.
6.
하단 응답 영역에서 등록 결과를 확인합니다.
응답 정보
응답 예시
{
"code": 200,
"message": "success",
"error": false,
"timestamp": "2025-05-20T02:09:02.993772679",
"response": [
{
"shipId": "aaa9dcf0-6af2-4f89-a6d5-c25594ed9837",
"position": {
"imoNo": "9637076",
"mmsi": "538005248",
"deviceType": "AIS",
"callSign": "V7CD9",
"shipName": "ARDMORE SEAVANTAGE",
"aisShipType": 80,
"aisDimA": 150,
"aisDimB": 33,
"aisDimC": 8,
"aisDimD": 24,
"aisEta": "05182100",
"aisDestination": "JMKIN",
"staticDateTime": "2025-05-19T00:58:44Z",
"timestamp": "2025-05-19T01:10:11Z",
"aisClass": "A",
"nvgStatus": 0,
"rateOfTurn": 0,
"speedOverGround": 2.0999999046325684,
"positionAccuracy": 0,
"longitude": -76.74852333,
"latitude": 17.96315667,
"courseOverGround": 47.29999923706055,
"trueHeading": 51,
"elapsed": 0,
"utcSecond": 10,
"dte": 0,
"specialManeuverIndicator": "0",
"raimFlag": "0",
"staticMessageNo": 5,
"locationMessageNo": 1,
"aisMaxDraught": 7.8
}
}
]
}
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 필드 설명 (response 객체)
필드명 | 예시 값 | 설명 | 데이터 타입 |
shipId | aaa9dcf0-6af2-4f89-a6d5-c25594ed9837 | SeaVantage 자체 선박 고유 아이디 | varchar(36) - UUID |
Depth 2 필드 설명 (position 객체)
필드명 | 예시 값 | 설명 | 데이터 타입 |
imoNo | 9637076 | 선박 IMO 등록번호 | varchar(10) |
mmsi | 538005248 | 선박 고유 식별 번호 | varchar(10) |
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-01T00:00:00Z | 정적 정보 수신 시각 | timestamp |
timestamp | 2025-01-01T00:00:00Z | 위치 정보 수신 시각 | 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 |
부록
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) | 선박의 상태가 정의되지 않은 기본 상태를 나타냅니다. |