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. However, you can use the parameter distance (in meters) to pass your own distance (the origin and destination remain mandatory because the co2e computation is region-dependent).
Supported regions are: Europe, North America, Ocenia South America, Africa and Asia. Please note that both origin and destination must be in the same region.
Cargo specifications
Container specifications such as nContainers, nContainers, weight and loadCharacteristics define the cargo specifications.
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 some use cases:
Container
For a container use the parameters nContainers and containerSizeTypeCode.
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.
You can also pass a truckSize and a fuelType. Not all combinations are usable: in order to limit the errors and return CO2e emissions in most cases, we adapt truckSize and fuel parameters passed.
If you do not specify a truckSize, an appropiate one will be chosen for you (except if you pass one).
The parameters actually used are listed in the properties object of the response.
Average
If you do not specify the weight or the loadCharacteristics, we assume you have a cargo of type AVERAGE_MIXED. The default weight in that case is 1 metric ton of goods in the worst case 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.
Truck specifications
For regions including Europe, South America, Africa and Asia, you can pass a truckSize (gross vehicle weight - GVW) for more accurate results.
Fuel specifications
For greater accuracy in CO2e values, you can specify the fuel type from the following options:
- DIESEL
- CNG
- LNG
- HVO
- ELEC
- BIOLNG
- BIOCNG
- BIODIESEL
Diesel-Biodiesel blends:
- DIESEL99_BIODIESEL1 (99% Diesel, 1% Biodiesel)
- DIESEL98_BIODIESEL2 (98% Diesel, 2% Biodiesel)
- DIESEL95_BIODIESEL5 (95% Diesel, 5% Biodiesel)
- DIESEL93_BIODIESEL7 (93% Diesel, 7% Biodiesel)
- DIESEL90_BIODIESEL10 (90% Diesel, 10% Biodiesel)
- DIESEL80_BIODIESEL20 (80% Diesel, 20% Biodiesel)
- DIESEL50_BIODIESEL50 (50% Diesel, 50% Biodiesel)
For ELEC the calculation uses local emission factors from the origin.
Additionally, for vans weighing less than 3.5t, you may select LPG and PETROL as fuel options in regions including Europe, South America, Africa and Asia.
Carrier specifications (North America)
We can compute CO2e for a given truck carrier (identified by its SCAC). This is only available in North America (the from/to locations should be within this region) and the computation uses SmartWay carrier data (Dray (CONTAINER) and Mix (AVERAGE_MIXED)).
You can use the parameter carrierScac (which is a carrier alpha code identifier) to select the carrier.
Note that in that case we only support DIESEL as fuel type and the truckSize cannot be changed. If the SCAC passed is not valid or we don't have enough data to compute CO2e, the computation will be based on GLEC defaults. In that case, the carrierScac property in the field properties of the response is set to null.
Response
The response contains WTW (well-to-wheels) CO2e emissions in grams (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 (kg 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 indicates whether the data used to calculate the CO2 emissions is default data (representative of average operating practices) or modeled data (which takes into account specific vehicle information).
Methodology references
The emissions are calculated using the GLEC framework or SmartWay Carrier data.
You can find detailed information about the calculation and the hypothesis in our Guide section.