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 comprendere le implicazioni in termini di costi per i risultati archiviati.
Per ulteriori informazioni, consulta Geocode nel riferimento alle API di Amazon Location Service.
Per esempio richieste, risposte, cURL e comandi CLI per questa API, vedi Come 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, comeAdditionalFeatures, e BiasPositionFilter, per affinare i risultati della ricerca. Opzioni aggiuntive, come LanguageMaxResults, ePoliticalView, 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
Keyparametro è facoltativo se si utilizzano altri metodi.-
Key: parametro opzionale per l'autenticazione.
Per ulteriori informazioni, consulta Autenticazione con Amazon Location Service
-
- 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
-
- Perfezionamento dei risultati
-
Applica filtri per affinare i risultati.
-
Filter: Filtra per includere paesi o tipi di luoghi specifici. Per ulteriori informazioni, consulta Filtraggio.
-
- 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
-
- 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.
-
Comprendi la risposta
La risposta fornisceResultItems, che contengono dati dettagliati sulla posizione come AddressPlaceId,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 esempioAddressNumberoPostalCode) 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 esempioAddressNumberStreet, se unPostalCodepunteggio è 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à.
-
