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à. # Testo di ricerca Search Text consente di interrogare i dati sulla posizione utilizzando un unico input di testo in formato libero, restituendo i risultati relativi alla località con filtri opzionali come paese, cerchio geografico o riquadro di selezione. L'API consente anche la ricerca in base ai dati `QueryId` restituiti dall'API Suggest. La risposta include dettagli come nome del luogo, indirizzo, numero di telefono, categoria, tipo di cibo, informazioni di contatto e orari di apertura. In base a parametri specifici, sono disponibili anche funzionalità opzionali come fonemi, fusi orari e altro ancora. **Nota** Se i risultati vengono archiviati, verranno fatturati al livello di prezzo Storage più elevato. Utilizza il `IntendedUse` parametro per specificare se i risultati sono monouso o di archiviazione. [Prezzi dei luoghi](places-pricing.md)Per informazioni sulle implicazioni in termini di costi associate ai risultati archiviati, fare riferimento a. Per ulteriori informazioni, consulta il *riferimento [SearchText](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_SearchText.html)all'API di Amazon Location Service*. Per esempio richieste, risposte, cURL e comandi CLI per questa API, vedi [Come usare](https://docs.aws.amazon.com/location/latest/developerguide/search-text-how-to.html) Search Text. ## Casi d’uso + **Ricerca testuale nel quartiere:** aiuta i clienti a individuare il luogo pertinente più vicino. I clienti possono trovare l'indirizzo, l'attività commerciale o l'attrazione più vicina, come musei, negozi o parchi. + **Business discovery:** consenti agli utenti di trovare attività commerciali o tipi di luoghi specifici inserendo parole chiave come «ristorante italiano» o «caffetteria». Questa funzione è particolarmente utile per le app per la consegna di cibo o per i consigli sui ristoranti. + **Ricerca di luoghi nelle app di viaggio:** consenti agli utenti di cercare località, monumenti o attività commerciali utilizzando testo in formato libero, ad esempio «hotel vicino alla Torre Eiffel», per ricevere rapidamente suggerimenti pertinenti. + **Ricerca negli istituti di istruzione:** consenti agli utenti di cercare scuole, college o centri di formazione (ad esempio, «scuole elementari» o «università»), uno strumento utile per genitori o studenti. ## 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 l'[SearchText API Reference](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_SearchText.html). La richiesta Search Text API consente di affinare la ricerca con diversi parametri. I parametri opzionali abilitano funzionalità aggiuntive, la distorsione della posizione, i criteri di filtro, le preferenze linguistiche e i limiti dei risultati. Per maggiori dettagli, consulta il Search Text 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** Parametri utilizzati per specificare la ricerca testuale e la distorsione della posizione. + `QueryText`: testo in formato libero per la ricerca di luoghi. + `QueryId`: consente il completamento delle query suggerite dall'API Suggest. + `BiasPosition`: dà priorità ai risultati in prossimità di una longitudine e una 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, consultare [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 dati aggiuntivi come i dettagli del fuso orario. Per ulteriori informazioni, consulta [Funzionalità aggiuntive](additional-features.md). ## Comprendi la risposta La risposta dell'API Search Text include risultati dettagliati che corrispondono alla query, con informazioni sulla posizione, i dettagli dell'indirizzo, le catene commerciali, i contatti, i fonemi, il fuso orario e gli orari di apertura. Per maggiori dettagli, consulta il Search Text API Reference. La risposta include i seguenti dati chiave: **Indirizzo e dettagli correlati** Informazioni complete sull'indirizzo della località restituita. + `Address`: Include i dettagli del paese, della via e di altro indirizzo. **Tipi e categorie di luoghi** Descrive il tipo e la categoria del luogo. + `Categories`: Un elenco di categorie che descrivono il luogo, ad esempio *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** Dati aggiuntivi relativi al luogo, come richiesto. + `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.