Question

Comment puis-je géocoder de grandes quantités de données d’adresses ou de positions en utilisant l’API Geocoding & Places de PTV Developer ?

Réponse

PTV propose le géocodage en masse via des tâches batch asynchrones dans l’API Geocoding & Places. Vous pouvez soumettre jusqu’à 1 000 entrées (adresses, texte libre ou coordonnées) par tâche et récupérer les résultats après traitement.

Flux de travail de base :

1. Soumettre une tâche
   Utilisez l’un des points de terminaison suivants :
   • /locations/by-addresses
   • /locations/by-texts
   • /locations/by-positions
     → La réponse inclut un jobId
2. Vérifier le statut de la tâche
   Utilisez GET /locations/by-*/status/{jobId}
   Interrogez jusqu’à ce que le statut soit SUCCEEDED ou FAILED
3. Récupérer les résultats
   Utilisez GET /locations/by-*/{jobId}
4. (Optionnel) Supprimer la tâche
   Utilisez DELETE /locations/by-*/{jobId}
   Les tâches sont conservées pendant 24 heures si elles ne sont pas supprimées manuellement.

Conseils supplémentaires

Taille de lot recommandée : Jusqu’à 1 000 entrées par tâche

Limites de débit :

• Jusqu’à 100 appels de création/résultat par minute
• Jusqu’à 25 000 appels de statut par minute

Clé API requise dans les en-têtes : apiKey: VOTRE_CLE_API

Utilisez le Portail PTV Developer pour les tests

📦 SDK officiels disponibles en Java, .NET et TypeScript

📂 Les tâches expirent automatiquement après 24 heures

Articles liés

Documentation Geocoding & Places API – Traitement par lots

Blog PTV – Présentation du géocodage en masse

SDK PTV pour le géocodage par lots (GitHub)

FAQ – Limites de débit de l’API

• ...