PTV Group - Logistics Forum

Here's an update on the latest developments in PTV Developer... you can also find that info in each API's change list:



Api VarVersion Type Date Description

Data API 1.16.3 IMPROVEMENT 29.04.2025 Weight, height and width limits in the map data are always overwritten and not only if they are ...

By the way:

{
"traceId": "...",
"errorId": "...",
"description": "Insufficient access rights.",
"errorCode": "GENERAL_FORBIDDEN",
"details": {
"message": "You do not have permission to access this app."
}
}
Just learned that depending on your underlying plan you might not even be able to ...

Hi there,

every now and then we get requests like this one:
I've been told to implement a sequencing usecase - so just one vehicle and multiple stops. In 2023 I looked into the PTV Sequence Optimization API and PTV Route Optimization API within PTV Developer. Does it make sense to use these APIs ...

in xCluster 2 the grouping is enforced via the com.ptvgroup.xserver.xcluster.PlanningLocation.groupId

Unique identifier of a group of locations this location belongs to. Locations that are in the same group will be assigned to the same cluster.

Please be aware of this constraint

Question: what is the meaning of this error code?

{
"faultInfo":{"$type":"ProcessingFault"},
"message":"Encountered invalid request: SameClusterConstraint: This constraint requires at least two locations."
}
xCluster-groupFailed.png
Reason: This error occurs, if you perform a pregrouping and ...

Hi there,

one of my partners is used to maxTransportPeriod on a xTour1.TransportAB. He optimizes the transport of persons in a medical context and these clients should not exceed an individual timeframe on the vehicle.

Afaik there's no dedicated successor in the Optiflow API (not yet?) and the ...

If you face this error message it is caused because your underlying ApiKey / Plan does not cover the provisioning of input plans in an Optiflow call.
Please get back to us so we can check the licensing

{
"traceId": "...,
"description": "A product-specific restriction is exceeded.",
"errorCode ...

In Route Optimization Optiflow 1.13.0 we invented a new parameter: vehicle.preferences.routeDurationBalancing :
Feature: Added a preference for balanced routes on the vehicle configuration. Higher values indicate a stronger preference for route durations close to the the average route duration.
As ...

Hi there,

one of our users just mentioned this effect I wasn't aware of. Could DEV please comment on this? Is this a bug?

The user works with xRoute2 and calculates toll. In the response he deals with the com.ptvgroup.xserver.xroute.TollSummary which is documented to return an array called costs ...

Hello Claus,

you are right: the Sequence Optimization API does not cover 100% of the underlying xTour2 options when it comes to breaks of a Driver :
operating Intervals : supported, but limited to a single interval
breakIntervals : not supported
configurableWorkingHours : supported partially (e ...