Ricerca di luoghi

Una funzione chiave di Amazon Location Service è la possibilità di cercare informazioni di geolocalizzazione. Amazon Location fornisce questa funzionalità tramite la risorsa Place index.

Nota

Per informazioni su come utilizzare le risorse dell'indice dei luoghi per effettuare ricerche pratiche, consultaRicerca di dati relativi a località e geolocalizzazione utilizzando Amazon Location.

Puoi usare l'indice dei luoghi APIs per cercare:

• Punti di interesse, come ristoranti e monumenti. Effettua la ricerca per nome e, se lo desideri, per visualizzare un elenco di opzioni ordinate in base alla pertinenza.

• Un indirizzo, che riceve una latitudine e una longitudine per quell'indirizzo. Questa operazione è nota come geocodifica.

• Una posizione di latitudine e longitudine, che riceve l'indirizzo stradale associato o altre informazioni sulla posizione. Questa operazione è nota come geocodifica inversa.

• Una query di testo in formato libero parziale o con errori di ortografia, in genere eseguita da un utente. Questa operazione è nota come completamento automatico, suggerimento automatico o corrispondenza fuzzy.

L'indice dei luoghi include il fornitore di dati da utilizzare per la ricerca.

Nota

I dati cartografici e altre informazioni di geolocalizzazione, comprese le posizioni esatte, possono variare a seconda dei fornitori di dati. Come best practice, utilizza lo stesso fornitore di dati per l'indice dei luoghi, la mappa e altre risorse di Amazon Location. Ad esempio, se i luoghi restituiti dall'indice dei luoghi non corrispondono alla posizione degli stessi luoghi forniti dalla risorsa cartografica, puoi posizionare un indicatore in quella che sembra essere la posizione sbagliata sulla mappa.

Di seguito viene illustrato come creare e utilizzare le risorse dell'indice dei luoghi:

1. Innanzitutto, crei una risorsa relativa all'indice dei luoghi nel tuo AWS account selezionando un fornitore di dati.

2. È quindi possibile selezionare e installare SDK quella più adatta all'ambiente di sviluppo e alle applicazioni in uso. Per ulteriori informazioni sulle opzioni disponibili, consulta l'argomento sull'accesso ad Amazon Location.

3. Inizia a utilizzare Amazon Location PlacesAPIs. Per ulteriori informazioni, consulta l'argomento sull'utilizzo della ricerca Places.

4. Puoi quindi integrare il monitoraggio utilizzando servizi come Amazon CloudWatch e AWS CloudTrail. Per ulteriori informazioni, consulta Monitoraggio di Amazon Location Service con Amazon CloudWatch e Registrazione e monitoraggio con AWS CloudTrail.

Concetti di geocodifica

Un indice dei luoghi di Amazon Location fornisce un'azione chiamata SearchPlaceIndexForTextche consente di specificare il testo da cercare. Ad esempio, puoi cercare:

• Luoghi: una ricerca per Paris potrebbe restituire l'ubicazione della città in Francia.

• Aziende: una ricerca di coffee shop potrebbe restituire un elenco di caffetterie, compresi i loro nomi e sedi. Puoi anche specificare una località in cui effettuare la ricerca o un riquadro di selezione in cui effettuare la ricerca, per rendere i risultati più pertinenti. In questo caso, fornire una sede nel centro di Seattle, Washington, restituirebbe le caffetterie di quella zona.

• Indirizzi: una ricerca 1600 Pennsylvania Ave, Washington D.C. potrebbe restituire l'ubicazione della Casa Bianca negli Stati Uniti (che si trova a quell'indirizzo).

La ricerca di testo in questo modo viene generalmente definita geocodifica, che consiste nel trovare una posizione geografica per l'indirizzo o il luogo.

Amazon Location Service fornisce anche un'azione di geocodifica inversa chiamata. SearchPlaceIndexForPosition Questa operazione prende una posizione geografica e restituisce l'indirizzo, l'azienda o altre informazioni su ciò che si trova in quella località.

Risultati della ricerca

