Car: EEA πŸ‡ͺπŸ‡Ί

Calculate car emissions with the European Environment Agency (EEA) methodology, using the vehicle's manufacturer, model, model year, fuel type and engine data.

type carmethodology EU-EEASupports audit mode

The European Environment Agency (EEA) provides insights into environmental concerns, including carbon emissions across sectors. Transport is one of the chief contributors to greenhouse gas emissions, and cars are a particular focus for the EEA. Its methodology standardises how car emissions are measured and reported, and considers vehicle type, fuel consumption patterns and the impact of new technologies. The EEA uses it to support policy decisions at European level and to provide data for sustainable advances in the automotive industry.

Sample requests

Send a route-based quote with origin and destination (or an explicit distance_in_km), then repeat the call with audit set to true once the booking is final. If you don't know the distance, send number_of_days instead.

{
  "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"
  }]
}

audit_for is optional

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

Distance precedence

distance_in_km takes priority over both origin/destination and number_of_days. The order is distance_in_km > origin/destination > number_of_days.

Defaults

When a field is missing, SQUAKE fills it in before calculating.

FieldDefaultApplies when
fuel_typepetrolNo fuel_type is sent

How it's calculated

Distance from trip duration

When the trip distance is unknown, SQUAKE estimates it from number_of_days.

Estimated distance in kmnumber_of_days Γ— 60
number_of_days
Trip duration in days, an integer of at least 1.
60
Kilometres assumed per day.

Send the real distance when you can

The actual distance_in_km gives the most accurate result. number_of_days is a convenience fallback and a coarse approximation.

Request fields

Look up valid vehicle values in the Car: EU-EEA database.

typestringrequired

car

methodologystringrequired

EU-EEA

originstring

SQUAKE tries to resolve origin and destination in any format. Ideally, use the postal standard for addresses, IATA/ICAO codes for airports (MUC), UN/LOCODE for trade and transport locations (DEHAM), or latitude and longitude (+40.712,-74.006).

destinationstring

Same formats as origin.

distance_in_kmnumber

Takes priority over origin and destination. Without it, SQUAKE resolves the distance from them. If you send both, SQUAKE uses distance_in_km.

number_of_daysinteger

At least 1. Use it when the trip distance is unknown: SQUAKE estimates the distance as number_of_days * 60. It's the fallback after distance_in_km and origin/destination.

fuel_typeenum

One of diesel, petrol, hybrid, electricity, midgrade_gasoline, natural_gas, premium_gasoline, regular_gasoline, propane. Defaults to petrol.

manufacturerstring

See the database.

modelstring

See the database.

model_yearinteger

See the database.

countrystring

ISO 3166-1 alpha-2 or alpha-3 code: 2 to 3 uppercase letters (^[A-Z]{2,3}$).

electric_energy_consumption_in_kwnumber

See the database.

engine_capacity_in_cubic_cmnumber

See the database.

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.

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": 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"
  }]
}

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.

On this page

POST/v2/calculations

Run this request against the sandbox with your test key.

Open in API reference