Emissions Calculator
The Emissions Calculator API calculates the CO2e (carbon dioxide equivalent) emission of a trip. You send a route and the transport modes that you want to compare. The API returns the emission in grams for each transport mode. Use it, for example, to show travellers the climate impact of a trip, or to compare public transport with car or plane.
For all fields, transport modes, rate limits and errors, see the API reference.
How the API calculates the emission
For most transport modes, the SINTEF Multi-modal Energy and Emissions Calculation model (SMEC) calculates the emission. It uses the route and a typical vehicle for the transport mode. The emission includes the full lifecycle of the vehicle: production of the fuel or energy, manufacture, maintenance and tailpipe emission.
- Train, plane, bus, metro, tram and ferry: the emission of one vehicle, divided by the number of passengers the vehicle can carry and multiplied by the number of passengers.
- Car and motorcycle: the emission of all the vehicles that are necessary for the passengers.
- Bike, electric bike and electric scooter: the distance multiplied by a fixed factor from SINTEF for each passenger kilometre.
To read more about the calculation basis, see About the calculation in Entur's Miljøkalkulator (in Norwegian).
Limitations
The emissions are estimates. SMEC calculates them for a typical vehicle from SINTEF, not for the vehicle that actually runs. The API chooses which typical vehicle to use. For train, the line decides if the vehicle is a diesel or an electric train. For tram, the city decides the vehicle. For train, plane, bus, metro, tram and ferry, the API divides the emission of the vehicle by the number of passengers the vehicle can carry, not by the actual number of passengers.
Terms of use
Anyone can use the API. When you use or show the results, credit Entur as described in Attribution for open data.
Authentication
The Emissions Calculator is an open service. Include the ET-Client-Name header in all requests. Use a value that identifies your company and application, in the form <company>-<application> (lowercase, no spaces).
For more information, see Client identification.
Example
This request compares train, diesel car and bike for two passengers from Oslo S to Bergen stasjon. The route is given as stop IDs. You can also give it as coordinates.
Code
The response usually has one calculation for each transport mode. The total emission for all passengers is in calculationSummary.co2eEmissionInGrams.
Related topics
- Read how to identify your client in Client identification.
- Look up stop place identifiers in the Stop places documentation.
- Plan a trip and get the stop IDs with the Journey Planner.