Freight v3-preview1

• Climatiq has released a new version of the intermodal freight endpoint. This is the changelog & upgrade guide for that version. See our API versioning guide for how API versioning works at Climatiq.
• We're launching a new breaking version of our freight endpoint to comply with the latest version of the GLEC Framework (GLEC v3.1).
• We will not backport the new GLEC v3.1 emissions factors to the freight v2 endpoint, to allow you to be in charge of when to adopt the new methdology.
• Freight v2 does not have a deprecation date until Freight v3 is released. After the release of Freight v3, Freight v2 will continue to run for at least one year. We encourage users to consider migrating onto the freight v3 preview versions, as we do not expect any large breaking changes between the preview and the final versions.
• The changes needed in client applications to migrate from freight v2 are minimal.

Notable changes

Notable changes in freight-v3-preview1 are:

• Methodology updated as specified in GLEC v3.1. This will influence the results of your calculations in accordance with the latest data on freight emissions.
• A new algorithm for rail routing has been enabled providing broader and more accurate coverage.

API Changes (Request)

The requests you send to the API should still look very familiar. If you're using the default parameters for everything, your requests should continue working as-is. You can find the API documentation for freight v3-preview1 here.

Road Details in China

GLEC 3.1 added specific road emission factors for China. To select China-specific emission factors, you can provide a china object inside of the road_details section of leg_details to incorporate them. Have a look at the API reference documentation to learn about the possible parameter combinations.

If you are using road freight in China you should consider the new options available, otherwise your estimates will be made using our default vehicle details in China.

Renaming of fuel sources for trucks with HPDI engines

The fuel sources

• fuel_source_bio_lng_or_diesel
• fuel_source_cng_or_diesel
• fuel_source_lng_or_diesel

have been renamed to the more accurate forms

• fuel_source_bio_lng_and_diesel
• fuel_source_cng_and_diesel
• fuel_source_lng_and_diesel

Methodological changes

Internally, there are also some methodological changes that you might see reflected in your estimate values, but not in the API request/response.

• All the emission factors used have been updated to the newest value provided by the GLEC organization.
• All non-container sea freight, when refrigerated, now receives a 15% distance adjustment factor (DAF).
• All refrigerated rail freight now receives a unified 12% uplift. Previously, container rail freight had a 93% uplift.

New rail routing algorithm

We have added a new rail routing mechanism, which improves route finding, extends our coverage outside of Europe, and no longer falls back to using great circle distance (GCD) where no routes exist.