Car: EEA 🇪🇺

💡 High-Level Description

The European Environment Agency (EEA) stands as a major institution responsible for providing valuable insights into environmental concerns, including carbon emissions in various sectors. With the transportation sector being one of the chief contributors to greenhouse gas emissions, cars, in particular, have remained a significant focus for the EEA. To address the environmental concerns stemming from the car sector, the EEA has developed a methodology to ensure a standardized measurement and reporting mechanism for carbon emissions.

This methodology by the EEA aims to capture an all-encompassing view of the car sector, considering variables such as vehicle type, fuel consumption patterns, and the impact of innovative technologies. By implementing this methodology, the EEA aims to facilitate informed policy decisions at the European level and provide data that can foster sustainable advancements in the automotive industry.

---

Sample API Requests

A. Route-based request without audit mode (origin/destination or explicit distance)

{
  "expand": ["items"],
  "items": [
    {
      "audit": false,
      "type": "car",
      "external_reference": "test_3",
      "origin": "Menton, France",
      "destination": "Paris, France",
      "manufacturer": "VOLVO",
      "model": "V40",
      "model_year": 2017,
      "fuel_type": "diesel",
      "engine_capacity_in_cubic_cm": 1969,
      "electric_energy_consumption_in_kw": 88,
      "country": "PT",
      "methodology": "EU-EEA"
    }
  ]
}

B. Route-based request with audit mode (for finalized/post-booking calculations)

{
  "expand": ["items"],
  "audit_for": "<Auditable Entity ID>",
  "items": [
    {
      "audit": true,
      "type": "car",
      "external_reference": "test_3",
      "origin": "Menton, France",
      "destination": "Paris, France",
      "manufacturer": "VOLVO",
      "model": "V40",
      "model_year": 2017,
      "fuel_type": "diesel",
      "engine_capacity_in_cubic_cm": 1969,
      "electric_energy_consumption_in_kw": 88,
      "country": "PT",
      "methodology": "EU-EEA"
    }
  ]
}

Note: audit_for is optional. Provide when calculating on behalf of a specific Auditable entity; otherwise omit.

C. Duration-based request (fallback when distance is unknown)

When the trip distance is unknown, you may pass number_of_days. The API will estimate the distance as estimated_distance_in_km = number_of_days * 60.

{
  "expand": ["items"],
  "items": [
    {
      "audit": false,
      "type": "car",
      "external_reference": "test_3",
      "manufacturer": "VOLVO",
      "model": "V40",
      "model_year": 2017,
      "fuel_type": "diesel",
      "engine_capacity_in_cubic_cm": 1969,
      "electric_energy_consumption_in_kw": 88,
      "country": "PT",
      "methodology": "EU-EEA",
      "number_of_days": 5
    }
  ]
}

Precedence rule: If distance_in_km is provided, it will be used and takes priority over both origin/destination and number_of_days.

---

Sample API Response

{
  "carbon_quantity": 213823,
  "carbon_unit": "gram",
  "items": [
    {
      "carbon_quantity": 213823,
      "carbon_unit": "gram",
      "external_reference": "test_3",
      "type": "car",
      "methodology": "EU-EEA",
      "distance": 876.0,
      "distance_unit": "kilometer"
    }
  ]
}

---

API Request Items

• "type": "car" (required)

• "methodology": "EU-EEA" (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.

• "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.

• "number_of_days": integer (display name: Number-Of-Days), >= 1.

  • Use when trip distance is unknown.

  • Estimated distance formula: estimated_distance_in_km = number_of_days * 60.

  • Precedence: distance_in_km > origin/destination > number_of_days (fallback).

• "fuel_type": Values are diesel, petrol, hybrid, electricity, midgrade_gasoline, natural_gas, premium_gasoline, regular_gasoline, or propane.

• "manufacturer": See the database

• "model": See the database

• "model_year": See the database

• "country": Two-letter or three-letter code as defined in ISO 3166-1 alpha-2 and alpha-3 respectively. Minimum length is 2, maximum length is 3. Format should match the following pattern: ^[A-Z]{2,3}$.

• "electric_energy_consumption_in_kw": See the database

• "engine_capacity_in_cubic_cm": See the database

• "audit": boolean (optional). Set to true to create immutable audit records for finalized calculations. Must be enabled for your account.

Default values

• "fuel_type": "petrol"

---

Notes

• Data quality tip: whenever possible, pass the actual distance_in_km—it yields the most accurate result. number_of_days is a convenience fallback and a coarse approximation.

---

Bibliography

• EEA, 2019, Trends and projections in Europe 2019 — tracking progress towards Europe’s climate and energy targets, EEA Report, 15/2019, European Environment Agency.

• EU, 2019, Regulation (EU) 2019/631 of the European Parliament and of the Council of 17 April 2019 setting CO2 emission performance standards for new passenger cars and for new light commercial vehicles, and repealing Regulations (EC) No 443/2009 and (EU) No 510/2011, OJ L 111, 25.4.2019, p. 13-53.

• Monitoring of CO2 Emissions From Passenger Cars. co2cars.apps.eea.europa.eu.

• CO2 Performance of New Passenger Cars in Europe. 26 Sept. 2022, www.eea.europa.eu/ims/co2-performance-of-new-passenger.