Vraag

Hoe kan ik grote hoeveelheden adres- of positiedata geocoderen met behulp van de PTV Developer Geocoding & Places API?

Antwoord

PTV biedt bulk geocoding aan via asynchrone batchtaken in de Geocoding & Places API. U kunt tot 1.000 invoeritems (adressen, vrije tekst of coördinaten) per taak indienen en de resultaten na verwerking ophalen.

Basisworkflow:

1. Dien een taak in
   Gebruik een van de volgende endpoints:
   • /locations/by-addresses
   • /locations/by-texts
   • /locations/by-positions
     → Response bevat een jobId
2. Controleer de taakstatus
   Gebruik GET /locations/by-*/status/{jobId}
   Poll totdat de status SUCCEEDED of FAILED is
3. Haal de resultaten op
   Gebruik GET /locations/by-*/{jobId}
4. (Optioneel) Verwijder de taak
   Gebruik DELETE /locations/by-*/{jobId}
   Taken worden 24 uur bewaard als ze niet handmatig worden verwijderd.

Aanvullende tips

Aanbevolen batchgrootte: Tot 1.000 items per taak

Snelheidslimieten:

• Tot 100 create/result-aanroepen per minuut
• Tot 25.000 statusaanroepen per minuut

API-sleutel vereist in headers: apiKey: YOUR_API_KEY

Gebruik de PTV Developer Portal voor testen

📦 Officiële SDK's beschikbaar in Java, .NET en TypeScript

📂 Taken verlopen automatisch na 24 uur

Gerelateerde artikelen

Geocoding & Places API – Batchverwerking Documentatie

PTV Blog – Introductie van Bulk Geocoding

PTV SDK's voor Batch Geocoding (GitHub)

FAQ – API Snelheidslimieten

• ...