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).
Cargo specifications
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 or 22G1 (20ft, General purpose (Standard)) [Default]
40GP or 42G1 (40ft, General purpose (Standard)),
40HC or 45G1 (40ft High cube, General Purpose),
22R1 (20ft, Reefer),
40NOR or 42R1 (40ft, Reefer),
40REHC or 45R1 (40ft High cube, Reefer)
Here are 3 common use cases :
FCL
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.
LCL
use the parameters weight
and set the loadCharacteristics
parameter to CONTAINER
. You can also choose an appopriate containerSizeTypeCode
(for reefer, choose 22R1).
Average
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.
Fuel
The fuel type can be precised when known. Note that the fuel types are not supported in all regions. Default is DIESEL
Response
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 (representarive of average operating practices) or modeled
data (taking into account vehicle information).
Methodology references
The emissions are calculated using the GLEC framework.