This endpoint returns CO2e emissions (i.e., CO2e equivalent emissions) in grams (g) for a train voyage between two specified train stations.
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 within these regions: Europe, North America, South America, Asia, Oceania, Europe/Asia, and Africa. Please note that both origin and destination must be in the same region.
The distance between the origin and destination is computed using rail networks. However, you can use your own computed distance (in meters) using the distance parameter.
It's important to note that while custom distance input is accepted, both the origin and destination remain mandatory as CO2e 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, 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 two common use cases:
Container
For a container, use the parameters nContainers and containerSizeTypeCode. Additionaly, you can set the parameter loadCharacteristics to CONTAINER.
If you also provide the weight of the goods, this value will take priority over the nContainers. If weight is not provided, an average of 10 tons per TEU will be taken into account for CO2e calculations.
Average
If you do not specify loadCharacteristics, or container specifications, we assume you have a cargo of type AVERAGE_MIXED. The default weight in that case is 1 metric ton, but it can be specified if known.
Fuel
The fuel type can be specified when known. Please note that certain fuel types may not be supported in all regions.
Response
The response contains WTT (well-to-tank) and TTW (tank-to-wheels) CO2e emissions in grams (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).
A parameters field is present, containing all the parameters that were passed in the query and the default values if some parameters were not passed.
Additionally, a properties field, which contains useful information used for the calculation, for example, the distance. The property dataType specifies if the data used to calculate the CO2e emissions is default data (representative of average operating practices) or modeled data (taking into account vehicle information).
Methodology references
The emissions are calculated using the GLEC framework.