Quando effettui una richiesta di ricerca con successo in Amazon Location Service, vengono restituiti uno o più risultati. Ogni risultato include un'etichetta, che è il nome o la descrizione del risultato. Ad esempio, una ricerca dicoffee shop, potrebbe restituire un risultato con l'etichetta Hometown Cafe che indica che è stata trovata una caffetteria chiamata «Hometown Cafe». Il risultato della ricerca include in genere anche un indirizzo strutturato (con proprietà quali numero di indirizzo, unità, via e codice postale). A seconda del fornitore di dati, includerà anche altri metadati, come il paese e il fuso orario.

Per una ricerca in base al nome o alla categoria di un'azienda (ad esempiocoffee shop), potresti voler mostrare tutti i risultati restituiti su una mappa. Per una ricerca di indirizzi, potresti voler utilizzare automaticamente il primo risultato. Per informazioni sulla pertinenza, consulta l'argomento successivo.

Molteplici risultati e rilevanza

Quando si esegue una ricerca per testo, Amazon Location Service trova spesso più di un risultato. Ad esempio, una ricerca di Paris può restituire la città in Francia, ma anche la città del Texas. I risultati vengono ordinati in base alla pertinenza, in base a quanto stabilito dal fornitore di dati.

Nota

I risultati vengono restituiti in ordine di rilevanza da tutti i fornitori. Se si sceglie Esri o Grab come fornitore di dati, i risultati includono un valore di pertinenza che è possibile utilizzare per comprendere la pertinenza relativa tra i risultati di una singola richiesta.

La specificazione di informazioni aggiuntive, come il nome di un paese o una località in cui effettuare la ricerca, può modificare l'ordine dei risultati, ridurre il numero di risultati o persino modificare il set di risultati restituiti. Ad esempio, è più probabile che una ricerca Paris con una località in Texas in cui effettuare la ricerca venga restituita Paris, Texas come primo risultato rispetto Paris, France a.

In un'applicazione interattiva, è possibile utilizzare la pertinenza per decidere se accettare il risultato principale o per chiedere a un utente di chiarire i diversi risultati restituiti. Se il primo risultato ha un'elevata rilevanza, potresti semplicemente accettarlo come risposta corretta. Se sono presenti più risultati ad alta pertinenza o nessun risultato di elevata rilevanza, potresti voler elencare i risultati e consentire all'utente di selezionare il risultato migliore.

Indirizza i risultati

Puoi cercare indirizzi con Amazon Location Service utilizzando la stessa SearchPlaceIndexForTextazione. Più informazioni fornisci, più è probabile che l'indirizzo restituito corrisponda a quello fornito. Ad esempio, 123 Main St è meno probabile che trovi un risultato corretto rispetto a123 Main St, Anytown, California, 90210.

Gli indirizzi hanno più attributi, come il numero civico, la via, la città, la regione e il codice postale, ecc. Questi attributi vengono utilizzati per trovare un indirizzo nell'indice dei luoghi che corrisponda al maggior numero possibile di aspetti. Maggiore è il numero di attributi trovati, più pertinente viene considerata la corrispondenza e maggiore è la probabilità che venga restituita.

Nota

La rilevanza per i risultati degli indirizzi si basa sulla corrispondenza tra il risultato e l'input. Questo potrebbe essere il numero degli attributi corrispondenti, ma anche la corrispondenza tra i risultati e l'input. Ad esempio, un input di 123 Main St avrebbe una rilevanza maggiore quando Main St viene trovato nei dati, rispetto a if Maine St come unico risultato. Maine Stverrà comunque restituito, ma probabilmente con un valore di pertinenza inferiore.

I risultati della ricerca includono un'etichetta per l'indirizzo completo (123 Main St, Anytown, California, 90210), ma anche i singoli attributi strutturati dell'indirizzo restituito. Ciò è utile perché è possibile utilizzarlo, ad esempio, per compilare i campi degli indirizzi in un database o per esaminare i risultati e trovare la città, la regione o il codice postale della località trovata.

Interpolazione

I dati dell'indice degli indirizzi includono le corrispondenze esatte degli indirizzi. Ad esempio, supponiamo che ci sia una strada 9th street e che un isolato abbia 2 case 220 e240, come nell'immagine seguente.

