Versions Compared

Key

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

...

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

https://api.test.transporeon.com/rtv/v1/transports/emissions

The response contains a list of transports, sorted by the transport’s tracking start time (newest - oldest).

...

https://api.transporeon.com/rtv/v1/emissionstranports/{identifier_type}/{identifier_value}/emissions

Response payload example

The response payload (here collapsed) is the same as above, but as it’s single transport’s emissions, it’s a single object without any pagination:

...

  • emissions_first_calculated_at& emissions_latest_calculated_at: First and latest time when the emissions were calculated.

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

  • planned_emissions: Details on the default emissions calculated based on the transport plan.

    • total_emissions: Accumulated emissions for all legs

    • legs: Listing of single legs used for emissions calculation.

      • emissions: Details to the emissions for each leg

      • transport_mode: Mode of the transport. Possible values: ROAD, RAIL, AIR, SEA, INLANDWATERWAYS, LOGISTICSITE

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

      • distance_km: The distance of the leg in kilometers

      • type: Type of carriage for multimodal transports, possible values: PRE_CARRIAGE, MAINHAUL, POST_CARRIAGE

      • 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: Quantifies 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: Amount of emissions produced for transporting one tonne of goods over one kilometer (g/tonne-km)

  • driven_distance: Driven distance in kilometers.

  • driven_distance_source: Source of the driven distance data. Possible values (in order of priority):

    • ODOMETER_KM: Difference of vehicle odometer values transmitted from the telematics provider between start and end of the transport. Note that only a minority of providers have this data available.

    • TOTAL_DISTANCE_METERS

    , ODOMETER_KM
    • : Based on spherical distance between consecutive vehicle GPS points.

  • fuel_based_emissions: Fuel consumption, type and other details.

  • carbon_data_index: Composite 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.

  • visibility_stakeholders: Companies involved in the transport.

  • start_time: Initial planned start time of the transport.