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à. # Cerca nelle vicinanze L'API Search Nearby consente agli sviluppatori di ricercare i punti di interesse entro un raggio specificato dalle coordinate centrali. L'API fornisce risultati di localizzazione con filtri opzionali, tra cui categorie, catene commerciali, tipi di alimenti e altro ancora. I dettagli della risposta includono nome del luogo, indirizzo, telefono, categoria, tipo di cibo, contatto e orari di apertura. Funzionalità aggiuntive, come fonemi, fusi orari e altro, sono disponibili in base ai parametri richiesti. **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 [SearchNearby](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_SearchNearby.html)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/search-nearby-how-to.html) usare Search Nearby. ## Casi d’uso + **Applicazioni immobiliari:** fornisci ai potenziali acquirenti o affittuari di case un elenco di strutture e servizi nelle vicinanze di una proprietà, come scuole, ospedali e centri commerciali. + **Local Business Discovery:** consente agli utenti di localizzare attività commerciali, ristoranti o negozi entro un raggio specifico dalla loro posizione attuale. Ad esempio, un'app per la consegna di cibo può visualizzare i ristoranti nelle vicinanze in base alla posizione in tempo reale. + **App per viaggi e turismo:** aiutano i viaggiatori a esplorare attrazioni, monumenti, hotel e servizi vicino alla loro posizione o a una destinazione. Un'app di viaggio potrebbe suggerire punti di interesse nelle vicinanze come musei, parchi e siti storici. + **Servizi di emergenza:** aiuta gli utenti a trovare gli ospedali, le stazioni di polizia o le farmacie più vicini durante le emergenze, particolarmente utile per le app incentrate sulla salute, la sicurezza o la risposta alle catastrofi. + **Trasporti e logistica:** aiuta gli utenti a trovare le stazioni di rifornimento, i punti di ricarica per veicoli elettrici o le fermate del trasporto pubblico più vicine. I servizi di ride-hailing possono mostrare i conducenti disponibili nelle vicinanze. ## Comprendi la richiesta La richiesta API Search Nearby include parametri obbligatori come `QueryPosition` parametri opzionali come i filtri per affinare la ricerca. Opzioni aggiuntive, come `Language` e`PoliticalView`, personalizza i risultati per esigenze specifiche. Per ulteriori informazioni, consulta la pagina di riferimento dell'API Search Nearby. 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 posizione e il raggio di ricerca per la query. + `QueryPosition`: specifica le coordinate di longitudine e latitudine. + `QueryRadius`: definisce il raggio di ricerca attorno alle coordinate specificate. Per ulteriori informazioni, consulta [Interrogazione e distorsioni](places-querying-biasing.md) **Perfezionamento dei risultati** Filtra i risultati per restringere i criteri di ricerca. + `Filter`: Applica filtri come categorie, catene commerciali o tipi di alimenti. 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 informazioni sul fuso orario. Per ulteriori informazioni, consulta [Funzionalità aggiuntive](additional-features.md) ## Comprendi la risposta La risposta dell'API Search Nearby fornisce risultati dettagliati corrispondenti alla query, tra cui posizione, indirizzo, catene commerciali, contatti, fonemi, fuso orario e orari di apertura. Per maggiori dettagli, consulta il riferimento alle API di Search Nearby. La risposta include i seguenti dati chiave: **Indirizzo e dettagli correlati** Informazioni complete sull'indirizzo della località restituita. + `Address`: Include i dettagli completi dell'indirizzo, come paese e via. **Tipi e categorie di luoghi** Descrive il tipo e la categoria del luogo restituito. + `Categories`: Categorie che descrivono il luogo, come *ristoranti* o *scuole*. + `FoodTypes`: Tipi di cibo disponibili nei ristoranti o nelle trattorie. + `BusinessChains`: Indica tutte le catene commerciali associate. **Dettagli aggiuntivi** Informazioni aggiuntive relative al luogo, come richiesto. + `Contacts`: Elenca e-mail, numeri di telefono e siti Web. + `OpeningHours`: specifica gli orari di apertura del luogo. + `Phonemes`: fornisce rappresentazioni fonetiche dei componenti dell'indirizzo. + `TimeZone`: include informazioni sul fuso orario del luogo.