Domande frequenti sulla geocodifica

Queste domande frequenti riguardano l'API Geocoding. Consulta le domande frequenti su Google Maps Platform per domande comuni a tutta la piattaforma. Vedi anche Best practice per la geocodifica degli indirizzi.

Risoluzione dei problemi

Risoluzione dei problemi

Ricevo più query che restituiscono ZERO_RESULTS con il geocodificatore. Che cosa succede?

Nel geocodificatore, le query ambigue, incomplete e con formattazione errata, ad esempio indirizzi con errori ortografici o inesistenti, sono soggette a produrre ZERO_RESULTS. Se l'indirizzo non viene trovato, ZERO_RESULTS è preferibile a un risultato parziale (ad esempio, restituire solo il sobborgo anziché un indirizzo).

Se la tua applicazione gestisce l'input utente degli indirizzi, la funzionalità Place Autocomplete dell'API Places potrebbe produrre risultati di qualità migliore. La funzionalità Place Autocomplete consente agli utenti di selezionare da un insieme di risultati in base a ciò che hanno digitato, il che consente loro di scegliere tra risultati con nomi simili e di modificare la query se scrivono un indirizzo in modo errato.

Se hai un'applicazione che gestisce query ambigue o incomplete o query che potrebbero contenere errori, ti consigliamo di utilizzare la funzionalità Place Autocomplete nell'API Places anziché il geocodificatore normale disponibile nell'API Geocoding. Per maggiori dettagli, consulta le best practice per la geocodifica degli indirizzi e il blog post Geocodifica degli indirizzi nelle API di Google Maps.

Ho bisogno di risposte rapide e il geocoder è troppo lento per la mia applicazione. Cosa posso utilizzare per risposte più rapide?

Consigliamo alle applicazioni che rispondono all'input dell'utente e che quindi sono molto sensibili alla latenza di utilizzare la funzionalità Place Autocomplete dell'API Places (disponibile anche in JavaScript, Android o iOS) anziché il geocoding degli indirizzi. Place Autocomplete è ottimizzato per essere utilizzato in modo interattivo e quindi ha una latenza molto bassa.

La geocodifica degli indirizzi nell'API Geocoding è ottimizzata per l'utilizzo con indirizzi completi, non ambigui e ben formattati, come gli indirizzi di consegna inseriti nei moduli online, e pertanto ha una latenza superiore rispetto a Place Autocomplete. Il geocodificatore in avanti ha una copertura maggiore e una qualità dei risultati migliore, ma con una latenza leggermente superiore.

Come posso ridurre la latenza nell'API Directions (Legacy) e nell'API Distance Matrix (Legacy)?

Anziché indirizzi, utilizza gli ID luogo per specificare i punti di passaggio, l'origine e la destinazione. È consigliabile ottenere gli ID luogo dalla funzionalità di Place Autocomplete nell'API Places o dalla libreria Places nell'API Maps JavaScript. Consulta anche le informazioni sull'opzione placeIdOnly, che può essere utilizzata per ridurre il costo di Place Autocomplete.

Quando viene eseguita una query dell'API Directions (legacy) o dell'API Distance Matrix (legacy) con una stringa di indirizzo anziché un ID luogo o lat/lng, queste utilizzano lo stesso backend dell'API Geocoding per convertire l'indirizzo in un ID luogo prima di calcolare le indicazioni stradali. Place Autocomplete è più veloce del geocoding dell'indirizzo. Per le applicazioni che utilizzano l'API Directions (legacy) o l'API Distance Matrix (legacy) in situazioni molto sensibili alla latenza, ad esempio in risposta all'input dell'utente, ti consigliamo di utilizzare Place Autocomplete per ottenere gli ID luogo corrispondenti a questi indirizzi e di passare gli ID luogo all'API Directions (legacy) o all'API Distance Matrix (legacy). Questo approccio riduce significativamente la latenza. Consulta la nostra documentazione per un esempio di come utilizzare Place Autocomplete con le indicazioni stradali.

Come faccio a segnalare bug nel geocodificatore?

Se hai segnalazioni di bug o richieste di funzionalità per il servizio di geocoding diretto, comunicacelo utilizzando il nostro Issue Tracker pubblico.

Il geocoder non produce buoni risultati per il mio caso d'uso. Puoi chiedere aiuto?

Comunicacelo utilizzando il nostro Issue Tracker pubblico, condividendo alcune query specifiche, in modo che possiamo esaminare la situazione per verificare se ci sono bug o problemi sistemici che causano problemi con la qualità dei risultati o se possiamo apportare modifiche alla guida alle best practice per aiutare gli sviluppatori a ottenere risultati migliori.

Come faccio a ottenere i risultati migliori con il geocodificatore utilizzando il filtro dei componenti?

Nel geocodificatore, il filtro dei componenti applica solo le limitazioni postal_code e country. Gli esempi seguenti illustrano il modo migliore per utilizzare il filtro dei componenti, a seconda dei risultati che ti servono. Negli URL delle richieste di esempio, assicurati di sostituire `YOUR_API_KEY` con la tua chiave API effettiva.

  • Per limitare i codici postali a un paese specifico, assicurati di specificare la limitazione in base al paese utilizzando un codice paese ISO 3166-2. Ad esempio: components=country:CH|postal_code:8000 restituisce "8000 Zurigo, Svizzera". 
    https://maps.googleapis.com/maps/api/geocode/json?components=country:CH%7Cpostal_code:8000&key=YOUR_API_KEY
  • Per limitare le query a un paese specifico, assicurati di specificare la limitazione in base al paese utilizzando un codice paese ISO 3166-2. I nomi dei paesi e altre abbreviazioni potrebbero non produrre gli stessi risultati dei codici paese.

    Esempi:

    • Il geocoding per components=country:FRA|locality:gallus restituisce la località secondaria di Gallus a Francoforte sul Meno, in Germania. Questo perché il codice paese di tre lettere per la Francia (FRA) non è supportato, quindi sono consentiti risultati in qualsiasi paese e il risultato a Francoforte è più pertinente di qualsiasi risultato in Francia. 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY
  • L'API Geocoding non restituisce necessariamente più risultati per le query ambigue. A queste query risponde meglio il completamento automatico di Place.

    Esempi:

    • La geocodifica di components=country:US|locality:madrid restituisce "Madrid, NM 87010, USA", ma nessuna delle altre città degli Stati Uniti denominate "Madrid". 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY
    • Se utilizzi Place Autocomplete per input=madrid&components=country:us&types=(regions) e specifichi anche un'area visibile utilizzando location e radius per influenzare i risultati della località, viene generata una risposta con diverse città degli Stati Uniti denominate "Madrid". 
      https://maps.googleapis.com/maps/api/place/autocomplete/json?location=37.386052,-122.083851&radius=10000&input=madrid&components=country:us&types=(regions)&key=YOUR_API_KEY