SQUAKE Integration Docs
  • πŸƒOverview
  • βœ‰οΈContact form
  • ⚠️Incident form
  • πŸ—„οΈCalculation API Examples
    • 🌐Travel
      • πŸ›ŒAccommodation
        • Accommodation: SQUAKE
      • 🚌Bus
        • Bus: SQUAKE
        • Bus: DEFRA πŸ‡¬πŸ‡§
      • πŸš—Car
        • Car: ACRISS
        • Car: DEFRA πŸ‡¬πŸ‡§
        • Car: EEA πŸ‡ͺπŸ‡Ί
        • Car: EPA πŸ‡ΊπŸ‡Έ
      • 🀝Event
        • Event: HCMI & CHSB
      • ⛴️Ferry
        • Ferry: ADEME πŸ‡«πŸ‡·
      • ✈️Flight
        • Flight: ADEME πŸ‡«πŸ‡·
        • Flight: Base Empreinte πŸ‡«πŸ‡·
        • Flight: CO2 emissiefactoren πŸ‡³πŸ‡±
        • Flight: DEFRA πŸ‡¬πŸ‡§
        • Flight: EPA πŸ‡ΊπŸ‡Έ
        • Flight: GATE4
        • Flight: ICAO
        • Flight: TIM
        • Flight: TU Chalmers πŸ‡ΈπŸ‡ͺ
      • 🏨Hotel
        • Hotel: DEFRA πŸ‡¬πŸ‡§
        • Hotel: HCMI & CHSB
        • Hotel: SQUAKE
      • πŸš†Train
        • Train: ADEME πŸ‡«πŸ‡·
        • Train: Base Empreinte πŸ‡«πŸ‡·
        • Train: CO2-emissiefactoren πŸ‡³πŸ‡±
        • Train: DEFRA πŸ‡¬πŸ‡§
        • Train: SQUAKE
    • πŸ“¦Logistics
      • ✈️Air Freight
        • Air Freight: DIN EN 16258
        • Air Freight: GLEC
      • πŸ›₯️Inland Waterways
        • Inland Waterways: GLEC
      • 🚧Logistics Site
        • Logistics Site: GLEC
      • 🚈Rail Freight
        • Rail Freight: DIN EN 16258
        • Rail Freight: ECTA
        • Rail Freight: GLEC
      • 🚚Road Freight
        • Road Freight: DIN EN 16258
        • Road Freight: GLEC
      • 🚒Sea Freight
        • Road Freight: Clean Cargo
        • Road Freight: DIN EN 16258
        • Road Freight: EMSA πŸ‡ͺπŸ‡Ί
        • Road Freight: GLEC
      • πŸš›Van
        • Van: EEA πŸ‡ͺπŸ‡Ί
  • πŸ†•Notable Changes
    • πŸ“ŠCalculation Changes
      • Events according to HCMI - 2024 updates
      • Train according to CO2 emissiefactoren - energy scope inclusion
      • Train: SQUAKE - April 2025 Update
      • Bus & Train According to DEFRA are Now Available
      • Base Empreinte for Flights and Trains Now Live
      • TIM Transition to Version 2.0
      • TIM & DEFRA: Distance Changes
      • Airline Code Support Update - December 2024
      • GLEC v3.1
      • Car: DEFRA is Now Available
      • Hotel: DEFRA is Now Available
      • Hotel: HCMI - 2024 Updates
      • Accommodation - September 2024 Updates
      • Bus: SQUAKE - September 2024 Update
      • Flight: DEFRA - July 2024 Update
      • GATE4 Methodology is Now Available
      • GLEC, ECTA, and CLEAN-CARGO November 2023 Update
      • Flight: ICAO v13 - July 2024 Update
      • TIM v1.3
      • Train: SQUAKE - August 2024 Update
  • πŸ’‘Use Cases
    • Fulfillment with API
    • Fulfillment with Self-Checkout
    • Webhooks
    • Webhooks API Reference
  • πŸ•΅οΈAudits
    • Retrieve the list of Audit logs
    • Retrieve a specific Audit log
  • πŸ§‘β€πŸ’»Migration Guide
    • From v1 to v2
  • ❓Sustainability FAQs
Powered by GitBook
On this page
  • High-Level Description:
  • Sample API Request
  • API request items
  • Sample API Response
  • Bibliography

Was this helpful?

  1. Calculation API Examples
  2. Travel
  3. Flight

Flight: ADEME πŸ‡«πŸ‡·

PreviousFlightNextFlight: Base Empreinte πŸ‡«πŸ‡·

Last updated 7 months ago

Was this helpful?

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 Request

{
  "expand": [
    "items"
  ],
  "items": [
    {
      "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"
    }
  ]
}

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": SQUAKE will try to resolve the origin/destination regardless of its format. Ideally, for addresses use the Post standard, 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": SQUAKE will try to resolve the origin/destination regardless of its format. Ideally, for addresses use the Post standard, 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.

Sample API Response

{
    "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 https://www.ecologie.gouv.fr/sites/default/files/Information_GES%20-%202019.pdf

πŸ—„οΈ
🌐
✈️
πŸ’‘