Compute fuel statistics for set of routes (beta)

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 given departureDate 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 route id returned in the response, remain valid for a limited period (at least 1 hour), following the same policy as any v3/route sub-resources.

Support endpoints and resources

  • Get routes details: use the v3/routes/{id} endpoint using the id returned in the response of the present endpoint.
  • Explore the the list of Supported fields and values.
Language
Credentials
Header
Click Try It! to start a request and see the response here!