Domande frequenti sulla geocodifica

Queste domande frequenti riguardano domande specifiche dell'API Geocoding. Consulta le Domande frequenti su Google Maps Platform per domande comuni a tutti i prodotti Google Maps Platform. Consulta anche le best practice per la geocodifica degli indirizzi.

Risolvere i problemi

Risolvere i problemi

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

Nel geocodificatore, le query ambigue, incomplete e con formato errato, ad esempio indirizzi errati o inesistenti, tendono a produrre ZERO_RESULTS. Se non è possibile trovare l'indirizzo, ZERO_RESULTS è da preferirsi a un risultato parziale (ad esempio restituisce solo il sobborgo anziché un indirizzo).

Se la tua applicazione si occupa dell'input dell'utente di indirizzi, la funzionalità Place Autocomplete nell'API Places potrebbe produrre risultati di qualità migliore. Place Autocomplete consente agli utenti di scegliere da un insieme di risultati in base al testo digitato, consentendo di scegliere tra risultati con nomi simili e di modificare la query in caso di errori di battitura di un indirizzo.

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

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

Consigliamo alle applicazioni che rispondono all'input dell'utente, e pertanto sono molto sensibili alla latenza, di usare la funzionalità Place Autocomplete nell'API Places (disponibile anche in JavaScript, Android o iOS) anziché risolvere i problemi di geocodifica. Il completamento automatico dei luoghi è ottimizzato per l'uso 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, ad esempio gli indirizzi di consegna inseriti nei moduli online, e pertanto ha una latenza maggiore rispetto al completamento automatico di Place Autocomplete. Il geocodificatore in avanti ha una maggiore copertura e una migliore qualità dei risultati, ma con una latenza leggermente più elevata.

Come posso mitigare la latenza sulle API Directions e sull'API Distanza Matrix?

Anziché gli indirizzi, utilizza gli ID luogo per specificare tappe, origine e destinazione. Il modo migliore per ottenere gli ID luogo è la funzionalità Place Autocomplete nell'API Places o la libreria Places nell'API Maps JavaScript. Vedi anche le informazioni sull'opzione placeIdOnly, che può essere utilizzata per ridurre il costo del completamento automatico di Place.

Quando viene eseguita una query all'API Directions o all'API Distanza Matrix con una stringa indirizzo anziché con un ID luogo o latlng, utilizzano lo stesso backend dell'API Geocoding per convertire l'indirizzo in un ID luogo prima di calcolare le indicazioni stradali. Il completamento automatico di luoghi è più veloce della geocodifica degli indirizzi. Per le applicazioni che utilizzano l'API Directions o l'API Distanza Matrix in situazioni sensibili alla latenza, come la risposta all'input utente, ti consigliamo di utilizzare Place Autocomplete per ottenere gli ID luogo corrispondenti a questi indirizzi e passare gli ID luogo all'API Directions o all'API Distanza Matrix. Questo approccio riduce notevolmente la latenza. Consulta la nostra documentazione per un esempio di come utilizzare il completamento automatico dei luoghi con le indicazioni stradali.

Come faccio a segnalare bug nel geocodificatore?

Se hai segnalazioni di bug o richieste di funzionalità per il servizio di inoltro dei geocodificati, comunicacelo utilizzando il nostro strumento di monitoraggio dei problemi pubblico.

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

Contattaci tramite il nostro strumento di monitoraggio dei problemi pubblico, condividendo alcune query specifiche, in modo da poter effettuare accertamenti per vedere se ci sono bug o problemi sistemici che causano problemi con la 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 i filtri dei componenti?

Nel geocodificatore, il filtro dei componenti applica solo le limitazioni postal_code e country. I seguenti esempi illustrano come utilizzare al meglio i filtri dei componenti a seconda dei risultati richiesti. Negli URL delle richieste di esempio, assicurati di sostituire "YOUR_API_KEY" con la 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 per paese utilizzando un codice paese ISO 3166-2. Non è garantito che i nomi dei paesi e altre abbreviazioni restituiscano 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 per la Francia (FRA) non è supportato, pertanto i risultati in qualsiasi paese sono consentiti e il risultato a Francoforte è più adatto di qualsiasi altro paese in Francia.
      https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY
      
  • L'API Geocoding non restituirà necessariamente più risultati per query ambigue. La risposta a queste query è più efficace grazie al completamento automatico di Place.

    Esempi:

    • La geocodifica per 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
      
    • L'utilizzo di Place Autocomplete per input=madrid&components=country:us&types=(regions) e la specifica di un'area visibile utilizzando location e radius per polarizzare i risultati relativi alle località genera una risposta denominata "Madrid" con diverse città degli Stati Uniti.
      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