Flight: ADEME πŸ‡«πŸ‡·

Calculate passenger flight emissions with the methodology of ADEME, the French Agency for Ecological Transition, which accounts for aircraft type, fuel consumption, flight duration, occupancy rates and radiative forcing.

type flightmethodology ADEMEGHG information for transport services, Jun 2019Supports audit mode

ADEME (Agence de la transition Γ©cologique) is a French public institution under the authority of the French Ministries of Ecology and Research. Its flight methodology includes radiative forcing, which addresses the increased impact of emissions at higher altitudes.

Sample requests

Send a quote while the traveller is still choosing a flight, then repeat the call with audit set to true once the booking is final. The body is otherwise identical.

{
  "expand": ["items"],
  "items": [{
    "audit": false,
    "type": "flight",
    "methodology": "ADEME",
    "external_reference": "test_1",
    "number_of_travelers": 1,
    "origin": "FRA",
    "destination": "JFK",
    "aircraft_size": "under_180_seats",
    "aircraft_type": "737",
    "airline": "LH"
  }]
}

audit_for is optional

Pass the ID of an auditable entity when you calculate on behalf of that entity. Otherwise, leave it out.

Request fields

typestringrequired

flight

methodologystringrequired

ADEME

originstring

IATA/ICAO airport code (MUC), UN/LOCODE for other locations (DEHAM), or latitude and longitude (+40.712,-74.006). For multi-leg trips, use routing instead.

destinationstring

Same formats as origin.

routingstring

Hyphen-separated airports for multi-leg itineraries, instead of origin and destination. See Flight: Routing (multi-leg).

distance_in_kmnumber

Takes priority over origin and destination. Without it, SQUAKE resolves the distance from them. With routing, per-leg distances apply.

aircraft_sizeenum

Estimated aircraft size by number of seats: under_50_seats, under_100_seats, under_180_seats, under_250_seats or over_250_seats.

aircraft_typestring

Aircraft type as an IATA or ICAO code.

airlinestring

IATA designator such as LH; airline names are resolved too.

number_of_travelersinteger

Minimum 1. Defaults to 1.

external_referencestring

Your identifier for the item, up to 128 characters, so you can match results to requests. SQUAKE doesn't guarantee the order of items.

sustainable_fuelsboolean

Marks the use of sustainable fuels. This lowers the emissions SQUAKE calculates, but isn't part of the current official frameworks.

carbon_reduction_percentage_of_totalnumber

Share of emissions reduced by sustainable fuel, from 0 to 1. Defaults to 0.

auditboolean

Set to true to create immutable audit records for finalised calculations. Must be enabled for your account.

See every field of POST /v2/calculations in the API reference

Sample response

200 OKapplication/json
{
  "carbon_quantity": 632000,
  "carbon_unit": "gram",
  "items": [{
    "carbon_quantity": 632000,
    "carbon_unit": "gram",
    "external_reference": "test_1",
    "type": "flight",
    "methodology": "ADEME",
    "distance": 6320.0,
    "distance_unit": "kilometer"
  }]
}

Bibliography

GHG information for transport services. Ministère de la Transition Écologique et Solidaire, June 2019. Read the PDF.

On this page

POST/v2/calculations

Run this request against the sandbox with your test key.

Open in API reference