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à. # Geocodifica inversa La geocodifica inversa converte le coordinate geografiche in un indirizzo o luogo leggibile dall'uomo. Fornisce informazioni dettagliate sull'indirizzo, sul tipo di luogo, sulla categoria e sulla strada, con opzioni di filtraggio basate sul tipo di luogo per affinare i risultati. L'API può anche includere funzionalità aggiuntive, come informazioni sul fuso orario e modifiche alle opinioni politiche. **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 [ReverseGeocode](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_ReverseGeocode.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/reverse-geocode-how-to.html) usare Reverse Geocode. ## Casi d’uso + **Aggiungi dati supplementari ai dati sulla posizione dei clienti: migliora i** record dei dati di posizione includendo codici postali, coordinate e utilizzando lo storage persistente per supportare decisioni aziendali e di marketing informate. + **Standardizzazione dei dati di posizione:** applica la geocodifica nelle pipeline di dati o nei processi batch per standardizzare i dati di posizione, utilizzando lo storage persistente come riferimento continuo. + **Determina i fusi orari:** identifica il fuso orario delle città o degli indirizzi per fornire timestamp precisi per applicazioni come viaggi, pianificazione e fatturazione. ## 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'[ReverseGeocode API Reference](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_ReverseGeocode.html). La richiesta Reverse Geocode API accetta una combinazione di parametri obbligatori e opzionali per personalizzare i risultati. Il parametro richiesto `QueryPosition` (longitudine e latitudine) specifica le coordinate per la geocodifica inversa. I parametri opzionali includono `AdditionalFeatures` dati aggiuntivi, `Filter` il perfezionamento dei risultati e la limitazione del numero `MaxResults` di risultati restituiti. Opzioni aggiuntive come `Language``PoliticalView`, e `IntendedUse` consentono un'ulteriore personalizzazione. Per maggiori dettagli, consulta il Reverse Geocode API Reference. La richiesta accetta i seguenti parametri chiave: **Autenticazione** Il `Key` parametro è facoltativo se vengono utilizzati altri metodi di autenticazione. + `Key`: parametro opzionale per l'autenticazione. Per ulteriori informazioni, consulta [Autenticazione con Amazon Location Service](access.md). **Esecuzione di query** Parametri utilizzati per definire la posizione geografica e il raggio di ricerca. + `QueryPosition`: specifica la longitudine e la latitudine per la richiesta di geocodifica inversa. + `QueryRadius`: definisce il raggio di ricerca attorno alle coordinate. Per ulteriori informazioni, consulta [Interrogazione e distorsioni](places-querying-biasing.md). **Perfezionamento dei risultati** Applica filtri per limitare i risultati della ricerca a paesi o tipi di luoghi specifici. + `Filter`: filtra i risultati in base al paese o al tipo di luogo. 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 sul fuso orario. Per ulteriori informazioni, consulta [Funzionalità aggiuntive](additional-features.md). ## Comprendi la risposta La risposta dell'API Reverse Geocode fornisce informazioni dettagliate sulle posizioni alle coordinate specificate. L'`ResultItems`array include un elenco di oggetti del luogo, ciascuno contenente i dettagli dell'indirizzo, le categorie e la posizione geografica. Dati aggiuntivi come `TimeZone``FoodTypes`, e `PostalCodeDetails` offrono un ulteriore contesto. La risposta include anche informazioni sui bounding box per la mappatura e la distanza dalla posizione dell'interrogazione. Per maggiori dettagli, consulta il Reverse Geocode API Reference. La risposta include i seguenti dati chiave: **Indirizzo e dettagli correlati** Informazioni dettagliate sull'indirizzo del luogo restituito. + `Address`: Informazioni complete sull'indirizzo, inclusi paese, regione, codice postale e dettagli stradali. + `PostalCodeDetails`: dettagli aggiuntivi relativi ai codici postali, come classificazioni e autorità postali. + `StreetComponents`: dettagli aggiuntivi sulla strada, tra cui nome e tipo di base. **Tipi e categorie di luoghi** Descrive il tipo e la categoria del luogo restituito. + `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. **Analisi dei risultati** Informazioni sulla corrispondenza tra ogni risultato e la query di input. + `MatchScores`: punteggi che indicano la precisione di ogni corrispondenza con la query di input. **Dettagli aggiuntivi** Fornisce dati aggiuntivi relativi alla posizione. + `TimeZone`: informazioni sul fuso orario della località. + `AccessPoints`: coordinate geografiche che rappresentano i punti di ingresso alla posizione.