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 La geocodifica trasforma gli indirizzi testuali o i nomi dei luoghi in coordinate geografiche, insieme a componenti di indirizzo dettagliati e informazioni aggiuntive. Questa API supporta query flessibili, tra cui testo in formato libero e query strutturate con nomi di strade, codici postali e regioni. Le funzionalità opzionali includono i dati sul fuso orario e le modifiche alle opinioni politiche. **Nota** I risultati archiviati comportano prezzi di archiviazione più elevati. Utilizza il `IntendedUse` parametro per indicare il monouso o lo storage. Consulta la sezione per [Prezzi dei luoghi](places-pricing.md) comprendere le implicazioni in termini di costi per i risultati archiviati. Per ulteriori informazioni, consulta [Geocode](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_Geocode.html) nel *riferimento alle 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/how-to-geocode.html) usare Geocode. ## Casi d'uso + **Aggiungi dati supplementari agli indirizzi dei clienti: migliora i record degli indirizzi** includendo codici postali, coordinate e utilizzando l'archiviazione persistente per supportare decisioni aziendali e di marketing informate. + **Standardizzazione dei dati di indirizzo:** applica la geocodifica nelle pipeline di dati o nei processi batch per standardizzare i dati degli indirizzi, utilizzando lo storage persistente come riferimento continuo. + **Determinazione dei fusi orari:** identifica il fuso orario delle città o degli indirizzi per fornire timestamp accurati per applicazioni come viaggi, pianificazione e fatturazione. ## Comprendi la richiesta La richiesta accetta parametri opzionali, come`AdditionalFeatures`, e `BiasPosition``Filter`, per affinare i risultati della ricerca. Opzioni aggiuntive, come `Language``MaxResults`, e`PoliticalView`, forniscono un'ulteriore personalizzazione della risposta. Il parametro richiesto è`Query`, che può essere fornito come testo in formato libero o strutturato come. `QueryComponents` Per ulteriori informazioni, consulta il Geocode API Reference. La richiesta include i seguenti parametri chiave: **Autenticazione** Per l'autenticazione, il `Key` parametro è facoltativo se si utilizzano altri metodi. + `Key`: parametro opzionale per l'autenticazione. Per ulteriori informazioni, consulta [Autenticazione con Amazon Location Service](access.md) **Interrogazione e polarizzazione** Parametri utilizzati per l'interrogazione e la distorsione geografica dei risultati. + `QueryText`: interrogazione di testo in formato libero per la ricerca di posizioni. + `QueryComponents`: componenti strutturati come numero di indirizzo, paese, località o codice postale per una ricerca precisa. + `BiasPosition`: posizione geografica verso cui orientare i risultati di ricerca. Per ulteriori informazioni, consulta [Interrogazione e distorsioni](places-querying-biasing.md) **Perfezionamento dei risultati** Applica filtri per affinare i risultati. + `Filter`: Filtra per includere paesi o tipi di luoghi specifici. Per ulteriori informazioni, consulta [Filtraggio](places-filtering.md). **Internazionalizzazione e localizzazione** Specificate la lingua e applicate la visione politica per risultati localizzati. + `Language`: Lingua per i risultati. + `PoliticalView`: Applica una visione politica che riflette le rivendicazioni territoriali. Per ulteriori informazioni, consulta [Localizzazione e internazionalizzazione](places-localization-internationalization.md) **Funzionalità aggiuntive** Richiedi informazioni aggiuntive come i dettagli del fuso orario. + `AdditionalFeatures`: Opzione per richiedere dettagli aggiuntivi come il fuso orario. Per ulteriori informazioni, consulta [Funzionalità aggiuntive](additional-features.md). ## Comprendi la risposta La risposta fornisce`ResultItems`, che contengono dati dettagliati sulla posizione come `Address``PlaceId`,`Position`, e altri attributi pertinenti. Possono essere incluse anche funzionalità aggiuntive come `TimeZone` le informazioni o `MatchScores` per ogni componente di query. Ciascuno `ResultItem` rappresenta una posizione corrispondente o un risultato di geocodifica in base ai parametri di richiesta specificati. Per ulteriori dettagli, consulta il Geocode API Reference. La risposta include i seguenti parametri chiave: **Indirizzo e dettagli correlati** Dettagli sulla località restituita, inclusi i componenti dell'indirizzo. + `Address`: indirizzo completo comprensivo di paese, regione, codice postale e dettagli della via. + `PostalCodeDetails`: informazioni aggiuntive relative ai codici postali. + `StreetComponents`: dettagli della strada, compresi il nome e il tipo della base. **Tipi e categorie di luoghi** Informazioni sul tipo e sulla categoria di luogo restituito. + `Categories`: Elenco delle categorie che descrivono il luogo, ad esempio *Ristoranti*, *Scuole*. + `PlaceType`: specifica il tipo di luogo, ad esempio città, indirizzo o regione. **Analisi dei risultati** Punteggi che indicano quanto i risultati corrispondano alla query di input. + `MatchScores`: Punteggi per la precisione corrispondente. + `Overall`: Misura la corrispondenza tra una ricerca di indirizzi e i dati inseriti, su una scala da 0,0 a 1,0 (da 0% a 100%). Un punteggio perfetto di 1,0 significa che ogni parte della ricerca è stata trovata nel database. È normale vedere punteggi più bassi quando si includono dettagli aggiuntivi come i nomi dei contatti o le istruzioni di consegna. Questi naturalmente riducono il punteggio, ma non significano necessariamente che l'indirizzo sia sbagliato. + `Component Score`: a ogni componente dell'indirizzo (ad esempio `AddressNumber` o`PostalCode`) viene assegnato un punteggio individuale su una scala da 0,0 a 1,0 (da 0% a 100%). Questi punteggi indicano la precisione con cui ogni parte dell'indirizzo corrisponde al risultato. Ad esempio `AddressNumber``Street`, se un `PostalCode` punteggio è vicino a 1,0, puoi fidarti della corrispondenza anche se il punteggio complessivo è inferiore a causa di altri dettagli della query. **Nota** Quando non viene visualizzato alcun punteggio per un componente specifico (ad esempio`Street`), quel componente viene contato come 0. Questo aiuta a identificare le parti dell'indirizzo che potrebbero richiedere una verifica. Questo sistema di punteggio aiuta a bilanciare le corrispondenze esatte e l'usabilità pratica quando si tratta di ricerche di indirizzi nel mondo reale che spesso includono informazioni aggiuntive. **Dettagli aggiuntivi** Include informazioni aggiuntive relative alla posizione, se necessario. + `AccessPoints`: coordinate geografiche che rappresentano i punti di accesso. + `TimeZone`: informazioni sul fuso orario della località.