# 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) ```json { "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) ```json { "expand": ["items"], "audit_for": "", "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`. ```json { "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 ```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" } ] } ``` *** ## 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](https://squake.notion.site/Car-EU-EEA-ab71fdacedb64b5184a62761b29c15a4?pvs=4) * `"model"`: See the [database](https://squake.notion.site/Car-EU-EEA-ab71fdacedb64b5184a62761b29c15a4?pvs=4) * `"model_year"`: See the [database](https://squake.notion.site/Car-EU-EEA-ab71fdacedb64b5184a62761b29c15a4?pvs=4) * `"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](https://squake.notion.site/Car-EU-EEA-ab71fdacedb64b5184a62761b29c15a4?pvs=4) * `"engine_capacity_in_cubic_cm"`: See the [database](https://squake.notion.site/Car-EU-EEA-ab71fdacedb64b5184a62761b29c15a4?pvs=4) * `"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](http://www.eea.europa.eu/ims/co2-performance-of-new-passenger). --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs-integration.squake.earth/api-calculations-request-response/travel/car/car-eea.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.