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 equivalent gasoline internal combustion engine vehicle.
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 is 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
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
iso_14083_2023 • Float
Total co2e emissions from vehicle operational processes calculated using the methodology in section 5.2.2 of ISO 14083:2023 and default emissions intensities in Annex K of the same document.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
embedded • RouteEmbeddedEmissions
Embedded emissions, for example emissions produced during manufacturing, transportation, and delivery.
total • Float
Total embedded emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
manufacturing • RouteEmbeddedManufacturingEmissions
Manufacturing emissions.
total • Float
Total embedded manufacturing emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
body • Float
Vehicle body manufacturing emissions.
Show arguments
unit • EmissionUnit
Emission unit.
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
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
distribution • Float
Total distribution emissions.
Show arguments
unit • EmissionUnit
Emission unit.
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
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
fuel • Float
Fuel related maritime segment emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
port • Float
Port facility related maritime segment emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
idle • Float
Idling related maritime segment emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
lifecycle • Float
Distributed lifecycle related maritime segment emissions.
Show arguments
unit • EmissionUnit
Emission unit.
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 segment emissions.
Show arguments
unit • EmissionUnit
Emission unit.
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
Emission unit.
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
Emission unit.
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
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
electricity • RouteOperationalElectricityEmissions
Electricity emissions.
total • Float
Total electricity emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
base_value • Float
Base emissions without efficiency losses.
Show arguments
unit • EmissionUnit
Emission unit.
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
Emission unit.
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
Emission unit.
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
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
efficiency • RouteOperationalElectricityEmissionsEfficiency
Electricity efficiency information.
total • Float
Average total electricity efficiency.
battery • Float
Average efficiency of the battery.
transmission • Float
Average estimated transmission efficiency using the base transmission efficiency adjusting for temperature.
base_transmission • Float
Average base regional grid transmission efficiency.
transmission_temperature_modifier • Float
Average transmission efficiency change due to temperature.
chargepoint • Float
Average efficiency of the chargepoint.
evse • Float
Average evse (electric vehicle supply equipment) efficiency of the chargepoint.
breaker • Float
Average circuit breaker efficiency of the chargepoint.
power_electronics_unit • Float
Average power electronics unit efficiency of the chargepoint.
transformer • Float
Average transformer efficiency of the chargepoint.
chargepoint_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
Temperature unit.
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
Temperature unit.
Default • Celsius
Show TemperatureUnit enum values
Celsius
Return the temperature in Celsius.
Fahrenheit
Return the temperature in Fahrenheit.
intensity • RouteOperationalElectricityEmissionsIntensity
Electricity intensity information.
total • Float
Total average electricity emissions intensity in unit CO2e/kWh.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
average_base_regional_value • Float
Average base regional electricity emissions intensity in unit CO2e/kWh.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
iso_14083_2023 • Float
Total electricity intensity used for iso 14083:2023 scope emissions estimate in unit CO2e/kWh.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
energy_sources • RouteOperationalElectricityEnergySources
Average electricity mix for the route.
coal • ElectricityGenerationMethod
Electricity produced by coal power plants.
fraction • Float
Fraction of total electricity production.
intensity • Float
Emissions per kWh of the generation method.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
gas • ElectricityGenerationMethod
Electricity produced by natural gas power plants.
fraction • Float
Fraction of total electricity production.
intensity • Float
Emissions per kWh of the generation method.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
hydro • ElectricityGenerationMethod
Electricity produced by hydroelectric power.
fraction • Float
Fraction of total electricity production.
intensity • Float
Emissions per kWh of the generation method.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
solar • ElectricityGenerationMethod
Electricity produced by solar power.
fraction • Float
Fraction of total electricity production.
intensity • Float
Emissions per kWh of the generation method.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
wind • ElectricityGenerationMethod
Electricity produced by wind power.
fraction • Float
Fraction of total electricity production.
intensity • Float
Emissions per kWh of the generation method.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
oil • ElectricityGenerationMethod
Electricity produced by oil power plants.
fraction • Float
Fraction of total electricity production.
intensity • Float
Emissions per kWh of the generation method.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
nuclear • ElectricityGenerationMethod
Electricity produced by nuclear power plants.
fraction • Float
Fraction of total electricity production.
intensity • Float
Emissions per kWh of the generation method.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
biofuel • ElectricityGenerationMethod
Electricity produced by biofuel/biomass.
fraction • Float
Fraction of total electricity production.
intensity • Float
Emissions per kWh of the generation method.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
geothermal • ElectricityGenerationMethod
Electricity produced by geothermal power plants.
fraction • Float
Fraction of total electricity production.
intensity • Float
Emissions per kWh of the generation method.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
other • ElectricityGenerationMethod
Electricity produced by other means.
fraction • Float
Fraction of total electricity production.
intensity • Float
Emissions per kWh of the generation method.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
infrastructure • Float
Average emissions intensity of processing and transport of primary energy, power generation infrastructure, etc. in unit CO2e/kWh.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
average_demand • Float
Average electricity demand at the time of route charges as a fraction of the annual average demand.
base_load_fraction • Float
Fraction of regional power generation that is not affected by demand (is assumed to always be on).
infrastructure • RouteOperationalInfrastructureEmissions
Road infrastructure emissions.
total • Float
Total road infrastructure emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
embedded • Float
Embedded (construction, decommissioning, etc) road infrastructure emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
maintenance • Float
Induced road infrastructure maintenance emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
maintenance • RouteOperationalMaintenanceEmissions
Maintenance emissions.
total • Float
Total maintenance emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
fluids • FluidEmissions
Fluid related maintenance emissions.
total • Float
Total fluid emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
wiper • Float
Wiper fluid maintenance emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
brake • Float
Brake fluid maintenance emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
powertrain_coolant • Float
Powertrain coolant fluid maintenance emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
transmission • Float
Transmission fluid maintenance emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
motor_oil • Float
Motor oil maintenance emissions.
Show arguments
unit • EmissionUnit
Emission unit.
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
Emission unit.
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
Emission unit.
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
Emission unit.
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
Emission unit.
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
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
fluids • FluidEmissions
Fluid related end of life emissions.
total • Float
Total fluid emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
wiper • Float
Wiper fluid maintenance emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
brake • Float
Brake fluid maintenance emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
powertrain_coolant • Float
Powertrain coolant fluid maintenance emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
transmission • Float
Transmission fluid maintenance emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
motor_oil • Float
Motor oil maintenance emissions.
Show arguments
unit • EmissionUnit
Emission unit.
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
Emission unit.
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
Emission unit.
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
Emission unit.
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
Emission unit.
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 same order as in the route.
total • Float
Total co2e emissions for the leg.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
iso_14083_2023 • Float
Total leg co2e emissions from vehicle operational processes using the methodology in section 5.2.2 of ISO 14083:2023 and default emissions intensities in Annex K of the same document.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
embedded • RouteEmbeddedEmissions
Embedded emissions, for example emissions produced during manufacturing, transportation, and delivery.
total • Float
Total embedded emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
manufacturing • RouteEmbeddedManufacturingEmissions
Manufacturing emissions.
total • Float
Total embedded manufacturing emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
body • Float
Vehicle body manufacturing emissions.
Show arguments
unit • EmissionUnit
Emission unit.
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
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
distribution • Float
Total distribution emissions.
Show arguments
unit • EmissionUnit
Emission unit.
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
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
fuel • Float
Fuel related maritime segment emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
port • Float
Port facility related maritime segment emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
idle • Float
Idling related maritime segment emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
lifecycle • Float
Distributed lifecycle related maritime segment emissions.
Show arguments
unit • EmissionUnit
Emission unit.
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 segment emissions.
Show arguments
unit • EmissionUnit
Emission unit.
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
Emission unit.
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
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
operational • RouteVehicleLegOperationalEmissions
Operational emissions for the leg.
total • Float
Total operational emissions for the leg.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
electricity • RouteLegOperationalElectricityEmissions
Electricity emissions data for the leg.
total • Float
Total electricity emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
base_value • Float
Base emissions without efficiency losses.
Show arguments
unit • EmissionUnit
Emission unit.
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
Emission unit.
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
Emission unit.
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
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
efficiency • RouteOperationalElectricityEmissionsEfficiency
Electricity efficiency information.
total • Float
Average total electricity efficiency.
battery • Float
Average efficiency of the battery.
transmission • Float
Average estimated transmission efficiency using the base transmission efficiency adjusting for temperature.
base_transmission • Float
Average base regional grid transmission efficiency.
transmission_temperature_modifier • Float
Average transmission efficiency change due to temperature.
chargepoint • Float
Average efficiency of the chargepoint.
evse • Float
Average evse (electric vehicle supply equipment) efficiency of the chargepoint.
breaker • Float
Average circuit breaker efficiency of the chargepoint.
power_electronics_unit • Float
Average power electronics unit efficiency of the chargepoint.
transformer • Float
Average transformer efficiency of the chargepoint.
chargepoint_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
Temperature unit.
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
Temperature unit.
Default • Celsius
Show TemperatureUnit enum values
Celsius
Return the temperature in Celsius.
Fahrenheit
Return the temperature in Fahrenheit.
intensity • RouteLegOperationalElectricityEmissionsIntensity
Electricity intensity information.
total • Float
Total average electricity emissions intensity in unit CO2e/kWh.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
base_regional_value • EmissionsFactor
Base regional electricity emissions intensity for the leg.
name • String
The name of the area for which the emissions factor was calculated.
type • EmissionsFactorType
The type of area for which the emissions factor was calculated.
Show EmissionsFactorType enum values
country
subregion
region
value • Float
The base regional emissions factor in CO2e/kWh.
base_iso_14083_2023_regional_value • EmissionsFactor
Base regional electricity intensity used for the ISO 14083:2023 emissions estimation.
name • String
The name of the area for which the emissions factor was calculated.
type • EmissionsFactorType
The type of area for which the emissions factor was calculated.
Show EmissionsFactorType enum values
country
subregion
region
value • Float
The base regional emissions factor in CO2e/kWh.
energy_sources • RouteOperationalElectricityEnergySources
Electricity mix for the leg.
coal • ElectricityGenerationMethod
Electricity produced by coal power plants.
fraction • Float
Fraction of total electricity production.
intensity • Float
Emissions per kWh of the generation method.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
gas • ElectricityGenerationMethod
Electricity produced by natural gas power plants.
fraction • Float
Fraction of total electricity production.
intensity • Float
Emissions per kWh of the generation method.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
hydro • ElectricityGenerationMethod
Electricity produced by hydroelectric power.
fraction • Float
Fraction of total electricity production.
intensity • Float
Emissions per kWh of the generation method.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
solar • ElectricityGenerationMethod
Electricity produced by solar power.
fraction • Float
Fraction of total electricity production.
intensity • Float
Emissions per kWh of the generation method.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
wind • ElectricityGenerationMethod
Electricity produced by wind power.
fraction • Float
Fraction of total electricity production.
intensity • Float
Emissions per kWh of the generation method.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
oil • ElectricityGenerationMethod
Electricity produced by oil power plants.
fraction • Float
Fraction of total electricity production.
intensity • Float
Emissions per kWh of the generation method.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
nuclear • ElectricityGenerationMethod
Electricity produced by nuclear power plants.
fraction • Float
Fraction of total electricity production.
intensity • Float
Emissions per kWh of the generation method.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
biofuel • ElectricityGenerationMethod
Electricity produced by biofuel/biomass.
fraction • Float
Fraction of total electricity production.
intensity • Float
Emissions per kWh of the generation method.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
geothermal • ElectricityGenerationMethod
Electricity produced by geothermal power plants.
fraction • Float
Fraction of total electricity production.
intensity • Float
Emissions per kWh of the generation method.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
other • ElectricityGenerationMethod
Electricity produced by other means.
fraction • Float
Fraction of total electricity production.
intensity • Float
Emissions per kWh of the generation method.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
infrastructure • Float
Average emissions intensity of processing and transport of primary energy, power generation infrastructure, etc. in unit CO2e/kWh.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
average_demand • Float
Estimated electricity demand at the time and place the electricity for this leg was obtained as a fraction of the annual average demand.
base_load_fraction • Float
Fraction of regional power generation that is not affected by demand (is assumed to always be on).
season • RouteOperationalElectricitySeason
Season for which the leg was calculated.
Show RouteOperationalElectricitySeason enum values
winter
Winter season.
spring
Spring season.
summer
Summer season.
fall
Fall season.
climate • RouteOperationalElectricityClimate
Climate for which the leg 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.
infrastructure • RouteOperationalInfrastructureEmissions
Total road infrastructure emissions for the leg.
total • Float
Total road infrastructure emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
embedded • Float
Embedded (construction, decommissioning, etc) road infrastructure emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
maintenance • Float
Induced road infrastructure maintenance emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
maintenance • RouteOperationalMaintenanceEmissions
Total maintenance emissions for the leg.
total • Float
Total maintenance emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
fluids • FluidEmissions
Fluid related maintenance emissions.
total • Float
Total fluid emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
wiper • Float
Wiper fluid maintenance emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
brake • Float
Brake fluid maintenance emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
powertrain_coolant • Float
Powertrain coolant fluid maintenance emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
transmission • Float
Transmission fluid maintenance emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
motor_oil • Float
Motor oil maintenance emissions.
Show arguments
unit • EmissionUnit
Emission unit.
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
Emission unit.
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
Emission unit.
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
Emission unit.
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
Emission unit.
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
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
fluids • FluidEmissions
Fluid related end of life emissions.
total • Float
Total fluid emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
wiper • Float
Wiper fluid maintenance emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
brake • Float
Brake fluid maintenance emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
powertrain_coolant • Float
Powertrain coolant fluid maintenance emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
transmission • Float
Transmission fluid maintenance emissions.
Show arguments
unit • EmissionUnit
Emission unit.
Default • gram
Show EmissionUnit enum values
gram
Return the emissions in grams.
ounce
Return the emissions in ounces.
motor_oil • Float
Motor oil maintenance emissions.
Show arguments
unit • EmissionUnit
Emission unit.
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
Emission unit.
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
Emission unit.
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
Emission unit.
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
Emission unit.
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
OPERATION_NOT_ALLOWED
You are not allowed to execute this operation. Enable it for the current application in the dashboard or reach out to customer support.
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.