1. 화면 설명
현재 시점 기준 선박의 위치 추적 및 과거항적, 예상 항로등을 화면으로 볼 수 있습니다.
2. 화면 Embed 소개
화면 Embed는 씨벤티지에서 발급된 사용자 토큰(User Token)을 활용하여,
별도의 로그인 과정 없이 사용 중인 솔루션 내에 인터페이스 형태로 연동하여 사용할 수 있는 서비스입니다.
3. 화면 Embed 서비스 사용 순서
1.
사용자 토큰을 발급합니다.
2.
발급된 토큰과 함께 파라미터를 조합하여 화면 임베드 URL을 생성합니다.
3.
해당 URL을 브라우저 또는 iframe 에 입력하여 화면 Embed 서비스를 사용할 수 있습니다.
4. 사용자 토큰 발급
4-1. 요청 정보
Request URL: [GET] https://insight.seavantage.com/api/token/publish
4-2. 실행 순서
1.
Swagger 문서에서 우측 상단의 Select a definition 메뉴에서 Token 선택
2.
/token/publish 경로로 이동
3.
[Try it Out] 클릭 → 입력창 활성화
4.
[Execute] 버튼 클릭
5.
하단 응답 영역에서 응답 결과 확인
[Execute] 클릭 후 응답 정보를 확인할 수 있습니다.
참고 사항
•
발급된 토큰은 24시간 유효합니다.
•
많은 수의 토큰 발행 시 마지막 발급된 2개의 토큰만 유효합니다.
5. 화면 임베드 파라미터 조합
화면 Embed 기능은 아래 파라미터를 조합하여 다양한 선박 추적 화면을 구성할 수 있습니다.
조합 예시)
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
복사
5-1. 파라미터 종류
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 파라미터에 UNLOCODE 입력 했을 경우 해당 항구로 예상 항로 표시
2. destination 파라미터에 auto 입력시 AIS 정보로 목적지 예측
3. destination 파라미터에 값을 입력하지 않았을 경우 목적지 예측 안함 |
(미입력/기타) | 예상 항로 표시 안함 |
size (선택)•
선박 상세 정보를 팝업 또는 말풍선으로 표시할지 결정
값 | 설명 |
small | 선박 마커 위 말풍선으로 정보 표시 |
(미입력/기타) | 기존 선박 팝업 사용 |