Category Archives: PTV Developer

Generated clients

Posted on by

All PTV Developer APIs are specified as OpenAPI document. The big advantage of this specification is that you can generate client classes in various languages as described in this tutorial. Using client classes makes it easier and more convenient to integrate the API into an existing programming environment.

And it can get even easier! For Java, C# and TypeScript we provide already generated clients on GitHub ready to download. Of course, for other languages you can use the above tutorial to generate them yourself.

To keep yourself updated about upcoming releases and news you can use the subscribe function on the right hand side. If you got any question do not hesitate to get in contact.

Planning electric vehicles and other new features

Posted on by

New Feature:

 

Ever thought about how to plan electric vehicles? How to limit the distance a vehicle can drive through one day?

Use the new features published in Route Optimization API 1.9.0 resp. Sequence Optimization API 1.6.0.

With maximumDistance you can restrict the maximum allowed total driving distance for the route. You can adjust this for each vehicle separately as battery charging state may be different for each vehicle. 

Additionally there are even more features available:

  • routeStartInterval (available in Route Optimization / Sequence Optimization): 
    Defines an interval in which the vehicle has to start its route. Start and end of the interval may be the same, then the vehicle has to start its route at a concrete point in time.
    Can also be used to model the existence of ramps and therefore the restriction, that only a limited number of vehicle per time can be handled at a depot.
  • maximumNumberOfCustomerStops (available in Route Optimization): 
    Restricts the total number of customer stops, i.e. stops at customer locations, for the route of this vehicle.

See also the concept page vehicles and drivers for Route Optimization resp. Sequence Optimization, which describes the functionalities in terms of vehicles and drivers in general.

You can check the new features in the list below or use the API Changes webpage for more details.

To keep yourself updated about upcoming releases and news you can use the subscribe function on the right hand side.

If you got any question do not hesitate to get in contact.

Detailed Toll Update Italy

Posted on by

We activated the updated detailed toll layers for Italy, referenced to

PTV Europe / World City Map Premium 2022.2H,

PTV Europe / World City Map Premium 2023.1H/1aH,

PTV Europe / World City Map Premium 2023.2H
(from Release of the map)

on our Layer Delivery Server (LDS). Now, it is possible to download the detailed toll layers via Content Update Service (CUS).

Content:  New toll rates valid from 1st of January 2023.

 

Using detailed toll on PTV Developer, xServer internet and xServer from version 2.22:

The default toll calculation changed to useDetailedToll = true in the xserver.conf. That means that you get the detailed toll automatically, when requesting toll in the route calculation.

 

Information for xServer from version 2.18 to 2.21:

Step 1: Activate the detailed toll download via content update service in you xserver.conf.

core {
     contentupdates {
              content {
                  detailedToll {
                      enabled = true
                      providerNames = [ "here" ]
                      countries = [ ]
                  }
          }
      }
 }

Step 2: Enable the detailed toll calculation in the xserver.conf or in your request.

xroute {
     tollOptions {
     useDetailedToll = true
     }
 }

The detailed toll is released for PTV xServer from version 2.18.  

 

Please be aware that from version 2.22 the parameter useDetailedToll is activated automatically. If you like to use the basic toll you need to set it to false.

 

Release of Geocoding & Places API V 1.6.0 – Suggestions by Address

Posted on by

In the new version of the PTV Developer Geocoding & Places API V 1.6.0 you find a new Feature supporting the Locations by Address endpoint.

The new endpoint is named Suggestions by Address and enables you to get suggestions for the input fields of the Locations by Address search.

You have the possibility to  to get suggestions for e.g. the location field while the user is typing. The other fields (e.g country) will be taken into account to restrict the suggestion search.

Try out the code sample which gives you the possibility to see results out without any effort. 


Response:
{
  "suggestions": [
    {
      "caption": "Amsterdam (Noord-Holland)",
      "country": "Netherlands",
      "state": "Noord-Holland",
      "postalCode": "",
      "locality": "Amsterdam",
      "street": "",
      "houseNumber": ""
    },
    {
      "caption": "Amstelveen (Noord-Holland)",
      "country": "Netherlands",
      "state": "Noord-Holland",
      "postalCode": "",
      "locality": "Amstelveen",
      "street": "",
      "houseNumber": ""
    },
...

If you need more information about this new feature please have a look at the API documentation or at the concept wich describes the purpose of this feature in detail.

You can test PTV Developer for free by registering a MyPTV account and activating the product on the website.

To keep yourself updated about upcoming releases and news you can use the subscribe function on the right hand side.

If you got any question do not hesitate to get in contact.

Detailed Toll Update for France

Posted on by

We activated the updated detailed toll layers for France, referenced to

PTV Europe / World City Map Premium 2022.2H,

PTV Europe / World City Map Premium 2023.1H/1aH,

PTV Europe / World City Map Premium 2023.2H
(from Release of the map)

on our Layer Delivery Server (LDS). Now, it is possible to download the detailed toll layers via Content Update Service (CUS).

Content:  New toll rates valid from 1st of February 2023.

 

Using detailed toll on PTV Developer, xServer internet and xServer from version 2.22:

The default toll calculation changed to useDetailedToll = true in the xserver.conf. That means that you get the detailed toll automatically, when requesting toll in the route calculation.

 

Information for xServer from version 2.18 to 2.21:

Step 1: Activate the detailed toll download via content update service in you xserver.conf.

core {
     contentupdates {
              content {
                  detailedToll {
                      enabled = true
                      providerNames = [ "here" ]
                      countries = [ ]
                  }
          }
      }
 }

Step 2: Enable the detailed toll calculation in the xserver.conf or in your request.

xroute {
     tollOptions {
     useDetailedToll = true
     }
 }

The detailed toll is released for PTV xServer from version 2.18.  

 

Please be aware that from version 2.22 the parameter useDetailedToll is activated automatically. If you like to use the basic toll you need to set it to false.

Matrix Routing API : higher rate limits for simple matrix calculation

Posted on by

Rate limits are the number of requests per given time period a single API key can make. If those limits are exceeded, the error code ‘GENERAL_RATE_LIMIT_EXCEEDED’ is returned and further requests will temporarily be rejected.

The matrix routing calculation is a complex process whose performance varies depending on multiple factors such as the number of input origins and destinations, their geographical distribution, or the information to be retrieved (e.g. toll cost per relation).

However, for use-cases where it is sufficient to compute small to medium-sized matrices returning distances and/or travel times, the synchronous calculateMatrix method of the PTV Developer Matrix Routing API performs very well. Since this method is currently limited to 250,000 matrix relations per request and does not support toll price calculation, its rates limits have been extended to 500 requests per minute and per API key (instead of 20), from now on. This allows you to increase the frequency of simple matrix calculations.

Please note that the request limits, the transaction calculation, as well as the rate limits for the asynchronous startMatrixCalculation method remain unchanged.     

To keep yourself updated about upcoming releases and news you can use the subscribe function on the right hand side. If you got any question do not hesitate to get in contact.