현재 시점 기준 선박의 위치 추적 및 과거항적, 예상 항로등을 화면으로 볼 수 있습니다.
화면 Embed 서비스 사용 순서
1. 토큰 발급
사용자 토큰을 발급합니다.
요청 정보
Request URL: [GET] https://insight.seavantage.com/api/token/publish
실행 순서
1.
2.
/token/publish 경로로 이동합니다.
3.
[Try it out] 을 클릭하여 입력창을 활성화합니다.
4.
[Execute] 버튼 클릭합니다.
5.
응답 영역에서 등록 결과를 확인합니다.
참고 사항
•
토큰은 24시간 동안 유효하며, 지속적인 접근을 위해 일반적으로 12시간에 한 번씩 갱신이 필요합니다.
•
이 API는 여러 번 호출할 수 있으나, 가장 최근에 발급된 두 개의 토큰만 유효하며, 이전에 발급된 토큰은 자동으로 만료됩니다.
2. 임베드 URL 생성
발급된 토큰과 함께 파라미터를 조합하여 화면 임베드 URL을 생성합니다.
파라미터 종류
화면 Embed 기능은 아래 파라미터를 조합하여 다양한 화물 추적 화면을 구성할 수 있습니다. 해당 URL을 브라우저 또는 iframe 에 입력하여 화면 Embed 서비스를 사용할 수 있습니다.
선박 추적시 사용자 토큰과 함께 imoNo 를 필수로 입력하셔야 합니다.userToken (필수)
•
씨벤티지에서 발급된 유효한 사용자 토큰
imoNo (필수)
•
추적 대상 선박의 IMO 번호 (7자리)
참고 사항
•
선박을 추적할 때 요청한 선박이 워크스페이스에 등록되어 있지 않은 경우 해당 선박을 자동으로 워크스페이스에 등록합니다.
startDate (선택)
•
과거 항적 표출 시 시작 기준일을 설정
값 | 설명 |
auto | 선박이 출항한 직전 항구부터 현재 위치까지 항적 표시 |
YYYYMMDD | 지정한 날짜부터 현재까지 항적 표시 |
미입력/기타 | 과거 항적 표시하지 않음 |
destination (선택)
•
목적지 예측이 입력된 항구(UNLOCODE) 기준으로 할지, AIS Destination 기준으로 할지 선택하는 옵션
값 | 설명 |
unlocode | 목적지 UNLOCODE를 입력받아 목적지 항구로 설정하고 항구 마커를 표시합니다.
예시)
1. destination=KRPUS 부산을 목적지 항구로 설정합니다.
2. destination=USLGB Long Beach를 목적지 항구로 설정합니다.
3. destination=ABCDE ABCDE를 목적지 항구로 설정합니다.
(예시 3번과 같이 씨벤티지에 존재하지 않은 항구를 입력 했을 경우 목적지 설정에 실패합니다.) |
auto | AIS Destination 값 기반으로 목적지를 예측하고 항구 마커를 표시합니다. |
미입력 | 목적지를 설정하지 않습니다.
단, routing=auto 옵션만 입력하면 destination 파라미터 값을 입력하지 않아도 AIS Destination으로 목적지 자동 예측 후 예상 항로를 보여줍니다. |
routing (선택)
•
예상 항로 계산 시 목적지 예측 기준을 선택
값 | 설명 |
auto | AIS Destination 기준으로 목적지 예측 후 예상 항로 표시 |
destination | destination 파라미터에 입력된 값 기준 예상 항로 표시
예시)
1. destination=KRPUS UNLOCODE 입력 했을 경우 해당 항구로 예상 항로 표시합니다.
2. destination=auto AIS 정보로 목적지를 예측합니다.
3. 파라미터에 값을 입력하지 않았을 경우 목적지를 예측하지 않습니다. |
미입력/기타 | 예상 항로 표시 안함 |
size (선택)
•
선박의 상세 정보를 팝업 형태로 표시할지, 말풍선 형태로 표시할지 선택
값 | 설명 |
small | 선박 마커 위 말풍선으로 정보 표시 |
미입력/기타 | 기존 선박 팝업 사용 |
•
size를 small로 설정하면 선박에 관련된 최소 정보(선명, IMO, eta, ata, pta)만 볼 수 있습니다.
•
size값을 미입력하거나 기타 다른 값을 입력 했을 경우
조합 예시
1.
선박이 출항한 직전 항구부터 현재 위치까지 항적을 표시하고 AIS Destination 기반으로 목적지를 예측 후 해당 목적지로 예상 항로를 보여줍니다.
https://insight.seavantage.com/ship/tracking?imoNo=9685358&userToken={userToken}&routing=auto&startDate=auto
Plain Text
복사
2.
과거 항적을 6월 1일부터 보여주고 목적지를 부산으로 설정하고 예상 항로를 보여줍니다.
https://insight.seavantage.com/ship/tracking?imoNo=9719056&routing=destination&userToken={userToken}&destination=KRPUS&startDate=20250601
Plain Text
복사
