Where a vessel has been
get_vessel_trackThe positions heard from one vessel over a time range, oldest first, with speed, course, and navigational status. Positions implying an impossible speed for the vessel are left out. A vessel can be identified by MMSI, or by IMO with a feeder or partner token. A call covers up to a year. By default the track is simplified by shape: the positions that hold its path, with breaks where the vessel went unheard; interval_minutes asks for even spacing instead.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_vessel_track"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | end, RFC 3339 UTC; default now | |
| imo | No | the vessel's IMO number, instead of mmsi; needs a feeder or partner token. Follows the one vessel the IMO names: its only MMSI, or the only one heard in the last 30 days | |
| from | No | start, RFC 3339 UTC; default 24 hours before to. A call covers up to 366 days | |
| mmsi | No | the vessel's MMSI, as an alternative to its IMO number | |
| limit | No | positions to return: default 50, maximum 200; when more match, the newest are kept | |
| interval_minutes | No | at most one position per this many minutes, evenly spaced; by default the track is simplified by shape instead, keeping the positions that hold its path. Anonymous and personal calls reaching past 48 hours are rounded up to whole minutes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | ||
| from | Yes | start of the range covered | |
| mmsi | Yes | ||
| name | No | ||
| breaks | No | simplified, always present and empty when the vessel was heard throughout: indexes of positions that start a new segment after a gap in reports | |
| positions | Yes | oldest first | |
| truncated | Yes | true when positions were left out: simplified, the tolerance rose past 15 m to fit the limit, or the range held more than 50,000 positions and the oldest were not read; by interval, the newest were kept | |
| interval_s | Yes | at most one position per this many seconds; 0 is every position heard. Simplified, the resolution the positions were read at | |
| simplified | Yes | true when the track was simplified by shape: the positions that hold its path, not evenly spaced | |
| attribution | Yes | attribution required when displaying the positions, by source kind | |
| tolerance_m | No | simplified: every position left out lay within this many meters of the line through the ones kept |