We would like to inform all users of PTV xServer 2 who configure toll calculation in their routing or distance matrix requests about an upcoming change.
The experimental parameter ‘useDetailedToll’ will be removed from the xRoute and xDima API as well as from the xServer configuration file with the first release of 2027.
Background
PTV xServer 2 supports two data formats for toll calculation:
- Basic toll (legacy format): Provides a basic toll summary covering total costs per route. This format is no longer under active development and will not receive further improvements.
- Detailed toll (new format): Provides the full toll API, including granular toll sections, toll systems, and toll events along the route. In addition, it supports the consideration of CO₂ emission classes as well as electronic toll subscriptions. This format is the basis for all future toll development, and there is no advantage to using the basic toll format instead.
The ‘useDetailedToll‘ parameter was introduced as an experimental option to support the transition from basic to detailed toll, intentionally marked as experimental for this purpose. Now that the transition is complete, the parameter has served its purpose. Despite experimental parameters should not be used in productive environments, we are giving advance notice of its removal because we are aware that some customers have actively used it.
What do you have to do now
Check whether you are currently setting ‘useDetailedToll‘ in your xRoute or xDima requests. If you are, simply remove the parameter. As detailed toll has been the default since version 2.22, this change will have no effect on the toll results for the vast majority of integrations.
If you are unsure how to work with detailed toll or want to take advantage of its additional capabilities, please refer to the technical concept for Toll in our documentation.
The parameter will be removed with the first PTV xServer 2 release of 2027. We strongly recommend reviewing your requests and configuration before that date to avoid any disruption.
If you have any questions or need further assistance, do not hesitate to contact our support team.