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 ed evidenziazioni aggiuntive dell'indirizzo additionalFeatures impostando su. Core Prezzi dei luoghiPer informazioni sulle implicazioni in termini di costi relative ai risultati archiviati, fare riferimento a.
Per ulteriori informazioni, consulta Suggest nel riferimento all'API di Amazon Location Service.
Per esempio richieste, risposte, cURL e comandi CLI per questa API, vedi Come 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
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
Keyparametro è facoltativo se vengono utilizzati altri metodi di autenticazione.-
Key: chiave API per l'autorizzazione.
Per ulteriori informazioni, consulta Autenticazione con Amazon Location Service
-
- Interrogazione
-
Definisce la ricerca a testo libero e la distorsione della posizione.
-
QueryText: testo in formato libero per generare suggerimenti. (richiesto) -
BiasPosition: dà priorità ai suggerimenti in prossimità di una longitudine e latitudine specifiche.
Per ulteriori informazioni, consulta Interrogazione e distorsioni
-
- 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.
-
- 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
-
- 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
-
- 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 restituisceResultItems, che rappresenta le possibili corrispondenze per il completamento della query di input. Esistono due tipi di risultati, identificati daSuggestResultItemType: 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.
-
