워크스페이스에 등록된 Fleet 내 선박들의 실시간 위치 정보를 조회할 수 있습니다.
또한, 특정 선박(shipId)만 지정하여 조회하는 것도 가능합니다.
인증 방법
Swagger UI를 통해 아래 인증 절차를 따라 인증합니다:
1.
Swagger 우측 상단 [Authorize] 클릭
2.
팝업창에서 제공받은 ID / PW 입력
3.
다시 [Authorize] 클릭
4.
인증 완료 후 [Close] 클릭
이후 모든 요청에는 인증 토큰이 자동 포함됩니다.
선박 위치 정보 조회 방법
1. 구성 조건 (선택적 파라미터)
파라미터 | 설명 |
없음 | 전체 Fleet 선박 리스트 조회 |
categoryId만 입력 | 해당 카테고리에 속한 선박 목록 조회 |
shipId만 입력 | 특정 선박만 조회 |
categoryId + shipId | 특정 카테고리 내 선박 조회 |
•
2. Swagger UI에서 호출 실행
1.
정의 선택 메뉴에서 Fleet 선택
2.
/fleet/snapshot 경로로 이동
3.
[Try it Out] 클릭
4.
파라미터 입력 후 [Execute] 클릭
5.
하단 응답 확인
응답 정보
응답 형식 예시
{
"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",
"latitude": 17.96315667,
"longitude": -76.74852333,
"speedOverGround": 2.1,
"courseOverGround": 47.3,
"timestamp": "2025-05-19T01:10:11Z"
}
}
]
}
JSON
복사
주요 필드 설명
필드명 | 예시 | 설명 |
code | 200 | HTTP 상태 코드 |
message | success | 응답 메시지 |
error | false | 오류 여부 |
timestamp | 2025-05-20T02:09:02Z | 응답 시각 |
response | Array | 선박별 위치 정보 포함 응답 데이터 |
응답 필드 구조
Depth 1 – shipId
필드명 | 예시 값 | 설명 |
shipId | aaa9dcf0-6af2-4f89-a6d5-c25594ed9837 | SeaVantage 선박 고유 ID |
Depth 2 – position
필드명 | 예시 값 | 설명 |
imoNo | 9637076 | IMO 등록번호 |
mmsi | 538005248 | MMSI 식별 번호 |
deviceType | AIS | 장비 타입 (AIS 등) |
callSign | V7CD9 | 호출부호 |
shipName | ARDMORE SEAVANTAGE | 선명 |
latitude | 17.96315667 | 위도 |
longitude | -76.74852333 | 경도 |
speedOverGround | 2.1 | 현재 속도 (노트 단위) |
courseOverGround | 47.3 | 진행 방향 (도 단위) |
timestamp | 2025-05-19T01:10:11Z | 위치 정보 수신 시간 (UTC 기준) |
응답 코드 안내
코드 | 설명 |
200 | 정상 처리 |
201 | 리소스 생성 |
400 | 잘못된 요청 |
401 | 인증 필요 |
403 | 권한 없음 |
422 | 처리 불가 |
429 | 요청 과다 |