v1
latestOpenAPI 3.0.32026-07-226744340.8 KBArea activity over time
Aggregate vessel activity over an area, bucketed by hour or day — distinct vessels, total + moving positions, and average/max speed per bucket. Generalizes /transits to arbitrary geography (chokepoint, bounding box, or proximity). The "is this area's traffic anomalous vs the baseline" view. Requires a plan with Maritime intelligence access (can_use_maritime) — the Corporate & Supply Chain plan and above.
Historical / baseline surface: reads raw AIS positions directly (not the derived rollups). Forward-accruing: positions begin at launch (June 2026) — no historical backfill. Terrestrial AIS only (no satellite). Date windows are capped at 30 days; defaults to the trailing 14 days. Bucket auto-selects hour for spans ≤2 days, otherwise day.
Query parameters
Restrict to one chokepoint. Omit to use bbox / near / near_gem_id, or for global.
Bounding box filter: minLon,minLat,maxLon,maxLat (lon-first axis order, e.g. 56,26,57,27).
Point 'lat,lon' for a radius area; combine with radius_km (default 50 km).
GEM energy-asset gem_id center — traffic within radius_km of that LNG terminal / platform (default 25 km). The cross-source 'traffic near energy infrastructure' join.
Radius in km for near / near_gem_id. Default 50 (near) or 25 (near_gem_id); clamped 1–2000.
Time bucket. Auto-selects hour for spans ≤2 days, otherwise day.
Window start YYYY-MM-DD (≤30-day window).
Window end YYYY-MM-DD.
Trailing N-day window (1–30). Defaults to 14.
Buckets per page (1–1000).
Response
Bucketed activity, most recent first. Envelope: { success, bucket ('hour'|'day'), data, pagination, applied_filters }. Each data row: bucket (timestamp), vessels (distinct mmsi), positions (AIS message count), moving_positions (sog > 1), avg_sog, max_sog (knots).