씨벤티지의 해상 초크포인트 모니터링 화면을 고객사의 시스템에 직접 연동하여 사용할 수 있는 기능입니다. 주요 해상 초크포인트의 위험도, 선박 통항 현황, 교통량 변화 및 선박 이동 정보를 확인할 수 있습니다.
화면 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을 생성합니다.
Chokepoint Overview URL
•
지원되는 모든 해상 초크포인트에 대한 전체 현황을 한눈에 확인할 수 있습니다.
https://insight.seavantage.com/chokepoints/embed?userToken={TOKEN}
Plain Text
복사
예시 값
Chokepoint Detail URL
•
특정 해상 초크포인트의 상세 모니터링 정보를 확인할 수 있습니다.
https://insight.seavantage.com/chokepoints/embed/{slug}?userToken={TOKEN}
Plain Text
복사
•
f예시 값
https://insight.seavantage.com/chokepoints/embed/hormuz?userToken={TOKEN}
Plain Text
복사
Chokepoint Map View URL
•
초크포인트 또는 특정 해상 초크포인트의 지리적 위치와 주변 선박 통항 현황을 지도에서 확인할 수 있습니다.
(A) Global Chokepoint Map View
•
식별자를 지정하지 않으면, 지원되는 모든 초크포인트의 현황을 확인할 수 있는 글로벌 초크포인트 지도가 표시됩니다.
예시 값
https://insight.seavantage.com/chokepoints/embed?userToken={TOKEN}&view=map
Plain Text
복사
(B) Specific Chokepoint Map View
•
https://insight.seavantage.com/chokepoints/embed/{slug}?userToken={TOKEN}&view=map
Plain Text
복사
예시 값
https://insight.seavantage.com/chokepoints/embed/hormuz?userToken={TOKEN}&view=map
Plain Text
복사
부록
초크포인트 식별자
초크포인트 | 식별자 |
Strait of Hormuz | hormuz |
Bab el-Mandeb Strait (Red Sea) | bab-el-mandeb |
Bering Strait | bering |
Cape of Good Hope | cape-of-good-hope |
Panama Canal | panama |
Strait of Gibraltar | gibraltar |
Strait of Malacca | malacca |
Suez Canal | suez |
Sunda Strait | sunda |
Taiwan Strait | taiwan |