PTV xServer internet technical information – Reported issues for PTV Europe City Map [TomTom] with API Version 1

On September 1st 2021 we did the update on the PTV Europe City Map [TomTom] with API Version 1. After the switch to production some customers had problems.

Here are the issues reported and the corresponding solution:

  • There was a report that a customer could no longer connect to the service. After an analysis we found out that he used the IP address instead of URL.
    Please have in mind that we don´t guarantee the stability of our IP addresses, so please only use the URLs to address our service.

  • There was an issue with an error of dataCompatibilityVersion does not match.
    After the analysis of the issue we found out that the error message was misleading. Instead of data compatibility it is a profile schema validation error.

    In our documentation we note that the schema validation for the profile snippet should only be used for development or debugging issues, because of the performance. It is not meant for productive usage, nevertheless it should work like intended.

    Do not use http://localhost:500×0 as schema url since this internal url might or will not work. We documented in our manual that we support the following notation for the schema location:

    <Profile xmlns:xsi= xsi:noNamespaceSchemaLocation=


      <Common language="de" coordinateFormat="PTV_GEODECIMAL" majorVersion="1" minorVersion="0"/>


    What also works is the notation like specified in our RawRequestRunner samples:

    <Profile xmlns:xsi='' xsi:noNamespaceSchemaLocation=\http:///xroute/schema/XRouteProfile.xsd\>   

    We see that is a minor change if you used that differently before. Nevertheless, this is the documented and supported way and should be used accordingly.


We kindly ask you to please always test your application on the provided test system and report any problem immediately.

By Isabel Honikel

Senior Technical Product Manager