Il fornitore di dati crea i dati di geolocalizzazione con questi due indirizzi noti. Puoi cercare questi due indirizzi e verranno trovati. Dopo che il fornitore di dati ha creato i dati della mappa, supponiamo che venga aggiunta una nuova casa tra i primi due indirizzi. A questa nuova casa viene dato l'indirizzo230. Se cerchi230 S 9th St, il fornitore di dati troverà comunque un risultato. Invece di utilizzare un indirizzo noto, eseguirà l'interpolazione tra gli indirizzi già noti e stimerà la posizione del nuovo indirizzo in base a questi. In questo caso, si potrebbe supporre che 230 sia a metà strada tra 220 e 240 (e sullo stesso lato della strada) e restituire una posizione approssimativa in base a tale posizione.

Nota

I fornitori di dati aggiornano periodicamente i propri dati di geolocalizzazione con nuovi indirizzi. In questo caso, 230 S 9th St verrebbero aggiunti ai dati del fornitore di dati, ma in genere c'è un periodo in cui un nuovo indirizzo è stato creato ma non è ancora stato aggiunto ai dati.

In questo caso, il fornitore di dati non è in grado di stabilire se il nuovo indirizzo esiste nel mondo, in quanto non è ancora presente nei dati, ma fornisce la risposta migliore possibile sulla base delle informazioni in suo possesso. Questo risultato viene chiamato interpolato e può essere restituito dal fornitore di dati nei risultati. Se interpolated restituiscefalse, si tratta di un indirizzo noto. Se restituiscetrue, è un indirizzo approssimativo. Se non viene restituito, il fornitore di dati non ha fornito le informazioni sul fatto che il risultato provenga dall'interpolazione.

Importante

Il fornitore di dati può anche restituire risultati interpolati per indirizzi che non esistono affatto. Ad esempio, in questo caso, se hai inserito232 S 9th St, il provider troverà questo indirizzo inesistente e restituirà una posizione vicina a 230, ma sul lato 240. Gli indirizzi interpolati sono utili per raggiungere la posizione corretta, ma è bene tenere presente che non sono indirizzi noti.

Memorizzazione dei risultati della geocodifica

Quando si crea una risorsa relativa all'indice dei luoghi, è necessario specificare un'opzione di archiviazione dei dati (chiamata IntendedUse inAPI). Possono essere impostati come risultati monouso o memorizzati. Si tratta di una domanda sull'uso previsto dei risultati. Se intendi archiviare i risultati (anche per scopi di memorizzazione nella cache), devi scegliere l'opzione di archiviazione, non l'opzione monouso.

Nota

Quando scegli l'opzione memorizzata (etichettata come Sì, i risultati verranno archiviati nella console o scegli storage nella CreatePlaceIndexAPI), Amazon Location Service non memorizza i risultati per te. Ciò indica che intendi archiviare i risultati.

Quando esamini come utilizzerai i risultati delle tue richieste ad Amazon Location Service, devi sempre conoscere i Termini di AWS servizio applicabili.

Terminologia relativa ai luoghi

Risorsa dell'indice dei luoghi

Consente di scegliere una fonte di dati per supportare le query di ricerca. Ad esempio, puoi cercare punti di interesse, indirizzi o coordinate. Quando una query di ricerca viene inviata a una risorsa dell'indice dei luoghi, viene soddisfatta utilizzando l'origine dati configurata della risorsa.

Geocodifica

La geocodifica è il processo che prevede l'immissione di un testo, la ricerca nell'indice dei luoghi e la restituzione dei risultati con la posizione.

Geocodifica inversa

La geocodifica inversa è il processo di acquisizione di una posizione e restituzione di informazioni su tale posizione dall'indice dei luoghi, come l'indirizzo, la città o l'attività commerciale in quella posizione.

Relevance

La pertinenza è la corrispondenza tra un risultato e l'input. Non è una misura di correttezza.

Interpolazione

L'interpolazione è il processo di ricerca di indirizzi sconosciuti utilizzando posizioni di indirizzi note come punti guida.

ISO3166 codici nazionali

Amazon Location Service Places utilizza i codici paese 3166 dell'International Organization for Standardization (ISO) per fare riferimento a paesi o regioni.

Per trovare il codice per un paese o una regione specifici, utilizza la piattaforma di navigazione ISOonline.