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
  • API Request
  • API Request Items
  • Sample API Response
  • Bibliography

Was this helpful?

  1. Calculation API Examples
  2. Travel
  3. Train

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

πŸ’‘ High-Level Description:

Base Empreinte, managed by ADEME, is a comprehensive environmental impact database combining data from Base Carbone and Base IMPACTS. It supports environmental evaluations by offering multi-criteria data, including greenhouse gas (GHG) emissions and other environmental impacts.

When applied to train travel, Base Empreinte factors in key variables such as train type, location (e.g., Corsica and Ile-de-France), and fuel source, ensuring accurate emission calculations. This methodology enables stakeholders to understand the environmental implications of train travel while providing data for eco-friendly decision-making.

API Request

{
  "expand": [
    "items"
  ],
  "items": [
    {
      "type": "train",
      "methodology": "BASE-EMPREINTE",
      "external_reference": "test_1",
      "number_of_travelers": 1,
      "origin": "FRA",
      "destination": "NCE",
      "train_type": "tram",
      "state": "Ile-de-France",
      "country": "FR",
      "year": "2021"
    }
  ]
}

API Request Items

  • "type": "train" (required)

  • "methodology": "BASE-EMPREINTE" (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.

  • "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 (e.g., "MUC"), and for cities or states, use ISO standards (e.g., "FR" for France).

  • "destination": See "origin" resolution process.

  • "distance_in_km": Prioritized over origin and destination. If you pass both distance_in_km and origin/destination, distance_in_km will be used.

  • "train_type": Base Empreinte considers ter, tgv, intercity, metro, tram, trolleybus, and main_line.

  • "state": Supported states are Corsica and Ile-de-France. Defaults to "Ile-de-France".

  • "country": Defaults to "FR" (France).

  • "year": Defaults to the latest available year when not provided.

  • "city_type": Defaults to "population_under_250000" when state is not provided. (Alternative is population_above_250000).

  • Default Values

    • "city_type": "population_under_250000"

    • "country": "FR"

    • "year": Latest available when not passed.

    • "train_type": Defaults to main_line if only train type is passed.

Sample API Response

{
    "carbon_quantity": 4890,
    "carbon_unit": "gram",
    "items": [
        {
            "carbon_quantity": 4890,
            "carbon_unit": "gram",
            "external_reference": "test_1",
            "type": "train",
            "methodology": "BASE-EMPREINTE",
            "distance": 685.0,
            "distance_unit": "kilometer"
        }
    ]
}

Bibliography

  • ADEME. (2025). Base Empreinte - DonnΓ©es d’impacts environnementaux. Retrieved from https://www.ademe.fr/base-empreinte

  • ADEME. (2024). Base Carbone Methodological Guide. Retrieved from https://www.ademe.fr/base-carbone

  • ADEME. (2023). Documentation on the Base IMPACTS and emission factors for trains. Available via official ADEME publications.

PreviousTrain: ADEME πŸ‡«πŸ‡·NextTrain: CO2-emissiefactoren πŸ‡³πŸ‡±

Last updated 1 month ago

Was this helpful?

πŸ—„οΈ
🌐
πŸš†