Búsqueda de lugares

Una función clave de Amazon Location Service es la capacidad de buscar la información de geolocalización. Amazon Location proporciona esta funcionalidad a través del recurso Place Index.

nota

Para obtener información acerca de cómo utilizar los recursos de índice de ubicación para realizar búsquedas en la práctica, consulte Búsqueda de datos de ubicación y geolocalización mediante Amazon Location.

Puede usar las API de índice de sitios para buscar:

• Puntos de interés, como restaurantes y lugares de interés. Busque por nombre y ubicación opcional para buscar y reciba una lista de opciones ordenadas por relevancia.

• Una dirección física que recibe la latitud y la longitud de esa dirección. Esto se conoce como geocodificación.

• Posición de latitud y longitud que recibe la dirección postal asociada u otra información sobre la ubicación. Esto se conoce como geocodificación inversa.

• Una consulta de texto libre parcial o mal escrita, normalmente cuando un usuario la escribe. Esto se conoce como autocompletar, autosugerir o concordancia parcial.

El índice de ubicación incluye el proveedor de datos que se debe utilizar para la búsqueda.

nota

Los datos del mapa y otra información de geolocalización, incluidas las ubicaciones exactas, pueden variar de un proveedor de datos a otro. Como práctica recomendada, use el mismo proveedor de datos para el índice de ubicación, el mapa y otros recursos de Amazon Location. Por ejemplo, si los lugares devueltos por su índice de ubicación no coinciden con la ubicación de los mismos lugares que proporciona su recurso cartográfico, puede colocar un marcador en lo que parezca ser un lugar incorrecto del mapa.

A continuación, se muestra cómo crear y utilizar recursos de índice de ubicación:

1. En primer lugar, debe crear un recurso de indexación de lugares en su AWS cuenta seleccionando un proveedor de datos.

2. A continuación, puede seleccionar e instalar el SDK que mejor se adapte a su entorno de desarrollo y a sus aplicaciones. Para obtener más información sobre las opciones disponibles, consulte el tema sobre el acceso a Amazon Location.

3. Comience a usar las API de Amazon Location Places. Para obtener más información, consulte el tema sobre el uso de la búsqueda de lugares.

4. A continuación, puede integrar la supervisión mediante servicios como Amazon CloudWatch y AWS CloudTrail. Para obtener más información, consulte Supervisión de Amazon Location Service con Amazon CloudWatch y Registro y monitoreo con AWS CloudTrail.

Conceptos de geocodificación

Un índice de ubicación de Amazon Location proporciona una acción denominada SearchPlaceIndexForText que permite especificar el texto que se va a buscar. Por ejemplo, puede buscar:

• Lugares: una búsqueda de Paris podría arrojar la ubicación de la ciudad en Francia.

• Empresas: una búsqueda de coffee shop podría arrojar una lista de cafeterías, incluidos sus nombres y ubicaciones. También puede especificar una ubicación en la que buscar o un cuadro delimitador en el que buscar para que los resultados sean más relevantes. En este caso, si se proporciona una ubicación en el centro de Seattle (Washington), se mostarían las cafeterías de esa zona.

• Direcciones: una búsqueda de 1600 Pennsylvania Ave, Washington D.C. podría arrojar la ubicación de la Casa Blanca en los Estados Unidos (que se encuentra en esa dirección).

La búsqueda de texto de esta manera generalmente se denomina geocodificación, que implica buscar una ubicación geográfica para la dirección o el lugar.

Amazon Location Service también proporciona una acción de geocodificación inversa denominada SearchPlaceIndexForPosition. Toma una ubicación geográfica y muestra la dirección, la empresa u otra información sobre lo que hay en esa ubicación.

Resultados de búsqueda

