Domande frequenti sulla geocodifica

Queste domande frequenti riguardano questioni specifiche dell'API Geocoding. Consulta le domande frequenti su Google Maps Platform per le domande comuni a tutti i servizi di Google Maps Platform. Consulta anche Best practice per il geocodificazione degli indirizzi.

Risoluzione dei problemi

Risoluzione dei problemi

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

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

Se la tua applicazione gestisce gli indirizzi inseriti dagli utenti, la funzionalità Completamento automatico dei luoghi nell'API Places potrebbe produrre risultati di qualità migliore. La funzionalità di completamento automatico dei luoghi consente agli utenti di selezionare un insieme di risultati in base a ciò che hanno digitato, in modo da scegliere tra risultati con nomi simili e modificare la query se hanno scritto male un indirizzo.

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 diretto disponibile nell'API Geocoding. Per maggiori dettagli, consulta Best practice per il geocodificazione degli indirizzi e il post del blog sull'API Google Maps Geocoding.

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

Consigliamo alle applicazioni che rispondono all'input dell'utente e sono quindi molto sensibili alla latenza di utilizzare la funzionalità Place Autocomplete nell'API Places (disponibile anche in JavaScript, Android o iOS) anziché il geocodificazione degli indirizzi. Il completamento automatico dei luoghi è ottimizzato per essere utilizzato in modo interattivo e, di conseguenza, 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 ha quindi una latenza più elevata 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 dell'API Directions e dell'API Distance Matrix?

Anziché gli indirizzi, utilizza gli ID luogo per specificare i waypoint, l'origine e la destinazione. Gli ID luogo sono più facilmente ottenibili dalla funzionalità Place Autocomplete dell'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 sull'API Directions o sull'API Distance Matrix con una stringa di indirizzo anziché con un ID luogo o latlng, queste utilizzano lo stesso backend dell'API Geocoding per convertire l'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 molto sensibili alla latenza, come la risposta all'input dell'utente, ti consigliamo di utilizzare il completamento automatico dei luoghi per ottenere gli ID luogo corrispondenti a questi indirizzi e di passarli all'API Directions o all'API Distance Matrix. Questo approccio riduce notevolmente 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 i bug nel geocodificatore?

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

Il geocodificatore non produce buoni risultati per il mio caso d'uso. Quali aiuti sono disponibili?

Comunicacelo utilizzando il nostro tracker dei problemi, condividendo alcune query specifiche, in modo da poter esaminare se sono presenti 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. I seguenti esempi illustrano come utilizzare al meglio il filtro dei componenti, a seconda dei risultati che ti servono. 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 limitazione del 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 del paese utilizzando un codice paese ISO 3166-2. I nomi dei paesi e altre abbreviazioni non garantiscono gli stessi risultati dei codici paese.

    Esempi:

    • La geocodifica di components=country:FRA|locality:gallus restituisce la località di Gallus a Francoforte sul Meno, in Germania. Questo accade perché il codice paese di 3 lettere per la Francia (FRA) non è supportato, pertanto sono consentiti risultati per qualsiasi paese e il risultato di Francoforte è una corrispondenza migliore rispetto a qualsiasi altro 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 query ambigue. Per queste query è meglio utilizzare il completamento automatico dei luoghi.

    Esempi:

    • La geocodifica di components=country:US|locality:madrid restituisce "Madrid, NM 87010, USA", ma nessuna delle altre città degli Stati Uniti con il nome "Madrid". 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY
    • Se utilizzi la funzionalità di completamento automatico dei luoghi per input=madrid&components=country:us&types=(regions) e specifichi anche un'area visibile utilizzando location e radius per influenzare i risultati relativi alla posizione, viene generata una risposta con diverse città negli 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