API v3Events
Events API
Explore vessel activity: apparent fishing, encounters between vessel types, loitering, port visits and AIS gaps.
Introduction Events API
Events API allows you to explore different activities of a vessel. You can analyze:
- apparent fishing events
- encounters between these vessel types: fishing-carrier, fishing-support, fishing-bunker, fishing-fishing, tanker-fishing, carrier-bunker and support-banker.
- In this API Portal we are offering more encounter types compared to our Public Map
- loitering for all vessel types
- port visits for all vessel types
- AIS off (aka GAPs) for all vessel types
- longline set events apply only to vessels classified as drifting longliners.
Check more detail about data caveats here.
Event responses are paginated. See Pagination for how limit, offset, and nextOffset work.
REMINDER! Change the API Dataset to select the event type:
- For fishing events, use
public-global-fishing-events:latest - For encounters events, use
public-global-encounters-events:latest - For loitering events, use
public-global-loitering-events:latest - For port visits, use
public-global-port-visits-events:latest - For AIS off event, use
public-global-gaps-events:latest - For longline set event, use
public-global-longline-fishing-events:latest
Longline set events
Additional properties are added in the fishing object in the response:
- dayNightSummary: see definition of each category in Insights API..
- nauticalDawnUtc: nautical dawn in UTC decimal hours (0–24).
- nauticalDuskUtc: nautical dusk in UTC decimal hours (0–24).
- localStartHours: local time of day when the longline set started, written as decimal hours on a 0–24 clock.
- localEndHours: local time of day when the longline set ended, written as decimal hours on a 0–24 clock.