Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Completamento automatico `Autocomplete`restituisce gli indirizzi completi e i componenti degli indirizzi in base a un input parziale. I principali casi d'uso includono la compilazione automatica del modulo di indirizzo e il completamento dell'indirizzo digitato (completamento interattivo dell'indirizzo mentre l'utente finale lo sta digitando). **Nota** Per impostazione predefinita, per ogni risultato vengono restituiti solo gli attributi dell'ID del luogo, del tipo di luogo e dell'etichetta. Impostando l'attributo input è possibile ottenere ulteriori dettagli, tra cui la ripartizione completa degli indirizzi e gli intervalli di evidenziazione degli `AdditionalFeatures` input per i casi d'uso interattivi, ma tieni presente che la richiesta di funzionalità aggiuntive potrebbe avere un impatto [Prezzi dei luoghi](places-pricing.md) **Nota** Gli indirizzi giapponesi non sono supportati. I risultati sono sempre indirizzi o componenti di indirizzi come strade, codici postali e paesi. I punti di interesse non vengono mai restituiti. I risultati non includono i geocodici, poiché `Autocomplete` si concentrano sul completamento degli indirizzi, non sulla geocodifica. [Per ottenere le coordinate di geocodifica degli indirizzi, utilizzare l'operazione Geocode.](https://docs.aws.amazon.com/location/latest/developerguide/geocode.html) I risultati possono essere filtrati per area geografica. Possono anche essere filtrati per tipo di luogo, ad esempio per includere solo località o solo codici postali. Per i dettagli completi su tutti gli attributi di richiesta e risposta del completamento automatico, consulta la sezione [Completamento automatico](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_Autocomplete.html) nel riferimento alle *API di Amazon Location Service*. Ad esempio richieste, risposte, cURL e comandi CLI per questa API, vedi [Come](https://docs.aws.amazon.com/location/latest/developerguide/autocomplete-how-to.html) usare il completamento automatico. ## Casi d’uso + **Migliora l'esperienza di pagamento:** fornisci il completamento degli indirizzi in tempo reale man mano che i clienti inseriscono il proprio indirizzo nelle esperienze di pagamento dell'e-commerce e in altre esperienze di immissione degli indirizzi su siti Web o app. Assicurati che i luoghi di consegna o ritiro corrispondano agli indirizzi noti, riducendo errori costosi e aumentando la soddisfazione dei clienti. + **Supporta il servizio clienti:** fornisci suggerimenti sugli indirizzi in tempo reale ai rappresentanti del servizio clienti in settori come i contact center e l'invio di servizi di emergenza, snellisci il processo di raccolta di informazioni accurate sugli indirizzi e migliora la soddisfazione degli utenti riducendo il tempo necessario per ottenere informazioni corrette sull'indirizzo. ## Comprendi la richiesta L'`Autocomplete`operazione supporta molti attributi di richiesta opzionali per affinare i risultati della ricerca. Per l'elenco completo degli attributi della richiesta, consulta [Autocomplete](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_Autocomplete.html) nel riferimento alle *API di Amazon Location Service*. La richiesta accetta i seguenti parametri chiave: **Autenticazione** L'operazione dell'API Autocomplete supporta due modalità di autenticazione alternative. [È possibile autenticarsi firmando la richiesta con una [firma SigV4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) o fornendo una chiave API.](https://docs.aws.amazon.com/location/latest/developerguide/access.html) + Se stai effettuando richieste utilizzando un SDK AWS specifico per una lingua o utilizzando l'AWS CLI, la tua richiesta verrà normalmente firmata con SigV4 per impostazione predefinita. + In alcuni casi d'uso, ad esempio quando si effettuano richieste da un browser Web o si utilizzano altri client SDK non AWS, le chiavi API sono una forma di autenticazione più appropriata. Utilizza l'attributo opzionale Key request per fornire una chiave API per l'autenticazione. `Autocomplete` Per ulteriori informazioni, consulta il *riferimento [Autenticazione con Amazon Location Service](access.md) all'API di Amazon Location Service*. **Specificare l'indirizzo da interrogare** + Utilizza l'attributo di `QueryText` richiesta obbligatorio per fornire il testo in formato libero da interrogare. + `BiasPosition`: utilizzate l'attributo opzionale `BiasPosition` request per fornire una posizione del pin, come coppia di `[longitude, latitude]` coordinate, per migliorare la pertinenza dei risultati restituiti. Per ulteriori informazioni, consulta il *riferimento [Interrogazione e distorsioni](places-querying-biasing.md) all'API di Amazon Location Service*. **Inclusi tutti gli attributi di risposta** Imposta il campo opzionale sul AdditionalFeatures valore ["Core"] per includere tutti gli attributi di risultato disponibili nella risposta, tra cui la suddivisione completa dell'indirizzo e le posizioni di evidenziazione interattive. [Tieni presente che la richiesta di questi attributi aggiuntivi può influire sui prezzi](https://aws.amazon.com/location/pricing/) **Perfeziona i risultati** Utilizza l'attributo Filter per filtrare i risultati restituiti in base a paesi, tipi di luoghi o aree geografiche specifici. Per ulteriori dettagli, consulta [Filtraggio](places-filtering.md) la *Amazon Location Service Developer Guide*. ## Comprendi la risposta L'oggetto di risposta contiene un attributo di matrice denominato `ResultItems` che contiene l'elenco dei risultati classificati in ordine crescente di rilevanza. Per l'elenco completo degli attributi degli elementi dei risultati, consulta [Autocomplete](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_Autocomplete.html) nel riferimento all'*API di Amazon Location Service*. Di seguito è riportato un breve elenco di alcuni degli attributi più importanti degli elementi di risultato. **Indirizzo e relativi dettagli** + `PlaceType`contiene il tipo di luogo del risultato, che ci dice se l'indirizzo rappresenta un indirizzo postale, una strada, ecc. I risultati restituiti da `Autocomplete` avranno sempre un tipo di luogo che rappresenta un indirizzo completo o un componente di un indirizzo, ad esempio una via o un codice postale. I risultati non includeranno mai i punti di interesse. + `Address`contiene l'etichetta del risultato e, se `["Core"]` specificato per`AdditionalFeatures`, contiene anche la suddivisione completa dell'indirizzo in campi strutturati tra cui numero civico, nome della via, codice postale, paese e simili.. **Analisi dei risultati** Fornisce dati di analisi per ogni risultato in relazione alla query di input. + `Distance`: Se nella richiesta `BiasPosition` è stato fornito un, ogni elemento del risultato contiene un `Distance` attributo che indica la distanza, in metri, di quel risultato dal`BiasPosition`. Richiede `AdditionalFeatures` per essere impostato su `["Core"]`. + `Highlights`mostra dove le parole, le frasi e le sottostringhe dell'input `QueryText` appaiono esattamente in un attributo di risultato, consentendo alle applicazioni di fornire esperienze utente utili che evidenziano le corrispondenze per i propri utenti. Richiede `AdditionalFeatures` per essere impostato su `["Core"]`.