The following endpoint allow to get emissions data for transports that finished tracking.
Details on how Transporeon Visibility calulcates calculates carbon emissions data can be found in the following help center article: https://intercom.help/sixfold/en/articles/5800433-carbon-visibility-methodology
...
GET emissions for transports
Make an authenticated GET request as shown in the example below:
...
The response contains a list of transports, sorted by the transport’s tracking start time (newest - oldest).
For each transport, various emissions related fields are can be present:
emissions_calculated_at: Timestamp of carbon emissions calculation.calculation_errors: Details on the error in case the system wasn’t able to calculate the emissionsplanned_emissions: TBD, why “planned” emissions?total_emissions: Accumulated emissions for all legs (is that right?)legs: Listing of single legs used for emissions calculation. A leg corresponds to a delivery going from one to another location (is that right?)emissions: Details to the emissions for each legstart_location&end_location: Latitude and longitude of leg start- and endlocationend locationdistance_km: The distance of the leg in kilometerstype: PRE_CARRIAGE - Which values do we have here?carriage_parameters: Details on the carriage, such asbio_fuel_shareandcarriage_mode_parametersexternal_costs: Details on theaccident_,external_andemissions_costas well as thetotal_external_costsin the specifiedcurrency
cargo: Details on the transported cargo, such as weight and volume.transport_activity_tonne_kms: TBDQuantifies the weight of cargo transported over distance. Calculated by multiplying the weight of the goods (in tonnes) by the distance traveled (in kilometers).emissions_intensity_gram_per_tonne_kms: TBDAmount of emissions produced for transporting one tonne of goods over one kilometer (g/tonne-km)
driven_distance: Driven distance in kilometer?kilometers.driven_distance_source: TBDSource of the driven distance data. Possible sources?fuel_based_emissions: Fuel consumption, type and other details.carbon_data_index: TBDComposite metric used to evaluate the overall carbon efficiency of transportation activities. Shows how good data input was given to be used for calculations. If only shipper data is given, then this is low (below 20%), if also carrier primary data is available then it is higher, up to 100%. Higher is better.
Example:
| Code Block | ||
|---|---|---|
| ||
{
"transports": [
{
"transport_id": "314159",
"emissions_calculated_at": "2019-08-24T14:15:22Z",
"transport_number": "T1234",
"calculation_errors": [
{
"error_type": "DISTANCE",
"error_code": "TOUR_WEIGHT_OUT_OF_ALLOWED_RANGE",
"error_message": "Skipping CO2 emissions calculation, weight data invalid, weightInTonnes: 0, main_mode: undefined"
}
],
"planned_emissions": {
"total_emissions": {
"co2_well_to_tank_tonnes": 0,
"co2_tank_to_wheel_tonnes": 0,
"co2_well_to_wheel_tonnes": 0
},
"legs": [
{
"emissions": [
{
"type": "CARBON_DIOXIDE",
"emission_mode": "ROAD",
"unit": "TONNES",
"tank_to_wheel": 0,
"well_to_tank": 0,
"total": 0
}
],
"transport_mode": "ROAD",
"start_location": {
"lat": 0,
"lng": 0
},
"end_location": {
"lat": 0,
"lng": 0
},
"type": "PRE_CARRIAGE",
"carriage_parameters": {
"bio_fuel_share": 0,
"carriage_mode_parameters": [
{
"mode": "ROAD",
"emission_class": "EuEuro6ac",
"empty_run_factor": 0,
"ferry_routing": "Normal",
"fuel_type": "diesel",
"load_factor": 0,
"lorry_class": "Class40",
"drive_class": "string",
"aircraft_type": "string",
"sea_ship_type": "string",
"inland_ship_type": "string"
}
]
},
"distance_km": 0,
"external_costs": {
"currency": "Euro",
"accident_costs": [
{
"transport_mode": "ROAD",
"accident_cost_value": 0
}
],
"noise_costs": [
{
"transport_mode": "ROAD",
"noise_costs_value": 0
}
],
"emission_costs": [
{
"name": "SULFUR_DIOXIDES",
"tank_to_wheel": 0,
"well_to_tank": 0,
"total": 0
}
],
"total_external_costs": 0
}
}
],
"cargo": {
"container_empty_weight": 0,
"tons_per_feu": 0,
"tons_per_teu": 0,
"unit": "string",
"volume_weight": "AVERAGE",
"weight": 0
},
"transport_activity_tonne_kms": 0,
"emissions_intensity_gram_per_tonne_kms": 0
},
"driven_distance": 253.4,
"driven_distance_source": "string",
"fuel_based_emissions": {
"accumulated_fuel_consumption_liters": 0,
"fuel_type": "string",
"co2_well_to_tank_tonnes": 0,
"co2_tank_to_wheel_tonnes": 0,
"co2_well_to_wheel_tonnes": 0,
"transport_activity_tonne_kms": 0,
"emissions_intensity_gram_per_tonne_kms": 0
},
"carbon_data_index": 0
}
],
"page_info": {
"cursor": "c2l4Zm9sZF9hcGlfZXhhbXBsZQ=="
}
} |
Use query parameters to narrow down the results
TBD