Domande frequenti sulla geocodifica
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Queste domande frequenti riguardano questioni specifiche dell'API Geocoding.
Per domande comuni a tutti i servizi Google Maps Platform, consulta le domande frequenti su 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à di 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 geocoding degli indirizzi.
Il completamento automatico dei luoghi è ottimizzato per essere utilizzato in modo interattivo e, di conseguenza, ha una latenza molto bassa.
Il geocodificazione 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 (legacy) e dell'API Distance Matrix (legacy)?
-
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 Indicazioni (legacy) o sull'API Distance Matrix (legacy) con una stringa di indirizzo anziché con un ID luogo o latlng, viene utilizzato 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 (legacy) o l'API Distance Matrix (legacy) in situazioni molto sensibili alla latenza, ad esempio per rispondere all'input dell'utente, ti consigliamo di utilizzare la funzionalità di completamento automatico dei luoghi per ottenere gli ID luogo corrispondenti a questi indirizzi e di passarli all'API Directions (legacy) o all'API Distance Matrix (legacy).
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. Che tipo di assistenza è disponibile?
-
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 di cui hai bisogno. 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 potrebbero non produrre 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 di ricerca della località, 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
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-31 UTC.
[null,null,["Ultimo aggiornamento 2025-08-31 UTC."],[[["\u003cp\u003eThis FAQ addresses questions about the Geocoding API; for general Google Maps Platform questions, refer to the Google Maps Platform FAQ.\u003c/p\u003e\n"],["\u003cp\u003eFor applications with user input and latency sensitivity, Google recommends using Place Autocomplete instead of address geocoding for better results and speed.\u003c/p\u003e\n"],["\u003cp\u003eTo improve latency with the Directions or Distance Matrix APIs, use place IDs obtained from Place Autocomplete instead of addresses.\u003c/p\u003e\n"],["\u003cp\u003eYou can report bugs or request features for the Geocoding API through the public issue tracker.\u003c/p\u003e\n"],["\u003cp\u003eComponent filtering in the Geocoding API is primarily used to restrict results by country and postal code.\u003c/p\u003e\n"]]],[],null,["This FAQ covers questions specific to the Geocoding API.\nRefer to the [Google Maps Platform FAQ](/maps/faq) for questions\ncommon to all Google Maps Platform. See also\n[Best Practices When Geocoding Addresses](/maps/documentation/geocoding/best-practices).\n\nTroubleshooting\n\n- [I'm getting more queries that return ZERO_RESULTS with the geocoder. What's going on?](#trbl-zero-results)\n- [I need fast responses, and the geocoder is too slow for my application. What can\n I use for faster responses?](#trbl-slow)\n- [How can I mitigate the latency on the Directions API (Legacy) and\n Distance Matrix API (Legacy)?](#trbl-latency)\n- [How do I report bugs in the geocoder?](#trbl-report-bug)\n- [The geocoder isn't producing good results for my use case. What help is available?](#trbl-help)\n- [How do I get the best results with the geocoder using component filtering?](#trbl-component-filtering)\n\nTroubleshooting\n\n\nI'm getting more queries that return ZERO_RESULTS with the geocoder. What's going on?\n\n: In the geocoder, ambiguous, incomplete and badly formatted queries, such as\n misspelled or nonexistent addresses, are prone to produce ZERO_RESULTS.\n If the address cannot be found, ZERO_RESULTS is preferable to a partial\n result (for example returning only the suburb in lieu of an address).\n\n If your application deals with user input of addresses, the\n [Place Autocomplete](/maps/documentation/places/web-service/autocomplete) feature\n in the Places API may produce better quality results.\n Place Autocomplete allows users to select from a set of results based on what\n they've typed, which allows users to choose between similarly named results,\n and to adjust their query if they misspell an address.\n\n If you have an application dealing with ambiguous or incomplete queries or queries\n that may contain errors, we recommend you use the\n [Place Autocomplete](/maps/documentation/places/web-service/autocomplete) feature\n in the Places API rather than the forward geocoder\n available in the Geocoding API. For more details, see\n [Best Practices When Geocoding Addresses](/maps/documentation/geocoding/best-practices) and the\n [Address Geocoding in the Google Maps APIs blog post](https://mapsplatform.google.com/resources/blog/address-geocoding-in-google-maps-apis/).\n\n\nI need fast responses, and the geocoder is too slow for my application. What can\nI use for faster responses?\n\n: We recommend that applications that respond to user input, and therefore are highly\n latency-sensitive, use the [Place Autocomplete](/maps/documentation/places/web-service/autocomplete)\n feature in the Places API (also available in\n [JavaScript](/maps/documentation/javascript/places-autocomplete),\n [Android](/maps/documentation/places/android-sdk/autocomplete), or\n [iOS](/maps/documentation/places/ios-sdk/autocomplete)) rather than address geocoding.\n Place Autocomplete is optimized to be used interactively, and thus has very low latency.\n\n Address geocoding in the Geocoding API is optimized for use with\n complete, unambiguous, well formatted addresses, such as delivery addresses entered into\n online forms, and thus has higher latency than Place Autocomplete. The forward geocoder\n has greater coverage and better result quality, but with somewhat higher latency.\n\n\nHow can I mitigate the latency on the Directions API (Legacy) and\nDistance Matrix API (Legacy)?\n\n: Instead of addresses, use [place IDs](/maps/documentation/places/web-service/place-id) to\n specify waypoints, origin, and destination. Place IDs are best obtained from the\n [Place Autocomplete](/maps/documentation/places/web-service/autocomplete)\n feature in the Places API or the\n [Places library](/maps/documentation/javascript/places-autocomplete) in the\n Maps JavaScript API. See also the information on the\n [`placeIdOnly`](/maps/documentation/javascript/places-autocomplete#placeidonly) option, which can be used to reduce the cost of\n Place Autocomplete.\n\n When the Directions API (Legacy) or Distance Matrix API (Legacy)\n is queried with an address string rather than a place ID or latlng, they use the same\n backend as the Geocoding API to convert that address into a\n place ID prior to calculating directions. Place Autocomplete is faster than address\n geocoding. For applications that use the Directions API (Legacy) or\n Distance Matrix API (Legacy) in highly latency-sensitive situations, such as\n responding to user input, we recommended you use Place Autocomplete to get the place IDs\n corresponding to those addresses, and pass the place IDs to the\n Directions API (Legacy) or Distance Matrix API (Legacy).\n This approach reduces latency significantly. See our documentation for an\n [example of how to use Place Autocomplete with directions](/maps/documentation/javascript/examples/places-autocomplete-directions).\n\n\nHow do I report bugs in the geocoder?\n\n: If you have any\n [bug reports](https://issuetracker.google.com/savedsearches/558483) or\n [feature requests](https://issuetracker.google.com/issues/new?component=188871&template=788905) for the forward geocoder service, let us know using our public\n [issue tracker](https://issuetracker.google.com/issues/new?component=188871&template=788906).\n\n\nThe geocoder isn't producing good results for my use case. What help is available?\n\n: Let us know using our public\n [issue tracker](https://issuetracker.google.com/savedsearches/558483), sharing a few specific queries, so we can investigate to\n see if there are any bugs or systemic issues causing problems with result\n quality, or if there are any changes we can make to the\n [best practices guide](/maps/documentation/geocoding/best-practices)\n to help developers get better results.\n\n\nHow do I get the best results with the geocoder using component filtering?\n\n: In the geocoder, [component filtering](/maps/documentation/geocoding/overview#component-filtering) enforces only `postal_code` and\n `country` restrictions. The following examples illustrate how best to use component\n filtering, depending on the results you need. In the sample request URLs, be sure to\n replace \\`YOUR_API_KEY\\` with your actual API key.\n\n - To restrict postal codes to a specific country, be sure to specify the country restriction using an [ISO 3166-2 country code](https://en.wikipedia.org/wiki/ISO_3166-2). For example: `components=country:CH|postal_code:8000` returns \"8000 Zürich, Switzerland\". \n\n ```scdoc\n https://maps.googleapis.com/maps/api/geocode/json?components=country:CH%7Cpostal_code:8000&key=YOUR_API_KEY\n ```\n - To restrict queries to a specific country, be sure to specify the country restriction using an [ISO 3166-2 country code](https://en.wikipedia.org/wiki/ISO_3166-2). Country names and other abbreviations may not produce the same results as country codes.\n\n Examples:\n - Geocoding for `components=country:FRA|locality:gallus` returns the sublocality of Gallus in Frankfurt am Main, Germany. This is because the 3-letter country code for France (FRA) isn't supported, thus results in any country are allowed and the result in Frankfurt is a better fit than anything in France. \n\n ```scdoc\n https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY\n ```\n - Geocoding API won't necessarily return multiple results for ambiguous queries. Such queries are better answered by the Place Autocomplete. Examples:\n\n - Geocoding for `components=country:US|locality:madrid` returns \"Madrid, NM 87010, USA\" but none of the other cities in the USA named \"Madrid\". \n\n ```scdoc\n https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY\n ```\n - Using Place Autocomplete for `input=madrid&components=country:us&types=(regions)`, and also specifying a viewport using `location` and `radius` to [bias the location results](/maps/documentation/places/web-service/autocomplete#location_biasing), generates a response with several cities in the USA named \"Madrid\". \n\n ```carbon\n 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\n ```"]]