Cuando realiza una solicitud de búsqueda correcta en Amazon Location Service, se muestran uno o más resultados. Cada resultado incluye una etiqueta, que es el nombre o la descripción del resultado. Por ejemplo, una búsqueda de coffee shop, puede arrojar un resultado con la etiqueta Hometown Cafe que indique que se ha encontrado una cafetería llamada “Hometown Cafe”. El resultado de la búsqueda también suele incluir una dirección estructurada (con propiedades como el número de dirección, la unidad, la calle y el código postal). Según el proveedor de datos, también incluirá otros metadatos, como el país y la zona horaria.

Para realizar una búsqueda por nombre o categoría de una empresa (por ejemplocoffee shop), puede que desee mostrar todos los resultados obtenidos en un mapa. En el caso de una búsqueda de direcciones, es posible que desee utilizar el primer resultado automáticamente. Consulte el tema siguiente para obtener información sobre la relevancia.

Múltiples resultados y relevancia

Al buscar por texto, Amazon Location Service suele encontrar más de un resultado. Por ejemplo, una búsqueda de Paris puede mostrar la ciudad de Francia, pero también la ciudad de Texas. Los resultados se ordenan por relevancia, según lo determine el proveedor de datos.

nota

Todos los proveedores muestran los resultados en orden de relevancia. Si elige Esri o Grab como proveedor de datos, los resultados incluyen un valor de relevancia que puede usar para comprender la relevancia relativa entre los resultados de una sola solicitud.

Si especifica información adicional, como el nombre de un país o una ubicación en la que buscar, puede cambiar el orden de los resultados, reducir el número de resultados o incluso cambiar el conjunto de resultados mostrados. Por ejemplo, una búsqueda de Paris con una ubicación en Texas para buscar es más probable que muestre Paris, Texas como el primer resultado que Paris, France.

En una aplicación interactiva, puede usar la relevancia como ayuda para decidir si acepta el primer resultado o para pedirle al usuario que elimine la ambigüedad entre varios resultados devueltos. Si el primer resultado tiene una gran relevancia, puede que simplemente lo acepte como la respuesta correcta. Si hay varios resultados de alta relevancia o no hay ningún resultado de alta relevancia, puede que desee enumerar los resultados y dejar que el usuario seleccione el mejor resultado.

Resultados de direcciones

Puede buscar direcciones con Amazon Location Service con la misma acción SearchPlaceIndexForText. Cuanta más información proporcione, mayor será la probabilidad de que la dirección mostrada coincida con la indicada. Por ejemplo, 123 Main St es menos probable que encuentre un resultado correcto que 123 Main St, Anytown, California, 90210.

Las direcciones tienen varios atributos, como el número de calle, la calle, la ciudad, la región y el código postal, etc. Estos atributos se utilizan para buscar una dirección en el índice de sitios que coincida con tantos aspectos como sea posible. Cuantos más atributos se encuentren, más relevante se considerará la coincidencia y mayor será la probabilidad de que se muestre.

nota

La relevancia de los resultados de las direcciones se basa en el grado de coincidencia entre el resultado y la entrada. Puede ser el número de atributos que coinciden, pero también el grado de coincidencia de los resultados con la entrada. Por ejemplo, una entrada de 123 Main St tendría mayor relevancia cuando Main St se encuentre en los datos que si fuera Maine St el único resultado. Maine St se seguirá mostrando, pero probablemente con un valor de relevancia inferior.

Los resultados de la búsqueda incluyen una etiqueta para la dirección completa (123 Main St, Anytown, California, 90210), pero también los atributos estructurados individuales de la dirección mostrada. Esto resulta útil porque se puede utilizar, por ejemplo, para rellenar los campos de direcciones de una base de datos o para examinar los resultados y buscar la ciudad, la región o el código postal de la ubicación encontrada.

Interpolación

Las direcciones incluidas en los datos del índice de sitios incluyen las coincidencias exactas de direcciones. Por ejemplo, supongamos que hay una calle 9th street y una manzana tiene 2 casas 220 y 240, como en la imagen siguiente.

