Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The following endpoint allow to get emissions data for transports that finished tracking.

Details 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

How to

Make an authenticated GET request as shown in the example below:

...

  • emissions_calculated_at: Timestamp of carbon emissions calculation.

  • calculation_errors: Details on the error in case the system wasn’t able to calculate the emissions

  • planned_emissions: TBD

    • total_emissions: Accumulated emissions for all legs (is that right?)

    • legs: Listing of single legs used for emissions calculation

      • emissions: Details to the emissions for each leg

      • start_location& end_location: Latitude and longitude of leg start- and endlocation

      • distance_km: The distance of the leg in kilometers

      • carriage_parameters: Details on the carriage, such as bio_fuel_shareand carriage_mode_parameters

      • external_costs: Details on the accident_, external_ and emissions_costas well as the total_external_costs in the specified currency

    • cargo: Details on the transported cargo, such as weight and volume.

    • transport_activity_tonne_kms: TBD

    • emissions_intensity_gram_per_tonne_kms: TBD

  • driven_distance: Driven distance in kilometer?

  • driven_distance_source: TBD

  • fuel_based_emissions: Fuel consumption, type and other details.

  • carbon_data_index: TBD

Example:

Code Block
languagejson
{
  "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=="
  }
}

...