post https://api.searoutes.com/v3/routes/fuelStatistics
Compute aggregated fuel consumption statistics for a set of routes.
Notes and considerations
- Route types:
shortest
→ shortest feasible path, considering traffic separation schemes and port entries.historical
→ reconstructs past voyages around the givendepartureDate
using AIS data.proforma
→ uses carriers service plans.schedule
→ uses upcoming carrier vessel departures.
- Fuel consumption is estimated from the distance travelled in each area (ECA vs non-ECA) and the technical characteristics of the vessel(s) assigned to the route.
historical
: based on the vessel(s) that performed the voyage.schedule
: based on the vessel(s) operating the scheduled departure.shortest
: available only if a vessel was provided in the route request.proforma
: not available, since multiple potential vessels per leg make fuel consumption inconsistent to compute.
id
lifetime: the routeid
returned in the response, remain valid for a limited period (at least 1 hour), following the same policy as anyv3/route
sub-resources.
Support endpoints and resources
- Get routes details: use the
v3/routes/{id}
endpoint using theid
returned in the response of the present endpoint. - Explore the the list of Supported fields and values.