Emissions - eCommerce Shipments.This is an advanced algorithm to estimate the emissions of a package's journey from its shipment location to the collection point. If the distance between two postal codes is above a threshold, we find the nearest airports from the origin and then from the destination location. The final distance of journey is then a sum of the distance between the origin postal code and nearest airport by land, air travel between the airports closest to the origin and the destination and finally, land travel between destination airport and postal code of collection point by land. The final calculation follows ECTA/Cefic and BEIS/DEFRA's recommended conversion factors and works on a database of over 1.5 million postal codes across 95 countries and 9,200 global airports.
|
Introduction
Ingested Data
ORIGIN_COUNTRY_CODE : Mandatory. Two letter code of the country from where the package is starting the journey.
ORIGIN_POSTAL_CODE : Mandatory. The postal code in the origin country from where the package is being shipped.
DESTINATION_COUNTRY_CODE : Mandatory. Two letter code of the country of package's destination.
DESTINATION_POSTAL_CODE : Mandatory. The postal code in the destination country to where the package is collected.
PACKAGE_WEIGHT : Mandatory. The weight of package in kilograms (KG). If an undefined value is passed, it will be set to 1.00
ADD_RF : Optional. A "Y" would add radiative forcing multiplier factor in the footprint calculation, while a "N" will bypass it. The default value is "N". This is used only if the algorithm considers air travel in its calculation.
INCLUDE_WTT : Optional. A "Y" would include the Well-to-Tank (WTT) factors to the footprint calculation, while a "N" will bypass it. The default value is "N".
ORIGIN_POSTAL_CODE : Mandatory. The postal code in the origin country from where the package is being shipped.
DESTINATION_COUNTRY_CODE : Mandatory. Two letter code of the country of package's destination.
DESTINATION_POSTAL_CODE : Mandatory. The postal code in the destination country to where the package is collected.
PACKAGE_WEIGHT : Mandatory. The weight of package in kilograms (KG). If an undefined value is passed, it will be set to 1.00
ADD_RF : Optional. A "Y" would add radiative forcing multiplier factor in the footprint calculation, while a "N" will bypass it. The default value is "N". This is used only if the algorithm considers air travel in its calculation.
INCLUDE_WTT : Optional. A "Y" would include the Well-to-Tank (WTT) factors to the footprint calculation, while a "N" will bypass it. The default value is "N".
Example
Python Code
|
JSON Output
|
Notes
- The following countries (for origin and destination) are covered in this API: AD (Andorra), AR (Argentina), AS (American Samoa), AT (Austria), AU (Australia), AX (Åland Islands), AZ (Azerbaijan), BD (Bangladesh), BE (Belgium), BG (Bulgaria), BM (Bermuda), BR (Brazil), BY (Belarus), CA (Canada), CH (Switzerland), CL (Chile), CO (Colombia), CR (Costa Rica), CY (Cyprus), CZ (Czechia), DE (Germany), DK (Denmark), DO (Dominican Republic (the)), DZ (Algeria), EE (Estonia), ES (Spain), FI (Finland), FM (Micronesia (Federated States of)), FO (Faroe Islands (the)), FR (France), GB (United Kingdom of Great Britain and Northern Ireland (the)), GF (French Guiana), GG (Guernsey), GL (Greenland), GP (Guadeloupe), GT (Guatemala), GU (Guam), HR (Croatia), HT (Haiti), HU (Hungary), IE (Ireland), IM (Isle of Man), IN (India), IS (Iceland), IT (Italy), JE (Jersey), JP (Japan), KR (Korea (the Republic of)), LI (Liechtenstein), LK (Sri Lanka), LT (Lithuania), LU (Luxembourg), LV (Latvia), MC (Monaco), MD (Moldova (the Republic of)), MH (Marshall Islands (the)), MK (Republic of North Macedonia), MP (Northern Mariana Islands (the)), MQ (Martinique), MT (Malta), MW (Malawi), MX (Mexico), MY (Malaysia), NC (New Caledonia), NL (Netherlands (the)), NO (Norway), NZ (New Zealand), PE (Peru), PH (Philippines (the)), PK (Pakistan), PL (Poland), PM (Saint Pierre and Miquelon), PR (Puerto Rico), PT (Portugal), PW (Palau), RE (Réunion), RO (Romania), RS (Serbia), RU (Russian Federation (the)), SE (Sweden), SG (Singapore), SI (Slovenia), SJ (Svalbard and Jan Mayen), SK (Slovakia), SM (San Marino), TH (Thailand), TR (Turkey), UA (Ukraine), US (United States of America (the)), UY (Uruguay), VA (Holy See (the)), VI (Virgin Islands (U.S.)), WF (Wallis and Futuna), YT (Mayotte) and ZA (South Africa).
- If you are interested in the details of algorithm (say the value of threshold used and our approach to calculation of distances between airports), please contact us. We will share our approach with you.