FAQ
Account
How can I start using the PTV Developer APIs?
You need to sign up for a PTV account and then activate your free subscription of PTV Developer. If you already have a PTV account, you can directly activate your free product. No payment details are needed to activate your free product.
Can I activate more than one free subscription?
No. Every account can only activate one free subscription of PTV Developer but multiple paid subscriptions.
Where can I update my personal data?
You can use the avatar menu on the top right corner to reach the Manage Profile section and update your personal information.
Where can I delete my account?
In the Manage Profile section you have the possibility to delete your account. Please note that you can only delete your account if no subscription is active.
Developer Support
How can I generate API keys to start developing?
Within your product instance you can create, rename and delete API keys in the API Keys App.
How many API keys can I create using a free subscription?
For the free subscription one API key is included. If you need more API keys, please contact us and we will find a solution that fits best to your needs.
How do I use the API keys?
The API keys are needed to authenticate against PTV Developer APIs. Check the Quick Start of the API documentations for more details on the authentication options.
How can I run performance tests on PTV Developer APIs?
If you want to run performance or load tests, please contact us and we will find a solution that fits best to your needs.
How can I generate client classes for PTV Developer APIs?
Learn how to generate clients for PTV Developer APIs in this tutorial.
How can I avoid 404 (Not Found) error codes even though my url seems to be ok?
If the endpoint requires a parameter in the path and this parameter is missing you will get a http response code 404 (Not Found) even if the rest of the url is correct. You have to add the required parameter to the url in order to get a successful response or an error message with more details if something else is wrong with the parameter.
Licensing & Terms
Can I use a free subscription for productive/commercial use of my application?
The free subscription is only for testing and integration purposes. If you want to roll out your application for commercial use, you need to contact us and we will find a solution that fits best to your needs.
What are the terms of use?
You can find the terms of use for different regions by using the according link below.

EU - English
EU - German
US - English
Limits
What are the limits for the free subscription?
The free subscription is only for testing and integration purposes and has some limits compared to a paid subscription. In general, 100,000 transactions per month and one API key are included to test all offered services. Some services have additional limits as described in the table below.
APIMethodLimit
Geocoding & Places API-No additional limit
Raster Maps API-No additional limit
Vector Maps API-No additional limit
Map Matching API-No additional limit
Routing API-No additional limit
Matrix Routing APIcalculateMatrix
startMatrixCalculation
250 matrix relations per request / 25 requests per day
250 matrix relations per request / 25 requests per day
EWS Road Distance APIgetRelation100 requests per month
Route Optimization APIcreatePlan
startOptimization
25 transports per request
50 requests per day
Sequence Optimization APIstartAndCreateOptimizedRoute25 transports per request / 50 requests per day
Loading Space Optimization APIpackBins
startBinPacking
20 requests per day
10 bins and 100 items per request / 20 requests per day
Data API-No additional limit
How are transactions calculated?
To measure the transactions 1k packages are used as measurement unit. Your usage of all offered services is simply added up.
APIMethod1k transactions correspond to...
Geocoding & Places APIsearchLocationsByText
searchLocationsByAddress
searchLocationsByPosition
searchPlacesByPosition
1,000 texts
1,000 addresses
1,000 positions
1,000 positions
Raster Maps APIgetImageTile
getDataTile
getSatelliteTile
15,000 image tiles
15,000 data tiles
5,000 satellite tiles
Vector Maps APIgetVectorTile15,000 vector tiles
Map Matching APImatchPosition
createMatchedTrack
5,000 positions
5,0000 positions
Routing APIcalculateRoute
calculateRoutePost
getRouteByRouteId
calculateReachableAreas
startAndCreateReachableAreas
startAndCreateReachableLocations
1,000 routes
1,000 routes
1,000 routes
500 reachable areas
500 reachable areas
500 reachable locations
Matrix Routing APIcalculateMatrix
startMatrixCalculation
1,000 matrix relations
1,000 matrix relations
EWS Road Distance APIgetRelation1,000 relations
Route Optimization APIstartOptimization16 requests with less than 50 transports
8 requests with less than 100 transports
4 requests with less than 200 transports
2 requests with less than 400 transports
1 request with 400 transports or more
Sequence Optimization APIstartAndCreateOptimizedRoute64 requests with less than 25 transports
32 requests with less than 50 transports
16 requests with less than 100 transports
8 requests with less than 200 transports
4 request with 500 transports or more
Loading Space Optimization APIpackBins
startBinPacking
1,000 bins
1,000 bins
Data API-No transactions calculated


Please note that the error code 'GENERAL_QUOTA_EXCEEDED' is returned, if the transaction limit of your subscription is exceeded. If you need more transactions, please contact us and we will find a solution that fits best to your needs.
What are request limits?
Request limits define a maximum amount of objects in a single call of the services (e.g. number of waypoints per routing request). If the limits are reached it is recommended to split up the amount of objects into multiple requests. Note that for some APIs there are no request limits because the endpoints handle only single objects (e.g. map tiles, addresses or coordinates).

Find the request limits per service in the table below.
APIMethodRequest limit
Geocoding & Places API-No request limit
Raster Maps API-No request limit
Vector Maps API-No request limit
Map Matching APIcreateMatchedTrack16,200 positions per request
Routing APIcalculateRoute
calculateRoutePost
25 waypoints per request
25 waypoints per request
Matrix Routing APIcalculateMatrix
startMatrixCalculation
250,000 matrix relations per request
4,000,000 matrix relations per request
EWS Road Distance API-No request limit
Route Optimization APIcreatePlan3,000 transports per request
Sequence Optimization APIstartAndCreateOptimizedRoute500 transports per request
Loading Space Optimization APIpackBins
startBinPacking
2 bins and 100 items per request
100 bins and 10,000 items per request
Data API-No request limit


Please note that depending on your current subscription lower limits may apply.
What are rate limits?
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.

Find the rate limits per service in the table below.
APIMethodRate limit
Geocoding & Places APIAll methods600 requests per minute
Raster Maps APIgetSatelliteTile
All other methods
2,500 requests per minute
10,000 requests per minute
Vector Maps APIAll methods10,000 requests per minute
Map Matching APIAll methods300 requests per minute
Routing APIAll methods300 requests per minute
Matrix Routing APIcalculateMatrix
startMatrixCalculation
getStatus
All other methods
20 requests per minute
50 requests per minute
3,000 requests per minute
100 requests per minute
EWS Road Distance APIAll methods600 requests per minute
Route Optimization APIstartOptimization
getOperationStatus
All other methods
50 requests per minute
3,000 requests per minute
100 requests per minute
Sequence Optimization APIstartAndCreateOptimizedRoute
getOptimizedRoute
All other methods
50 requests per minute
3,000 requests per minute
100 requests per minute
Loading Space Optimization APIpackBins
startBinPacking
getStatus
All methods
20 requests per minute
50 requests per minute
3,000 requests per minute
100 requests per minute
Data APIAll methods300 requests per minute