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:

1. Inviare un lavoro
   Utilizzare uno dei seguenti endpoint:
   • /locations/by-addresses
   • /locations/by-texts
   • /locations/by-positions
     → La risposta include un jobId
2. Controllare lo stato del lavoro
   Utilizzare GET /locations/by-*/status/{jobId}
   Effettuare polling finché lo stato non è SUCCEEDED o FAILED
3. Recuperare i risultati
   Utilizzare GET /locations/by-*/{jobId}
4. (Opzionale) Eliminare il lavoro
   Utilizzare DELETE /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)

FAQ – Limiti di velocità API

• ...