Route emissions

Get the emissions profile of a route by using the legacy routeEmissions query. New integrations should use the getRouteEmissions query instead.

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.

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.

route_vehicle· RouteVehicleEmissions

Emissions profile for the vehicle used in route.

internal_combustion_vehicle· RouteInternalCombustionVehicleEmissions

Emissions profile for an equivalent internal combustion engine vehicle.

Errors

Operations can fail. Account for the following error scenarios to handle them correctly. More on errors here.

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.
rate_limit_exceeded: Rate limit exceeded.
route_alternative_not_found: No route alternative was found with the provided ID.
route_emissions_for_drivetrain_not_available: Cannot find route emissions for vehicles with drivetrain type $TYPE.
route_emissions_for_status_not_available: Cannot query emissions for a route with status $STATUS.
route_emissions_not_found: Route emission profile was not found with the provided ID.
route_not_found: No route was found with the provided ID.

Was this content helpful?

Query example

x-client-id

x-app-id

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617

query {
  routeEmissions(route_id: "Enter your id here") {
    route_id
    route_alternative_id
    route_vehicle {
      total
      iso_14083_2023
      embedded {
        total
        manufacturing {
          total
          body
          battery
        }
        distribution
        maritime {
          total
          fuel
          port
          idle
          lifecycle
        }
        land {
          total
          fuel
          lifecycle
        }
      }
      operational {
        total
        electricity {
          total
          base_value
          battery_losses
          transmission_losses
          chargepoint_losses
          efficiency {
            total
            battery
            transmission
            base_transmission
            transmission_temperature_modifier
            chargepoint
            evse
            breaker
            power_electronics_unit
            transformer
            chargepoint_temperature_modifier
            average_charging_current
            average_charging_voltage
            average_temperature
            average_regional_temperature
          }
          intensity {
            total
            average_base_regional_value
            iso_14083_2023
            energy_sources {
              coal {
                fraction
                intensity
              }
              gas {
                fraction
                intensity
              }
              hydro {
                fraction
                intensity
              }
              solar {
                fraction
                intensity
              }
              wind {
                fraction
                intensity
              }
              oil {
                fraction
                intensity
              }
              nuclear {
                fraction
                intensity
              }
              biofuel {
                fraction
                intensity
              }
              geothermal {
                fraction
                intensity
              }
              other {
                fraction
                intensity
              }
            }
            infrastructure
            average_demand
            base_load_fraction
          }
        }
        infrastructure {
          total
          embedded
          maintenance
        }
        maintenance {
          total {
            total
            production
            disposal
          }
          fluids {
            total {
              total
              production
              disposal
            }
            wiper {
              total
              production
              disposal
            }
            brake {
              total
              production
              disposal
            }
            powertrain_coolant {
              total
              production
              disposal
            }
            transmission {
              total
              production
              disposal
            }
            motor_oil {
              total
              production
              disposal
            }
          }
          battery {
            total
            production
            disposal
          }
          tires {
            total
            production
            disposal
          }
          components {
            total
            production
            disposal
          }
          repair {
            total
            production
            disposal
          }
        }
      }
      end_of_life {
        total
        fluids {
          total
          wiper
          brake
          powertrain_coolant
          transmission
          motor_oil
        }
        battery
        tires
        body
        transport
      }
      legs {
        total
        iso_14083_2023
        embedded {
          total
          manufacturing {
            total
            body
            battery
          }
          distribution
          maritime {
            total
            fuel
            port
            idle
            lifecycle
          }
          land {
            total
            fuel
            lifecycle
          }
        }
        operational {
          total
          electricity {
            total
            base_value
            battery_losses
            transmission_losses
            chargepoint_losses
            efficiency {
              total
              battery
              transmission
              base_transmission
              transmission_temperature_modifier
              chargepoint
              evse
              breaker
              power_electronics_unit
              transformer
              chargepoint_temperature_modifier
              average_charging_current
              average_charging_voltage
              average_temperature
              average_regional_temperature
            }
            intensity {
              total
              base_regional_value {
                name
                type
                value
              }
              base_iso_14083_2023_regional_value {
                name
                type
                value
              }
              energy_sources {
                coal {
                  fraction
                  intensity
                }
                gas {
                  fraction
                  intensity
                }
                hydro {
                  fraction
                  intensity
                }
                solar {
                  fraction
                  intensity
                }
                wind {
                  fraction
                  intensity
                }
                oil {
                  fraction
                  intensity
                }
                nuclear {
                  fraction
                  intensity
                }
                biofuel {
                  fraction
                  intensity
                }
                geothermal {
                  fraction
                  intensity
                }
                other {
                  fraction
                  intensity
                }
              }
              energy_source_model
              infrastructure
              season
              climate
              average_demand
              base_load_fraction
            }
          }
          infrastructure {
            total
            embedded
            maintenance
          }
          maintenance {
            total {
              total
              production
              disposal
            }
            fluids {
              total {
                total
                production
                disposal
              }
              wiper {
                total
                production
                disposal
              }
              brake {
                total
                production
                disposal
              }
              powertrain_coolant {
                total
                production
                disposal
              }
              transmission {
                total
                production
                disposal
              }
              motor_oil {
                total
                production
                disposal
              }
            }
            battery {
              total
              production
              disposal
            }
            tires {
              total
              production
              disposal
            }
            components {
              total
              production
              disposal
            }
            repair {
              total
              production
              disposal
            }
          }
        }
        end_of_life {
          total
          fluids {
            total
            wiper
            brake
            powertrain_coolant
            transmission
            motor_oil
          }
          battery
          tires
          body
          transport
        }
      }
    }
    internal_combustion_vehicle {
      total
      iso_14083_2023
      embedded {
        total
        manufacturing {
          total
          body
          battery
        }
        distribution
        maritime {
          total
          fuel
          port
          idle
          lifecycle
        }
        land {
          total
          fuel
          lifecycle
        }
      }
      operational {
        total
        fuel {
          total
          direct
          indirect
          consumption
          vehicle_weight
          engine_torque
          powertrain_efficiency
          base_powertrain_efficiency
          powertrain_efficiency_speed_modifier
          average_speed
        }
        infrastructure {
          total
          embedded
          maintenance
        }
        maintenance {
          total {
            total
            production
            disposal
          }
          fluids {
            total {
              total
              production
              disposal
            }
            wiper {
              total
              production
              disposal
            }
            brake {
              total
              production
              disposal
            }
            powertrain_coolant {
              total
              production
              disposal
            }
            transmission {
              total
              production
              disposal
            }
            motor_oil {
              total
              production
              disposal
            }
          }
          battery {
            total
            production
            disposal
          }
          tires {
            total
            production
            disposal
          }
          components {
            total
            production
            disposal
          }
          repair {
            total
            production
            disposal
          }
        }
      }
      end_of_life {
        total
        fluids {
          total
          wiper
          brake
          powertrain_coolant
          transmission
          motor_oil
        }
        battery
        tires
        body
        transport
      }
      legs {
        total
        iso_14083_2023
        embedded {
          total
          manufacturing {
            total
            body
            battery
          }
          distribution
          maritime {
            total
            fuel
            port
            idle
            lifecycle
          }
          land {
            total
            fuel
            lifecycle
          }
        }
        operational {
          total
          fuel {
            total
            direct
            indirect
            consumption
            vehicle_weight
            engine_torque
            powertrain_efficiency
            base_powertrain_efficiency
            powertrain_efficiency_speed_modifier
            average_speed
          }
          infrastructure {
            total
            embedded
            maintenance
          }
          maintenance {
            total {
              total
              production
              disposal
            }
            fluids {
              total {
                total
                production
                disposal
              }
              wiper {
                total
                production
                disposal
              }
              brake {
                total
                production
                disposal
              }
              powertrain_coolant {
                total
                production
                disposal
              }
              transmission {
                total
                production
                disposal
              }
              motor_oil {
                total
                production
                disposal
              }
            }
            battery {
              total
              production
              disposal
            }
            tires {
              total
              production
              disposal
            }
            components {
              total
              production
              disposal
            }
            repair {
              total
              production
              disposal
            }
          }
        }
        end_of_life {
          total
          fluids {
            total
            wiper
            brake
            powertrain_coolant
            transmission
            motor_oil
          }
          battery
          tires
          body
          transport
        }
      }
    }
  }
}

Need help? Contact support.

Route emissions

Route emissions

Query changes

Arguments

Fields

Errors

Manage cookies

Essential cookies

Performance cookies

Marketing / advertising cookies

Third party promise

How you can control or opt out of cookies