Track of one IMO across MMSI changes. Each MMSI counts only while it reported this IMO (±10 min)
At raw resolution, copies of one report received by several sources (same MMSI, timestamps at most 2 seconds and positions at most 1 metre apart) are merged into one row, the preferred source's: barentswatch, digitraffic and dma first, then aisstream, then openwaters. Rows from one source are never merged, and a copy from a source outside the plan never removes a row.
Request
- Base URL: https://api.aistrail.com
- URL: https://api.aistrail.com/v1/vessels/imo/{imo}/track
- Auth: HTTP bearer
Path parameters
Query parameters
ISO 8601 start (inclusive); default: to minus 24 h
ISO 8601 end (exclusive); default: now on plans with live data, otherwise now minus 24 h. Later values are clamped (see meta.embargo_cutoff)
raw = every fix; 1m / 1h = latest fix per vessel per minute / hour (no interpolation)
json, geojson (application/geo+json), csv (text/csv) or xlsx (Excel workbook); csv and xlsx page through the Link / X-Next-Cursor headers
static = add the vessel's static data to every row (IMO, name, call sign, ship type, length, beam, draught, destination, ETA and the AIS dimensions A, B, C, D as reported at that time); none = position fields only. Default: static for csv and xlsx, none for json and geojson. No extra credits
Rows per page, up to the plan's track_points; the default is 5000, or track_points when that is lower
Opaque cursor from meta.next_cursor. When given, from, to, resolution and the subject are taken from the cursor
Response
Positions ordered by time; each row carries its mmsi
Changes
No recorded changes to this operation across all 2 revisions of this API.