Estimate a vessel's current position (SAT-E)
estimated_vessel_positionEstimate where a vessel is right now when its last AIS position is stale — Datalastic uses terrestrial AIS only, so a ship in open ocean can be many hours old. The position is calculated from the last known fix, the recognized destination port, and the route-based ETA. It is an ESTIMATE, not an observed position.
Tool selection — use this LAST: prefer get_vessel for a live position (cheapest); prefer get_vessel_pro when the user wants the ETA or recognized destination. Only reach for this tool when BOTH hold: (1) a prior get_vessel/get_vessel_pro lookup shows the last known position is old, and (2) the vessel has a destination and an ETA. It is the heaviest call (it builds a route) and adds nothing when get_vessel already returns a recent position.
Because it is an estimate, OFFER it to the user first rather than calling it silently, and when you present the result make clear it is an estimated position, not a real fix. If estimated_position equals the last known lat/lon, the system could not extrapolate (the position is recent, or the ETA is missing/outdated) — say so instead of implying movement.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| imo | No | Vessel IMO number, exactly 7 digits. Provide exactly one of mmsi, imo, or uuid. | |
| mmsi | No | Vessel MMSI identifier, exactly 9 digits. Provide exactly one of mmsi, imo, or uuid. | |
| uuid | No | Datalastic internal vessel UUID. Provide exactly one of mmsi, imo, or uuid. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| eni | Yes | ||
| imo | Yes | ||
| lat | Yes | ||
| lon | Yes | ||
| mmsi | Yes | ||
| name | Yes | ||
| type | Yes | ||
| uuid | Yes | ||
| speed | Yes | ||
| course | Yes | ||
| atd_UTC | Yes | ||
| eta_UTC | Yes | ||
| heading | Yes | ||
| dep_port | Yes | ||
| timezone | Yes | ||
| atd_epoch | Yes | ||
| dest_port | Yes | ||
| eta_epoch | Yes | ||
| country_iso | Yes | ||
| destination | Yes | ||
| dep_port_uuid | Yes | ||
| type_specific | Yes | ||
| dest_port_uuid | Yes | ||
| current_draught | Yes | ||
| dep_port_unlocode | Yes | ||
| last_position_UTC | Yes | ||
| navigation_status | Yes | ||
| dest_port_unlocode | Yes | ||
| estimated_position | Yes | ||
| last_position_epoch | Yes | ||
| timezone_offset_sec | Yes |