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à. # Suggerimento Suggest fornisce previsioni o consigli basati sull'input o sul contesto dell'utente, ad esempio luoghi pertinenti, punti di interesse, termini di ricerca o categorie di ricerca. Aiuta gli utenti a trovare luoghi, punti di interesse o a identificare domande successive sulla base di input incompleti o errati. L'API restituisce un elenco di possibili corrispondenze o perfezionamenti, che possono essere utilizzati per formulare una query più accurata. Gli utenti possono selezionare il suggerimento appropriato per ulteriori ricerche. L'API supporta il filtraggio dei risultati per posizione e altri attributi e offre funzionalità aggiuntive come fonemi e fusi orari. La risposta include termini di interrogazione raffinati e informazioni dettagliate sul luogo. **Nota** Per impostazione predefinita, l'API Suggest restituisce solo `Title` campi `ID` e rappresenta un'opzione conveniente. È possibile richiedere componenti e punti salienti aggiuntivi dell'indirizzo `additionalFeatures` impostando su. `Core` [Prezzi dei luoghi](places-pricing.md)Per informazioni sulle implicazioni in termini di costi relative ai risultati archiviati, fare riferimento a. Per ulteriori informazioni, consulta [Suggest](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_Suggest.html) nel *riferimento all'API di Amazon Location Service*. Per esempio richieste, risposte, cURL e comandi CLI per questa API, vedi [Come](https://docs.aws.amazon.com/location/latest/developerguide/suggest-how-to.html) usare Suggest. ## Casi d’uso + **Servizi di Ride-Hailing:** fornisci suggerimenti in tempo reale per completare rapidamente gli indirizzi dei punti di ritiro e riconsegna, garantendo una prenotazione accurata e una prenotazione più rapida delle corse. + **Servizi di viaggio e navigazione:** offri previsioni in tempo reale per località o monumenti, anche in caso di termini errati o inseriti parzialmente, come «Eifel» per «Torre Eiffel». L'API perfeziona i suggerimenti per offrire punti di interesse pertinenti nelle vicinanze, aiutando gli utenti a localizzare i luoghi con precisione. + **Assistenza nella ricerca di ristoranti:** anticipa gli interessi degli utenti per i ristoranti e suggerisci ristoranti nelle vicinanze, migliorando l'esperienza di ricerca. ## Comprendi la richiesta **Nota** Per i clienti`ap-southeast-5`, i campi di richiesta e risposta supportati possono essere diversi. `ap-southeast-1` Per i dettagli, consulta il [Suggest API Reference](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_Suggest.html). La richiesta API Suggest utilizza parametri per generare suggerimenti in base all'input dell'utente. I parametri opzionali consentono di perfezionare i risultati di ricerca utilizzando criteri di filtraggio e distorsioni in base alla località. Per maggiori dettagli, consulta il Suggest API Reference. La richiesta include i seguenti parametri chiave: **Autenticazione** Il `Key` parametro è facoltativo se vengono utilizzati altri metodi di autenticazione. + `Key`: chiave API per l'autorizzazione. Per ulteriori informazioni, consulta [Autenticazione con Amazon Location Service](access.md) **Esecuzione di query** Definisce la ricerca a testo libero e la distorsione della posizione. + `QueryText`: testo in formato libero per la generazione di suggerimenti. (richiesto) + `BiasPosition`: dà priorità ai suggerimenti in prossimità di una longitudine e latitudine specifiche. Per ulteriori informazioni, consulta [Interrogazione e distorsioni](places-querying-biasing.md) **Perfezionamento dei risultati** Filtra i risultati per restringere i criteri di ricerca. + `Filter`: consente il filtraggio per riquadro di delimitazione o area circolare per limitare i risultati della ricerca. Per ulteriori dettagli, consulta [Filtraggio](places-filtering.md). **Internazionalizzazione e localizzazione** Opzioni per personalizzare la lingua e applicare una visione politica ai risultati. + `Language`: specifica la lingua dei risultati. + `PoliticalView`: Applica una visione politica che riflette le rivendicazioni territoriali. Per ulteriori informazioni, consulta [Localizzazione e internazionalizzazione](places-localization-internationalization.md) **Funzionalità aggiuntive** Richiede dati aggiuntivi, come informazioni sul fuso orario. + `AdditionalFeatures`: Opzione per richiedere dettagli aggiuntivi come il fuso orario o i dati fonetici. Per ulteriori informazioni, consulta [Funzionalità aggiuntive](additional-features.md) **Limitazione dei risultati** Imposta limiti al numero di risultati o perfezionamenti delle query restituiti. + `MaxQueryRefinements`: limita il numero di termini di perfezionamento delle query restituiti. + `MaxResults`: limita il numero di suggerimenti restituiti. ## Comprendi la risposta La risposta fornisce indirizzi o luoghi suggeriti in base alla query di input, con attributi come posizione, dettagli dell'indirizzo, catene commerciali, contatti, fonemi, fuso orario e orari di apertura. L'API restituisce`ResultItems`, che rappresenta le possibili corrispondenze per il completamento della query di input. Esistono due tipi di risultati, identificati da`SuggestResultItemType`: i risultati di tipo `Query` suggeriscono una categoria successiva o una query a catena, che può essere utilizzata per ottenere risultati mirati per una categoria specifica passandoli `QueryID` all' SearchText API. I risultati di tipo `Place` forniscono un risultato finale con un indirizzo e informazioni aggiuntive sul luogo. Per ulteriori dettagli, consulta l'API Reference for Suggest API. La risposta include i seguenti dati chiave: **Analisi dei risultati** Fornisce informazioni sul perfezionamento della query di input. + `QueryRefinements`: Termini che possono essere utilizzati per affinare la query di ricerca. + `Highlights`: evidenzia le parti dell'indirizzo o del titolo che corrispondono alla query. **Tipi e categorie di luoghi** Descrive il tipo e la categoria del luogo. + `Categories`: Categorie che descrivono il luogo, come *ristoranti* o *scuole*. + `PlaceType`: specifica il tipo di luogo, ad esempio una città, un indirizzo o una regione. + `BusinessChains`: indica tutte le catene aziendali associate. **Dettagli aggiuntivi** Informazioni aggiuntive sul luogo, come specificato nella richiesta. + `Contacts`: fornisce e-mail, numeri di telefono e siti Web. + `OpeningHours`: Orari operativi del luogo. + `AccessPoints`: coordinate geografiche associate al luogo. + `Phonemes`: Rappresentazioni fonetiche dei componenti dell'indirizzo. + `TimeZone`: Informazioni sul fuso orario, incluso l'offset.