home
///
home
///

Chokepoint Monitoring

Allows users to seamlessly embed SeaVantage’s maritime chokepoint monitoring screens into their existing systems, providing visibility into risk levels, vessel transit activity, and vessel movements across major maritime chokepoints worldwide.

Steps to Use the Screen Embed Service

1. Token Issuance

Issue the user token.

Request URL

[GET] https://insight.seavantage.com/api/token/publish

Execution Steps

1.
In the Swagger Documentation, select Token from the Select a definition menu at the top right.
2.
Navigate to /token/publish.
3.
Click [Try it out] to activate input fields.
4.
Click [Execute].
5.
View results in the response section.
Notes
•
Tokens are valid for 24 hours. To maintain continuous access, it is recommended to renew them every 12 hours.
•
This API can be called multiple times, but only the two most recently issued tokens remain valid. Previously issued tokens are automatically expired.
🔗 View the Detailed Token API guide

2. Embed URL Generation

After issuing the user token, generate the embed URL.

Chokepoint Overview URL

•
Provides an overview of all supported maritime chokepoints
https://insight.seavantage.com/chokepoints/embed?userToken={TOKEN}
Plain Text
복사
Example

Chokepoint Detail URL

•
View detailed monitoring information for a specific maritime chokepoint
https://insight.seavantage.com/chokepoints/embed/{slug}?userToken={TOKEN}
Plain Text
복사
•
Use the corresponding slug to specify the chokepoint displayed in the Chokepoint Details
Example
https://insight.seavantage.com/chokepoints/embed/hormuz?userToken={TOKEN}
Plain Text
복사

Chokepoint Map View URL

•
Display a map of all available maritime chokepoints or a specific chokepoint, including their geographic locations and surrounding vessel traffic.
(A) Global Chokepoint Map View
•
If no slug is specified, the global chokepoint map is displayed, providing an overview of all available chokepoints.
Example
https://insight.seavantage.com/chokepoints/embed?userToken={TOKEN}&view=map
Plain Text
복사
(B) Specific Chokepoint Map View
•
To display a specific maritime chokepoint, include the corresponding slug in the URL.
https://insight.seavantage.com/chokepoints/embed/{slug}?userToken={TOKEN}&view=map
Plain Text
복사
Example
https://insight.seavantage.com/chokepoints/embed/hormuz?userToken={TOKEN}&view=map
Plain Text
복사

Appendix

Chokepoint Slug

Chokepoint
Slug
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