Completamento automatico

Autocompleterestituisce 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

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. 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 nel riferimento alle API di Amazon Location Service.

Ad esempio richieste, risposte, cURL e comandi CLI per questa API, vedi Come 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'Autocompleteoperazione supporta molti attributi di richiesta opzionali per affinare i risultati della ricerca. Per l'elenco completo degli attributi della richiesta, consulta Autocomplete 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 o fornendo una chiave API.

• 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 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 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

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 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 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

• PlaceTypecontiene 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.

• Addresscontiene l'etichetta del risultato e, se ["Core"] specificato perAdditionalFeatures, 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 dalBiasPosition. Richiede AdditionalFeatures per essere impostato su ["Core"].

• Highlightsmostra 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"].