Domande frequenti sulla geocodifica

Queste domande frequenti riguardano quesiti specifici dell'API Geocoding. In caso di domande, consulta le Domande frequenti su Google Maps Platform comuni a tutte le piattaforme Google Maps. Vedi anche Best practice per la geocodifica degli indirizzi.

Risoluzione dei problemi

Risoluzione dei problemi

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

Nel geocodificatore, le query ambigue, incomplete e non formattate correttamente, ad esempio indirizzi con errori ortografici o inesistenti, tendono a generare ZERO_RESULTS. Se non è possibile trovare l'indirizzo, ZERO_RESULTS è preferibile (ad esempio, la restituzione di solo il sobborgo al posto dell'indirizzo).

Se la tua applicazione si occupa dell'input dell'utente di indirizzi, Funzionalità Posizione di completamento automatico nell'API Places potrebbero produrre risultati di qualità migliore. Place Autocomplete consente agli utenti di scegliere da un insieme di risultati in base a digitati, il che consente agli utenti di scegliere tra risultati con nomi simili e modificare la query se digitano un indirizzo in modo errato.

Se hai una domanda relativa a query o query ambigue o incomplete che potrebbero contenere errori, ti consigliamo di utilizzare Funzionalità Posizione di completamento automatico nell'API Places anziché nel geocodificatore avanzato disponibile nell'API Geocoding. Per ulteriori dettagli, vedi Best practice per la geocodifica degli indirizzi e . Rivolgiti a Geocoding nel post del blog sulle API di Google Maps.

Ho bisogno di risposte rapide e il geocodificatore è troppo lento per la mia applicazione. Cosa può Utilizzo per risposte più rapide?

È consigliabile che le applicazioni che rispondano all'input degli utenti e che quindi siano molto sensibili alla latenza, utilizza la funzione Place Autocomplete nell'API Places (disponibile anche in JavaScript Android oppure iOS) anziché gestire la geocodifica. Place Autocomplete è 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'uso con indirizzi completi, non ambigui e ben formattati, come gli indirizzi di consegna inseriti moduli online, quindi ha una latenza maggiore rispetto a Place Autocomplete. Il geocodificatore anteriore ha una maggiore copertura e una migliore qualità dei risultati, ma con una latenza leggermente più elevata.

Come posso mitigare la latenza sull'API Directions API Distance Matrix?

Anziché gli indirizzi, utilizza gli ID luogo per specificare tappe, luogo di partenza e destinazione. Gli ID località sono ottenuti meglio dal Posizione di completamento automatico nell'API Places o nella Libreria di Places nella API Maps JavaScript. Vedi anche le informazioni nella placeIdOnly, che può essere utilizzata per ridurre il costo di Place Autocomplete.

Quando l'API Directions o l'API Distance Matrix per le query con una stringa indirizzo anziché un ID luogo o dati latlng, utilizzano lo stesso come API Geocoding per convertire quell'indirizzo in un l'ID del luogo prima del calcolo delle indicazioni stradali. Place Autocomplete è più veloce dell'indirizzo la geocodifica. Per le applicazioni che utilizzano l'API Directions l'API Distance Matrix in situazioni altamente sensibili alla latenza, come in risposta all'input dell'utente, ti consigliamo di utilizzare Place Autocomplete per ottenere gli ID luogo corrispondenti a questi indirizzi e trasmetterai gli ID luogo API Directions o Distance Matrix. Questo approccio riduce significativamente la latenza. Consulta la nostra documentazione per informazioni esempio di come utilizzare Place Autocomplete con le indicazioni stradali.

Come faccio a segnalare bug nel geocodificatore?

Se ne hai segnalazioni di bug o . richieste di caratteristiche per il servizio di geocodificatore, faccelo sapere usando la nostra rete pubblica Issue Tracker.

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

Faccelo sapere utilizzando i nostri Issue Tracker, condividendo alcune domande specifiche per consentirci di effettuare accertamenti verifica se ci sono bug o problemi sistemici che causano problemi con i risultati qualità o se vengono apportate modifiche guida alle best practice per aiutare gli sviluppatori a ottenere risultati migliori.

Come ottengo risultati ottimali con il geocodificatore utilizzando il filtro dei componenti?

Nel geocodificatore, il filtro dei componenti applica solo postal_code e Limitazioni di country. I seguenti esempi illustrano come utilizzare al meglio il componente a seconda dei risultati desiderati. Negli URL di richiesta di esempio, sostituisci "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 con 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 limitazione del paese utilizzando Un codice paese ISO 3166-2. Paese nomi e altre abbreviazioni non sono garantiti per generare gli stessi risultati dei codici paese.

    Esempi:

    • Resi di geocodifica per components=country:FRA|locality:gallus la circoscrizione di Gallus a Francoforte sul Meno, in Germania. perché le tre lettere il codice paese per la Francia (FRA) non è supportato, pertanto è consentito qualsiasi paese 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 query ambigue. Tale risposte più precise grazie al completamento automatico del luogo.

    Esempi:

    • Resi di geocodifica per components=country:US|locality:madrid "Madrid, NM 87010, USA" ma nessuna delle altre città degli Stati Uniti è chiamata "Madrid". 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY
    • Utilizzo di Place Autocomplete per input=madrid&components=country:us&types=(regions) e specificare anche un'area visibile utilizzando location e radius per pregiudica i risultati relativi alle località, genera una risposta con diverse città negli Stati Uniti chiamato "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