Query route emissions
To receive data about the emissions of a planned route, use the routeEmissions query. It provides information on the embedded, operational and, end_of_life emissions. The data is available for the vehicle used on the route and an internal combustion engine equivalent.
Query
A route_id is required to get routeEmissions data. Create a route_id by using the newRoute mutation as described here. Optionally, use the route_alternative_id to receive the emissions of an alternative route.
The routeEmissions query is currently released as a beta product and thus experimental. Anything within the emissions query may change, break, or disappear at any time. As long as the feature is in beta, it is free of charge.
Arguments
route_id • ID
• Required
ID of the route for which we retrieve the emissions profile.
route_alternative_id • ID
ID of the route alternative for which we retrieve the emissions profile. If not provided, we will retrieve the recommended alternative.
Frequently used fields
route_vehicle • RouteVehicleEmissions
Emissions profile for the vehicle used in route.
total • Float
Total co2e emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
embedded • RouteEmbeddedEmissions
Embedded emissions.
total • Float
Total embedded emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
manufacturing • RouteEmbeddedManufacturingEmissions
Total manufacturing emissions.
total • Float
Total embedded manufacturing emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
body • Float
Body manufacturing emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
battery • Float
Lithium ion battery manufacturing emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
distribution • Float
Total distribution related emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
maritime • RouteEmbeddedMaritimeEmissions
Distribution sea segment emissions.
total • Float
Total embedded maritime emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
fuel • Float
Fuel related sea segment emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
port • Float
Port facility related sea segment emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
idle • Float
Idling related sea segment emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
lifecycle • Float
Distributed lifecycle related sea segment emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
land • RouteEmbeddedLandEmissions
Distribution land segment emissions.
total • Float
Total embedded land emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
fuel • Float
Distribution land segment emissions from fuel consumption.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
lifecycle • Float
Distribution land segment lifecycle emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
operational • RouteVehicleOperationalEmissions
Operational emissions.
total • Float
Total operational emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
electricity • RouteOperationalElectricityEmissions
Electricity emissions data.
total • Float
Total electricity emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
base_emissions • Float
Base emissions without efficiency losses.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
battery_losses • Float
Emissions for electricity lost in the battery.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
transmission_losses • Float
Emissions for electricity lost in transmission.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
chargepoint_losses • Float
Emissions for electricity lost during charging.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
electricity_efficiency • RouteOperationalElectricityEmissionsEfficiency
Electricity efficiency information.
total_efficiency • Float
Average total electricity efficiency.
battery_efficiency • Float
Average efficiency of the battery.
transmission_efficiency • Float
Average efficiency of electricity transmission.
base_transmission_efficiency • Float
Average base regional grid efficiency.
transmission_efficiency_temperature_modifier • Float
Average transmission efficiency change due to temperature.
chargepoint_efficiency • Float
Average efficiency of the chargepoint.
evse_efficiency • Float
Average evse efficiency.
breaker_efficiency • Float
Average breaker efficiency.
power_electronics_unit_efficiency • Float
Average power electronics unit efficiency.
transformer_efficiency • Float
Average transformer efficiency.
chargepoint_efficiency_temperature_modifier • Float
Change in chargepoint efficiency due to temperature.
average_charging_current • Float
Average charging current in amperes.
average_charging_voltage • Float
Average charging voltage in volts.
average_temperature • Float
Average outside temperature.
Show arguments
unit • TemperatureUnit
Type of temperature.
Default • Celsius
Show TemperatureUnit enum values
Celsius
Return the temperature in Celsius.
Fahrenheit
Return the temperature in Fahrenheit.
average_regional_temperature • Float
Average regional temperature.
Show arguments
unit • TemperatureUnit
Type of temperature.
Default • Celsius
Show TemperatureUnit enum values
Celsius
Return the temperature in Celsius.
Fahrenheit
Return the temperature in Fahrenheit.
electricity_intensity • RouteOperationalElectricityEmissionsIntensity
Electricity intensity information.
total_electricity_intensity • Float
Average route electricity emissions intensity in unit CO2e/kWh.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
base_electricity_intensity • Float
Base regional electricity emissions intensity in unit CO2e/kWh.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
generation_methods • RouteOperationalElectricityEmissionsGenerationMethods
Generation methods of electricity production.
coal • Float
Fraction of coal production.
gas • Float
Fraction of gas production.
hydro • Float
Fraction of hydroelectric production.
solar • Float
Fraction of solar production.
wind • Float
Fraction of wind production.
oil • Float
Fraction of oil production.
nuclear • Float
Fraction of nuclear production.
biofuel • Float
Fraction of biofuel production.
other • Float
Fraction of other production.
electricity_infrastructure_intensity • Float
Average emissions intensity of processing and transport of primary energy, power generation infrastructure, etc in unit CO2e/kWh.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
season • RouteOperationalElectricitySeason
Season for which the route was calculated.
Show RouteOperationalElectricitySeason enum values
winter
Winter season.
spring
Spring season.
summer
Summer season.
fall
Fall season.
climate • RouteOperationalElectricityClimate
The climate for which the route was calculated.
Show RouteOperationalElectricityClimate enum values
Af
Tropical rain forest climate.
Am
Tropical monsoon climate.
Aw
Tropical savanna climate, dry summer.
As
Tropical savanna climate, dry winter.
BWh
Hot desert climate.
BWk
Cold desert climate.
BSh
Hot semi-arid climate.
BSk
Cold semi-arid climate.
Cwa
Monsoon-influenced humid subtropical climate.
Cwb
Subtropical highland climate.
Cwc
Cold subtropical highland climate.
Cfa
Humid subtropical climate.
Cfb
Temperate oceanic climate.
Cfc
Sub polar oceanic climate.
Csa
Hot-summer Mediterranean climate.
Csb
Warm-summer Mediterranean climate.
Csc
Cold-summer Mediterranean climate.
Dwa
Monsoon-influenced hot-summer humid continental climate.
Dwb
Monsoon-influenced warm-summer humid continental climate.
Dwc
Monsoon-influenced subarctic climate.
Dwd
Monsoon-influenced extremely cold subarctic climate.
Dfa
Hot-summer humid continental climate.
Dfb
Warm-summer humid continental climate.
Dfc
Subarctic climate.
Dfd
Extremely cold subarctic climate.
Dsa
Mediterranean-influenced hot-summer humid continental climate.
Dsb
Mediterranean-influenced warm-summer humid continental climate.
Dsc
Mediterranean-influenced subarctic climate.
Dsd
Mediterranean-influenced extremely cold subarctic climate.
ET
Tundra climate.
EF
Ice cap climate.
average_electricity_demand • Float
Average electricity demand at the time of route charges as a fraction of average demand.
base_load_fraction • Float
Fraction of regional power generation that is not affected by demand (always on).
infrastructure • RouteOperationalInfrastructureEmissions
Total road infrastructure emissions.
total • Float
Total infrastructure.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
embedded • Float
Embedded (construction, decommissioning, etc) emissions cost.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
maintenance • Float
Induced maintenance emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
maintenance • RouteOperationalMaintenanceEmissions
Total maintenance emissions.
total • Float
Total maintenance.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
fluids • RouteOperationalFluidEmissions
Total fluid related maintenance emissions.
total • Float
Total fluid.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
wiper • Float
Total wiper fluid maintenance emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
brake • Float
Total brake fluid maintenance emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
coolant • Float
Total powertrain coolant fluid maintenance emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
transmission • Float
Total transmission fluid maintenance emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
motor_oil • Float
Total motor oil maintenance emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
battery • Float
Battery related maintenance emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
tires • Float
Tire related maintenance emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
components • Float
Miscellaneous component maintenance emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
repair • Float
Accident repair related maintenance emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
end_of_life • RouteEndOfLifeEmissions
End of life emissions.
total • Float
Total end of life emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
fluids • RouteEndOfLifeFluidsEmissions
Total fluid related end of life emissions.
total • Float
Total end of life fluids emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
wiper • Float
Total wiper fluid end of life emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
brake • Float
Total brake fluid end of life emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
coolant • Float
Total powertrain coolant fluid end of life emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
transmission • Float
Total transmission fluid end of life emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
motor_oil • Float
Total motor oil end of life emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
battery • Float
Battery related end of life emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
tires • Float
Tire related end of life emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
body • Float
Body end of life emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
transport • Float
Transport end of life emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
legs • RouteVehicleLegEmissions
Emissions info for the legs in the order as within the route.
total • Float
Total co2e emissions for the leg.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
embedded • RouteEmbeddedEmissions
Embedded emissions for the leg.
total • Float
Total embedded emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
manufacturing • RouteEmbeddedManufacturingEmissions
Total manufacturing emissions.
total • Float
Total embedded manufacturing emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
body • Float
Body manufacturing emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
battery • Float
Lithium ion battery manufacturing emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
distribution • Float
Total distribution related emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
maritime • RouteEmbeddedMaritimeEmissions
Distribution sea segment emissions.
total • Float
Total embedded maritime emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
fuel • Float
Fuel related sea segment emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
port • Float
Port facility related sea segment emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
idle • Float
Idling related sea segment emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
lifecycle • Float
Distributed lifecycle related sea segment emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
land • RouteEmbeddedLandEmissions
Distribution land segment emissions.
total • Float
Total embedded land emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
fuel • Float
Distribution land segment emissions from fuel consumption.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
lifecycle • Float
Distribution land segment lifecycle emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
operational • RouteVehicleOperationalEmissions
Operational emissions for the leg.
total • Float
Total operational emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
electricity • RouteOperationalElectricityEmissions
Electricity emissions data.
total • Float
Total electricity emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
base_emissions • Float
Base emissions without efficiency losses.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
battery_losses • Float
Emissions for electricity lost in the battery.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
transmission_losses • Float
Emissions for electricity lost in transmission.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
chargepoint_losses • Float
Emissions for electricity lost during charging.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
electricity_efficiency • RouteOperationalElectricityEmissionsEfficiency
Electricity efficiency information.
total_efficiency • Float
Average total electricity efficiency.
battery_efficiency • Float
Average efficiency of the battery.
transmission_efficiency • Float
Average efficiency of electricity transmission.
base_transmission_efficiency • Float
Average base regional grid efficiency.
transmission_efficiency_temperature_modifier • Float
Average transmission efficiency change due to temperature.
chargepoint_efficiency • Float
Average efficiency of the chargepoint.
evse_efficiency • Float
Average evse efficiency.
breaker_efficiency • Float
Average breaker efficiency.
power_electronics_unit_efficiency • Float
Average power electronics unit efficiency.
transformer_efficiency • Float
Average transformer efficiency.
chargepoint_efficiency_temperature_modifier • Float
Change in chargepoint efficiency due to temperature.
average_charging_current • Float
Average charging current in amperes.
average_charging_voltage • Float
Average charging voltage in volts.
average_temperature • Float
Average outside temperature.
Show arguments
unit • TemperatureUnit
Type of temperature.
Default • Celsius
Show TemperatureUnit enum values
Celsius
Return the temperature in Celsius.
Fahrenheit
Return the temperature in Fahrenheit.
average_regional_temperature • Float
Average regional temperature.
Show arguments
unit • TemperatureUnit
Type of temperature.
Default • Celsius
Show TemperatureUnit enum values
Celsius
Return the temperature in Celsius.
Fahrenheit
Return the temperature in Fahrenheit.
electricity_intensity • RouteOperationalElectricityEmissionsIntensity
Electricity intensity information.
total_electricity_intensity • Float
Average route electricity emissions intensity in unit CO2e/kWh.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
base_electricity_intensity • Float
Base regional electricity emissions intensity in unit CO2e/kWh.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
generation_methods • RouteOperationalElectricityEmissionsGenerationMethods
Generation methods of electricity production.
coal • Float
Fraction of coal production.
gas • Float
Fraction of gas production.
hydro • Float
Fraction of hydroelectric production.
solar • Float
Fraction of solar production.
wind • Float
Fraction of wind production.
oil • Float
Fraction of oil production.
nuclear • Float
Fraction of nuclear production.
biofuel • Float
Fraction of biofuel production.
other • Float
Fraction of other production.
electricity_infrastructure_intensity • Float
Average emissions intensity of processing and transport of primary energy, power generation infrastructure, etc in unit CO2e/kWh.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
season • RouteOperationalElectricitySeason
Season for which the route was calculated.
Show RouteOperationalElectricitySeason enum values
winter
Winter season.
spring
Spring season.
summer
Summer season.
fall
Fall season.
climate • RouteOperationalElectricityClimate
The climate for which the route was calculated.
Show RouteOperationalElectricityClimate enum values
Af
Tropical rain forest climate.
Am
Tropical monsoon climate.
Aw
Tropical savanna climate, dry summer.
As
Tropical savanna climate, dry winter.
BWh
Hot desert climate.
BWk
Cold desert climate.
BSh
Hot semi-arid climate.
BSk
Cold semi-arid climate.
Cwa
Monsoon-influenced humid subtropical climate.
Cwb
Subtropical highland climate.
Cwc
Cold subtropical highland climate.
Cfa
Humid subtropical climate.
Cfb
Temperate oceanic climate.
Cfc
Sub polar oceanic climate.
Csa
Hot-summer Mediterranean climate.
Csb
Warm-summer Mediterranean climate.
Csc
Cold-summer Mediterranean climate.
Dwa
Monsoon-influenced hot-summer humid continental climate.
Dwb
Monsoon-influenced warm-summer humid continental climate.
Dwc
Monsoon-influenced subarctic climate.
Dwd
Monsoon-influenced extremely cold subarctic climate.
Dfa
Hot-summer humid continental climate.
Dfb
Warm-summer humid continental climate.
Dfc
Subarctic climate.
Dfd
Extremely cold subarctic climate.
Dsa
Mediterranean-influenced hot-summer humid continental climate.
Dsb
Mediterranean-influenced warm-summer humid continental climate.
Dsc
Mediterranean-influenced subarctic climate.
Dsd
Mediterranean-influenced extremely cold subarctic climate.
ET
Tundra climate.
EF
Ice cap climate.
average_electricity_demand • Float
Average electricity demand at the time of route charges as a fraction of average demand.
base_load_fraction • Float
Fraction of regional power generation that is not affected by demand (always on).
infrastructure • RouteOperationalInfrastructureEmissions
Total road infrastructure emissions.
total • Float
Total infrastructure.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
embedded • Float
Embedded (construction, decommissioning, etc) emissions cost.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
maintenance • Float
Induced maintenance emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
maintenance • RouteOperationalMaintenanceEmissions
Total maintenance emissions.
total • Float
Total maintenance.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
fluids • RouteOperationalFluidEmissions
Total fluid related maintenance emissions.
total • Float
Total fluid.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
wiper • Float
Total wiper fluid maintenance emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
brake • Float
Total brake fluid maintenance emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
coolant • Float
Total powertrain coolant fluid maintenance emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
transmission • Float
Total transmission fluid maintenance emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
motor_oil • Float
Total motor oil maintenance emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
battery • Float
Battery related maintenance emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
tires • Float
Tire related maintenance emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
components • Float
Miscellaneous component maintenance emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
repair • Float
Accident repair related maintenance emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
end_of_life • RouteEndOfLifeEmissions
End of life emissions for the leg.
total • Float
Total end of life emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
fluids • RouteEndOfLifeFluidsEmissions
Total fluid related end of life emissions.
total • Float
Total end of life fluids emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
wiper • Float
Total wiper fluid end of life emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
brake • Float
Total brake fluid end of life emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
coolant • Float
Total powertrain coolant fluid end of life emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
transmission • Float
Total transmission fluid end of life emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
motor_oil • Float
Total motor oil end of life emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
battery • Float
Battery related end of life emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
tires • Float
Tire related end of life emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
body • Float
Body end of life emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
transport • Float
Transport end of life emissions.
Show arguments
unit • EmissionUnit
Type of the emissions weight.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
Other fields
route_id • ID
ID of the route for which we retrieve the emissions profile.
route_alternative_id • ID
ID of the route alternative for which we retrieve the emissions profile.
internal_combustion_vehicle • RouteInternalCombustionVehicleEmissions
Emissions profile for an equivalent internal combustion engine vehicle.
Show arguments
fuel_type • RouteOperationalFuelType
Type of internal combustion engine.
Default • gasoline
Show RouteOperationalFuelType enum values
gasoline
Gasoline fuel.
diesel
Diesel fuel.
Response
A response can either contain a data or an
errors object. The response header will always return
200 as a status code.
Data object
When successful, a data object will be returned with the
requested fields. If there are no fields present the
data object will return the operation name with the
appropriate return type. If the operation was a query, this output
will be an object of the schema’s query root type; if the operation
was a mutation, this output will be an object of the schema’s mutation
root type.
Error object
If unsuccessful, an errors object will be returned with
more details in the extensions object. The error object
can contain any of the following objects.
Error
ROUTE_ALTERNATIVE_NOT_FOUND
No route alternative was found with the provided ID
Error
ROUTE_EMISSIONS_FOR_DRIVETRAIN_NOT_AVAILABLE
Cannot find route emissions for vehicles with drivetrain type $TYPE.
Error
ROUTE_EMISSIONS_FOR_STATUS_NOT_AVAILABLE
Cannot query emissions for a route with status $STATUS.
Error
ROUTE_EMISSIONS_NOT_FOUND
Route emission profile was not found with the provided ID
Error
ROUTE_NOT_FOUND
No route was found with the provided ID