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à.
# GetPlace
GetPlace recupera informazioni dettagliate su un luogo utilizzando la sua unicità`PlaceId`. La richiesta supporta parametri opzionali per funzionalità aggiuntive, come i dati del fuso orario o i fonemi e la localizzazione della lingua. L'API restituisce informazioni come indirizzo, coordinate, dettagli aziendali, metodi di contatto e informazioni sul fuso orario.
**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 i dettagli sui costi associati ai risultati archiviati, fare riferimento a.
Per ulteriori informazioni, consulta il *riferimento [GetPlace](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_GetPlace.html)all'API di Amazon Location Service*.
[Per esempio richieste, risposte, cURL e comandi CLI per questa API, vedi Come usare. GetPlace](https://docs.aws.amazon.com/location/latest/developerguide/get-place-how-to.html)
## Casi d’uso
+ **Aggiorna i dati archiviati:** aggiorna regolarmente i dati archiviati per garantire che l'applicazione fornisca informazioni accurate e aggiornate. Utilizza l' GetPlace API per aggiornare i dettagli su aziende e luoghi, assicurandoti che gli utenti dispongano delle informazioni più recenti. Ad esempio, aggiorna gli orari di apertura, i dati di contatto e le recensioni degli utenti di ristoranti o negozi locali per aumentare la fiducia degli utenti e la funzionalità dell'applicazione.
+ **Recupera i dettagli del luogo dopo i suggerimenti di digitazione:** migliora l'esperienza utente integrando l' GetPlaceAPI con funzionalità di completamento automatico o di suggerimento. Man mano che gli utenti digitano un indirizzo, una ragione sociale o un punto di interesse, i suggerimenti forniscono i luoghi pertinenti e GetPlace consentono l'accesso a informazioni più dettagliate una volta effettuata la selezione.
## 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'[GetPlace API Reference](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_GetPlace.html).
La richiesta GetPlace API richiede parametri specifici, come`PlaceId`, e supporta parametri opzionali per funzionalità aggiuntive o la localizzazione della lingua. Questi parametri aiutano a personalizzare i risultati in base alla lingua, all'uso previsto e al contesto geografico. Per maggiori dettagli, consulta l' GetPlace API Reference.
La richiesta accetta 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 l'identificatore univoco per il recupero delle informazioni sul luogo.
+ `PlaceId`: L'identificatore univoco del luogo. (obbligatorio)
Per ulteriori informazioni, consulta [Interrogazione e distorsioni](places-querying-biasing.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 i dettagli del fuso orario.
+ `AdditionalFeatures`: Opzione per richiedere informazioni aggiuntive come il fuso orario o i dettagli del fonema.
Per ulteriori informazioni, consulta [Funzionalità aggiuntive](additional-features.md).
## Comprendi la risposta
La risposta dell' GetPlace API include dati di base, come indirizzo, coordinate e dettagli aziendali, oltre a dati aggiuntivi basati sui parametri della richiesta. È inoltre possibile fornire informazioni come restrizioni di accesso, fusi orari e dettagli fonematici per la pronuncia. Per ulteriori dettagli, consulta l' GetPlace API Reference.
La risposta include i seguenti dati chiave:
**Indirizzo e dettagli correlati**
Fornisce i dettagli completi dell'indirizzo della sede.
+ `Address`: informazioni complete sull'indirizzo, inclusi paese, regione e codice postale.
+ `PostalCodeDetails`: informazioni aggiuntive sui codici postali e sulle autorità.
**Tipi e categorie di luoghi**
Descrive il tipo e la categoria del luogo.
+ `BusinessChains`: Informazioni su tutte le catene commerciali associate.
+ `Categories`: Categorie a cui appartiene il luogo, come prodotti alimentari o vendita al dettaglio.
+ `PlaceType`: Tipo di luogo, ad esempio punto di interesse o località.
**Dettagli aggiuntivi**
Fornisce dati aggiuntivi sul luogo, come specificato nella richiesta.
+ `Contacts`: metodi di contatto, inclusi numeri di telefono, e-mail e siti Web.
+ `OpeningHours`: Orari di apertura o orari di accesso.
+ `AccessPoints`: Coordinate geografiche (longitudine e latitudine) dei punti di accesso.
+ `Phonemes`: Pronunce per vari componenti dell'indirizzo.
+ `TimeZone`: Informazioni sul fuso orario, incluso l'offset.