This endpoint returns CO2e emissions (i.e CO2 equivalent emissions) in grams (g) for a voyage from a city to another by road.
Origin and destination
The source and destination can be given either by locode or coordinates.
You must provide either fromLocode or fromCoordinates and either toLocode or toCoordinates.
The emissions are calculated using the real road network distance and based on the region.
Supported regions are Europe, North America, Ocenia South America, Africa and Asia. Note that the origin and the destination should be in the same region.
Container specifications (nContainers, nContainers), weight and loadCharacteristics define the cargo specifications.
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 some use cases :
use the parameters nContainers and containerSizeTypeCode. If a weight is passed, it will be ignored and an estimate weight will be taken into account for CO2e calculation.
The type of cargo in that case is set to CONTAINER.
An appropriate truckSize will be chosen for you (except you pass one).
use the parameters weight and set the loadCharacteristics (type of cargo) parameter to CONTAINER. An appropriate truckSize will be chosen for you (except you pass one). You can pass an appropriate containerSizeTypeCode. (For reefer, you can choose 22R1)
If no weight is specified and no loadCharacteristics is set, the API returns the amount of CO2e for 1 metric ton of goods in the worst scenario (smallest truck) (loadCharacteristics = AVERAGE_MIXED or DEFAULT )
If the weight is specified, you must also provide the size of the truck (gross vehicle weight in tons) except for North America and Oceania where the truck size is not taken into account.
The fuel type (among diesel, cng, lng or petrol for vans (<3.5t)) can be given for more accurate CO2e values. Note that the diesel type is 5% biodiesel and only diesel is available for North America.
For Europe, South America, Africa and Asia regions, you can pass a truck size (gross vehicle weight - GVW) for more accurate results.
The response contains WTW (well-to-wheels) CO2e emissions in g for the amount of goods carried and detailed emissions : WTT (well-to-tank) and TTW (tank-to-wheels). It also contains the intensity factor (grams of CO2e per ton.kilometer) which is calculated from the WTW CO2e emissions, the distance and the weight (in properties).
The field parameters contains the parameters that were passed in the query and the default values that were used. Depending on the combination of parameters you enter, the default values for other parameters may vary. For example, the default truckSize for average mixed goods is 3t while it is 33t for container.
The field properties contains information about the data that was used for the calculation, for example the distance, some characteristics about the truck, the hypothesis made for load factor, etc. 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).
The emissions are calculated using the GLEC framework.
You can find detailed information about the calculation and the hypothesis in our Guide section.
Click Try It! to start a request and see the response here!