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.
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.
| Field | Default | Applies when |
|---|---|---|
fuel_type | petrol | No 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.
number_of_days Γ 60Send 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.
typestringrequiredcar
methodologystringrequiredEU-EEA
originstringSQUAKE 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).
destinationstringSame formats as origin.
distance_in_kmnumberTakes priority over origin and destination. Without it, SQUAKE resolves the distance from them. If you send both, SQUAKE uses distance_in_km.
number_of_daysintegerAt 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_typeenumOne of diesel, petrol, hybrid, electricity, midgrade_gasoline, natural_gas, premium_gasoline, regular_gasoline, propane. Defaults to petrol.
manufacturerstringSee the database.
modelstringSee the database.
model_yearintegerSee the database.
countrystringISO 3166-1 alpha-2 or alpha-3 code: 2 to 3 uppercase letters (^[A-Z]{2,3}$).
electric_energy_consumption_in_kwnumberSee the database.
engine_capacity_in_cubic_cmnumberSee the database.
external_referencestringYour identifier for the item, up to 128 characters, so you can match results to requests. SQUAKE doesn't guarantee the order of items.
auditbooleanSet to true to create immutable audit records for finalised calculations. Must be enabled for your account.
POST /v2/calculations in the API referenceSample 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"
}]
}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.