This endpoint returns CO2e emissions (i.e CO2 equivalent emissions) for a voyage from a city to another by road. The emissions are calculated using the real network distance.
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).
The weight of the transported goods can be given. If no weight is specified, the API returns the amount of CO2e for 1 metric ton of goods. If the weight is specified, you must also provide the size of the truck (gross vehicle weight in tons) except for North America where the truck size is not taken into account.
The size of the truck (gross vehicle weight in tons) and 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.
The emissions are calculated based on the region. Supported regions are Europe, North America, South America, Africa and Asia.
You can also specify the type of cargo : either container or mixed.
The response also contains the distance (in meters) and the parameters that were taken into account for the calculation, for example the size range of the truck (min and max gross weight), the fuel used and the load factor.
The emissions are calculated using the GLEC framework.
You can find detailed information about the calculation and the hypothesis in our Guide section.