El proveedor de datos crea los datos de geolocalización con esas dos direcciones conocidas. Puede buscar esas dos direcciones y las encontrará. Una vez que el proveedor de datos haya creado los datos del mapa, supongamos que se agrega una nueva casa entre las dos primeras direcciones. A esta nueva casa se le da la dirección 230. Si busca 230 S 9th St, el proveedor de datos seguirá encontrando un resultado. En lugar de utilizar una dirección conocida, interpolará entre las direcciones ya conocidas y calculará la posición de la nueva dirección a partir de ellas. En este caso, podría suponer que 230 está a medio camino entre 220 y 240 (y en el mismo lado de la calle) y mostrar una ubicación aproximada en función de esa ubicación.

nota

Los proveedores de datos actualizan periódicamente sus datos de geolocalización con nuevas direcciones. En este caso, 230 S 9th St se agregaría a los datos del proveedor de datos, pero normalmente habrá un período en el que se cree una nueva dirección pero aún no se haya agregado a los datos.

En este caso, el proveedor de datos no puede determinar si la nueva dirección existe en el mundo, ya que aún no está en los datos, pero ofrece la mejor respuesta posible a partir de la información de la que dispone. Este resultado se denomina interpolado y el proveedor de datos puede mostrarlo en los resultados. Si interpolated se muestrafalse, es una dirección conocida. Si se muestra true, es una dirección aproximada. Si no se muestra, significa que el proveedor de datos no proporcionó la información sobre si el resultado proviene de la interpolación.

importante

El proveedor de datos también puede mostrar resultados interpolados para direcciones que no existen en absoluto. Por ejemplo, en este caso, si introdujo 232 S 9th St, el proveedor encontraría esta dirección inexistente y mostraría una ubicación cercana a 230, pero en el lado 240. Las direcciones interpoladas son útiles para llegar a la ubicación correcta, pero conviene tener en cuenta que no son direcciones conocidas.

Almacenar los resultados de la geocodificación

Al crear un recurso de índice de ubicación, debe especificar una opción de almacenamiento de datos (denominada IntendedUse en la API). Se puede configurar para que sean resultados de un solo uso o almacenados. Se trata de una pregunta sobre el uso que pretende dar a los resultados. Si va a almacenar los resultados (incluso con fines de almacenamiento en caché), debe elegir la opción de almacenamiento, no la de un solo uso.

nota

Si elige la opción almacenada (etiquetada como Sí, los resultados se almacenarán en la consola, o elegir storage en la API CreatePlaceIndex), Amazon Location Service no almacenará los resultados por usted. Esto indica que planea almacenar los resultados.

Cuando piense en cómo va a utilizar los resultados de sus consultas en Amazon Location Service, siempre debe tener en cuenta las condiciones deAWS servicio aplicables.

Terminología de lugares

Recurso de índice de ubicación

Le permite elegir una fuente de datos para admitir las consultas de búsqueda. Por ejemplo, puede buscar puntos de interés, direcciones o coordenadas. Cuando se envía una consulta de búsqueda a un recurso de índice de ubicación, se completa con la fuente de datos configurada del recurso.

Geocodificación

La geocodificación es el proceso de tomar una entrada de texto, buscarla en el índice de ubicación y mostrar los resultados con la posición.

Geocodificación inversa

La geocodificación inversa es el proceso de tomar una posición y mostrar información sobre esa posición desde el índice de ubicación, como la dirección, la ciudad o el negocio de esa ubicación.

Relevancia

La relevancia es el grado de coincidencia entre un resultado y la entrada. No es una medida de la exactitud.

Interpolación

La interpolación es el proceso de encontrar direcciones desconocidas utilizando ubicaciones de direcciones conocidas como puntos de guía.

Códigos de país ISO 3166

Amazon Location Service Places utiliza los códigos de país 3166 de la Organización Internacional de Normalización (ISO) para referirse a países o regiones.

Para encontrar el código de un país o región específicos, utilice la plataforma de navegación en línea de la ISO.