Domande frequenti sulla geocodifica

Questa domanda frequente riguarda domande specifiche relative all'API Geocoding. Consulta le Domande frequenti su Google Maps Platform per domande comuni a tutte le piattaforme di Google Maps. Vedi anche Best practice per la geocodifica di indirizzi.

Risoluzione dei problemi

Risoluzione dei problemi

Ho ricevuto 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 che contengono errori ortografici o inesistenti, tendono a produrre ZERO_RESULTS. Se non viene trovato l'indirizzo, ZERO_RESULTS è preferibile a un risultato parziale (ad esempio, restituisce solo il sobborgo al posto di un indirizzo).

Se la tua applicazione riguarda l'inserimento di indirizzi da parte dell'utente, la funzionalità Place Autocomplete nell'API Places può produrre risultati di qualità migliore. La funzionalità di completamento automatico del luogo consente agli utenti di scegliere tra un insieme di risultati in base a ciò che hanno digitato. In questo modo, gli utenti possono scegliere tra risultati con nomi simili e modificare la loro query in caso di errore di ortografia di un indirizzo.

Se hai un'applicazione che gestisce query ambigue o incomplete o che potrebbero contenere errori, ti consigliamo di utilizzare la funzionalità Place Autocomplete nell'API Places invece di utilizzare il geocodificatore in avanti disponibile nell'API Geocoding. Per ulteriori dettagli, consulta Best practice per la geocodifica di indirizzi e Geocoding degli indirizzi nel post del blog delle API di Google Maps.

Ho bisogno di risposte rapide e il geocodificatore è troppo lento per la mia applicazione. Che cosa posso utilizzare per ottenere risposte più rapide?

Consigliamo alle applicazioni che rispondono all'input dell'utente e, pertanto, che sono altamente sensibili alla latenza, di utilizzare la funzionalità Completamenti automatico posizione nell'API Places (disponibile anche in JavaScript, Android o iOS) anziché risolvere il problema della geocodifica. Il completamento automatico dei luoghi è ottimizzato per essere utilizzato in modo interattivo, pertanto ha una latenza molto bassa.

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

Come faccio a ridurre la latenza nell'API Directions e nell'API DIST Matrix?

Al posto degli indirizzi, utilizza gli ID luogo per specificare tappe, origine e destinazione. Gli ID luogo sono ottenuti al meglio dalla funzionalità Place Autocomplete nell'API Places o dalla raccolta Places nell'API Maps JavaScript. Guarda anche le informazioni sull'opzione placeIdOnly, che possono essere utilizzate per ridurre i costi di Completamento automatico di un luogo.

Quando viene eseguita una query sull'API Directions o sull'API ance Matrix con una stringa di indirizzo anziché con un ID posizione o un latlng, utilizza lo stesso backend dell'API Geocoding per convertire tale indirizzo in un ID luogo prima di calcolare le indicazioni stradali. Il completamento automatico dei luoghi è più veloce della geocodifica dell'indirizzo. Per le applicazioni che utilizzano l'API Directions o l'API DISTANCE Matrix in situazioni sensibili alla latenza, come la risposta all'input utente, consigliamo di utilizzare il completamento automatico del luogo per ottenere gli ID luogo corrispondenti a tali indirizzi e trasmetterli all'API Directions o all'API Direction Matrix. Questo approccio riduce in modo significativo la latenza. Consulta la nostra documentazione per un esempio di come utilizzare la funzionalità di completamento automatico dei luoghi con le indicazioni stradali.

Come faccio a segnalare bug nel geocodificatore?

Se avete segnalazioni di bug o richieste di funzionalità per il servizio di geocodificatore in avanti, contattateci usando il nostro strumento per il monitoraggio dei problemi pubblico.

Il geocodificatore non produce buoni risultati per il mio caso d'uso. Che tipo di assistenza è disponibile?

Fateci sapere tramite il nostro strumento di monitoraggio dei problemi pubblico, condividendo alcune query specifiche, in modo che possiamo esaminare se ci sono bug o problemi di sistema che causano problemi di qualità dei risultati oppure 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 restrizioni postal_code e country. I seguenti esempi illustrano come utilizzare al meglio il filtro dei componenti, a seconda dei risultati necessari. Negli URL di richiesta 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 restrizione del paese utilizzando un codice paese ISO 3166-2. Ad esempio: components=country:CH|postal_code:8000 restituisce "8000 Zürich, 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 restrizione del paese utilizzando un codice paese ISO 3166-2. Non è garantito che i nomi dei paesi e altre abbreviazioni producano gli stessi risultati dei codici paese.

    Esempi:

    • La geocodifica 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 della Francia (FRA) non è supportato, pertanto i risultati in qualsiasi paese sono consentiti e il risultato a Francoforte è più adatto di qualsiasi altra 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. Per queste query è meglio rispondere con il completamento automatico del luogo.

    Esempi:

    • La geocodifica per components=country:US|locality:madrid restituisce "Madrid, NM 87010, USA", ma nessuna delle altre città degli Stati Uniti denominata "Madrid". 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY
    • L'utilizzo di Place Autocomplete per input=madrid&components=country:us&types=(regions) e la specifica di un'area visibile con location e radius per bias i risultati relativi alla posizione genera una risposta con diverse città negli Stati Uniti denominata "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