This endpoint returns CO2e emissions (i.e CO2e equivalent emissions) in grams (g) for a voyage from a given train station to another by train.
Origin and destination
The train stations can be given either as locodes or as coordinates.
You must provide either fromLocode or fromCoordinates and either toLocode or toCoordinates.
We currently support calculation whithin these regions : Europe, North America, South America, Asia, Oceania, Europe/Asia, Africa. Please note that both orgin and destination must be in the same region.
The distance between the origin and the destination is computed using rail networks, however you can use your own computed distance (in meters) using the parameter distance (the origin and destination remain mandatory because the co2 computation is region dependent).
Several parameters allow to define the specification of the cargo carried : nContainers, containerSizeTypeCode, weight and loadCharacteristics.
The following container types are supported by our API :
20GP, 22G1, 2200, 22G0, 2202, 2210 (20ft, General purpose (Standard)) [Default]
40GP, 42G1, 42G0, 40G1 (40ft, General purpose (Standard)),
40HC, 45G1, 45G0, 4500, 4510 (40ft High cube, General Purpose),
22R1, 2231 (20ft, Reefer),
40NOR, 42R1, 4531 (40ft, Reefer),
40REHC, 45R1, 45R8 (40ft High cube, Reefer),
53GP (53ft High cube).
Here are 3 common use cases :
use the parameters nContainers and containerSizeTypeCode.
If a weight is also passed, it will be ignored and an estimate weight will be taken into account for CO2e calculation. This estimated weight is based on the container specifications provided.
use the parameters weight and set the loadCharacteristics parameter to CONTAINER. You can also choose an appopriate containerSizeTypeCode (for reefer, choose 22R1).
if you pass no loadCharacteristics, and no container specifications, we assume you have a cargo of type AVERAGE_MIXED. Default weight is 1 metric ton in that case but can be specified if known.
The fuel type can be specified when known. Note that the fuel types are not supported in all regions. Default is DIESEL
The response contains WTT (well-to-tank) and TTW (tank-to-wheels) CO2e emissions in g for the amount of goods carried. It also contains the intensity factor (kg of CO2e per ton.kilometer) which is calculated from the WTW CO2e emissions, the distance and the weight (in properties).
The response contains a parameters field which contains all the parameters that were passed in the query and the default values if some parameters were not passed.
The response contains a properties field which contains the useful information that was used for the calculation, for example the distance. The property dataType precise if the data used to calculate the CO2 emissions is default data (representative of average operating practices) or modeled data (taking into account vehicle information).
The emissions are calculated using the GLEC framework.