# Flight: ADEME 🇫🇷 ### :bulb: High-Level Description: The French Environment and Energy Management Agency, ADEME (Agence de la transition écologique), is a renowned public institution at the forefront of environmental sustainability and energy management. Under the authority of the French Ministries of Ecology and Research, ADEME has gained recognition for its extensive research and its commitment to promoting sustainable practices across various sectors, including transportation, energy, and waste management. Within the aviation sector, ADEME's methodologies are especially significant. Their carbon calculation approach is tailored specifically to account for the environmental footprint of passenger flights. By considering a comprehensive set of factors such as aircraft type, fuel consumption, flight duration, occupancy rates, and the inclusion of radiative forcing (which addresses the increased impact of emissions at higher altitudes), ADEME offers a nuanced and scientifically robust framework. This methodology empowers airlines, regulatory bodies, and environmental stakeholders to better understand and address the carbon emissions associated with air travel. ### **Sample API Requests** #### A. Without audit mode (for pre-booking/quotes) ```json { "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" } ] } ``` #### B. With audit mode (for finalized/post-booking calculations) ```json { "expand": ["items"], "audit_for": "", "items": [ { "audit": true, "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" } ] } ``` > **Note:** `audit_for` is optional. Provide when calculating on behalf of a specific Auditable entity; otherwise omit. ### **API request items** * `"type": "flight"` (required) * `"methodology": "ADEME"` (required) * `"external_reference"`: A unique identifier that helps you link the resulting emissions to the requested item. Especially useful if multiple items are requested since SQUAKE cannot guarantee to keep the same order. The maximum length is 128 characters. * `"number_of_travelers"`: Minimum value is `1`. The default value is `1`. * `"aircraft_size"`: An estimation of the aircraft's size based on the number of seats. Values are `under_50_seats`, `under_100_seats`, `under_180_seats`, `under_250_seats`, or `over_250_seats`. * `"aircraft_type"`: An IATA or ICAO code for the aircraft type. * `"origin"`: For airports use IATA/ICAO code (format: `^[A-Z]{3,4}$`, e.g. `"MUC"`), for other locations used in trade and transportation use UN/LOCODE codes (format: `^[A-Z]{2}\W?[A-Z2-9]{3}$`, e.g. `"DEHAM"`). You can also pass lat/long (format: `^[-+]?\d{1,3}\.\d{1,10}\s?,\s?[-+]?\d{1,3}\.\d{1,10}$`, e.g. `"+40.712,-74.006"`). * `"destination"`: For airports use IATA/ICAO code (format: `^[A-Z]{3,4}$`, e.g. `"MUC"`), for other locations used in trade and transportation use UN/LOCODE codes (format: `^[A-Z]{2}\W?[A-Z2-9]{3}$`, e.g. `"DEHAM"`). You can also pass lat/long (format: `^[-+]?\d{1,3}\.\d{1,10}\s?,\s?[-+]?\d{1,3}\.\d{1,10}$`, e.g. `"+40.712,-74.006"`). * `"distance_in_km"`: Prioritized over `origin` and `destination`. If you don't have a `distance_in_km`, you can use `origin` and `destination` and the distance will be automatically resolved. If you pass both `distance_in_km` and `origin`/`destination`, then `distance_in_km` will be used. * `"airline"`: The IATA Designator of an airline, e.g., LH. Airline names are also supported, SQUAKE will then automatically resolve it. * `"sustainable_fuels"`: Indicates the usage of sustainable fuels. This lowers the computed emissions in SQUAKE but is not part of the current official emissions frameworks. * `"carbon_reduction_percentage_of_total"`: The percentage of emissions reduction through the usage of sustainable fuel. The minimum value is `0`, and the maximum value is `1`. Default value is `0`. * `"audit"`: boolean (optional). Set to `true` to create immutable audit records for finalized calculations. Must be enabled for your account. ### **Sample API Response** ```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 (2019, June). Ministère de La Transition Écologique et Solidaire. Retrieved from --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs-integration.squake.earth/api-calculations-request-response/travel/flight/flight-ademe.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.