Domanda
Come posso geocodificare grandi quantità di dati di indirizzi o posizioni utilizzando la Geocoding & Places API di PTV Developer?
Risposta
PTV offre la geocodifica in blocco tramite lavori batch asincroni nella Geocoding & Places API. È possibile inviare fino a 1.000 voci (indirizzi, testo libero o coordinate) per lavoro e recuperare i risultati dopo l'elaborazione.
Flusso di lavoro di base:
-
Inviare un lavoro
Utilizzare uno dei seguenti endpoint:/locations/by-addresses/locations/by-texts-
/locations/by-positions
→ La risposta include unjobId
-
Controllare lo stato del lavoro
UtilizzareGET /locations/by-*/status/{jobId}
Effettuare polling finché lo stato non èSUCCEEDEDoFAILED -
Recuperare i risultati
UtilizzareGET /locations/by-*/{jobId} -
(Opzionale) Eliminare il lavoro
UtilizzareDELETE /locations/by-*/{jobId}
I lavori vengono conservati per 24 ore se non eliminati manualmente.
Suggerimenti aggiuntivi
Dimensione batch consigliata: Fino a 1.000 voci per lavoro
Limiti di velocità:
- Fino a 100 chiamate create/result al minuto
- Fino a 25.000 chiamate di stato al minuto
Chiave API richiesta negli header: apiKey: YOUR_API_KEY
Utilizza il PTV Developer Portal per i test
📦 SDK ufficiali disponibili in Java, .NET e TypeScript
📂 I lavori scadono automaticamente dopo 24 ore
Articoli correlati
Geocoding & Places API – Documentazione sul processamento batch
Blog PTV – Introduzione alla geocodifica in blocco
SDK PTV per la geocodifica in blocco (GitHub)
- ...