The following endpoint allow to get emissions data for transports that finished tracking.
Make an authenticated GET request as shown in the example below:
https://api.test.transporeon.com/rtv/v1/emissions
The response contains a list of transports. For each transport, various emissions related fields are 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: TBDtotal_emissions: Accumulated emissions for all legs (is that right?)legs: Listing of single legs used for emissions calculationemissions: Details to the emissions for each legstart_location&end_location: Latitude and longitude of leg start- and endlocationdistance_km: The distance of the leg in kilometerscarriage_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: TBDemissions_intensity_gram_per_tonne_kms: TBD
driven_distance: Driven distance in kilometer?driven_distance_source: TBDfuel_based_emissions: Fuel consumption, type and other details.carbon_data_index: TBD
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=="
}
} |
More information on how Transporeon Visibility calulcates carbon emissions data can be found in the following help center article: https://intercom.help/sixfold/en/articles/5800433-carbon-visibility-methodology