Question

How can I geocode large amounts of address or position data using the PTV Developer Geocoding & Places API?

Answer

PTV offers bulk geocoding through asynchronous batch jobs in the Geocoding & Places API. You can submit up to 1,000 entries (addresses, free-text, or coordinates) per job and retrieve the results after processing.

Basic Workflow:

1. Submit a job
   Use one of the following endpoints:
   • /locations/by-addresses
   • /locations/by-texts
   • /locations/by-positions
     → Response includes a jobId
2. Check job status
   Use GET /locations/by-*/status/{jobId}
   Poll until status is SUCCEEDED or FAILED
3. Retrieve the results
   Use GET /locations/by-*/{jobId}
4. (Optional) Delete the job
   Use DELETE /locations/by-*/{jobId}
   Jobs are kept for 24 hours if not deleted manually.

Additions hints

Recommended batch size: Up to 1,000 entries per job

Rate limits:

• Up to 100 create/result calls per minute
• Up to 25,000 status calls per minute

API key required in headers: apiKey: YOUR_API_KEY

Use the PTV Developer Portal for testing

📦 Official SDKs available in Java, .NET, and TypeScript

📂 Jobs expire automatically after 24 hours

Related articles

Geocoding & Places API – Batch Processing Documentation

PTV Blog – Introducing Bulk Geocoding

PTV SDKs for Batch Geocoding (GitHub)

FAQ – API Rate Limits

• ...