Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Buscar texto
Buscar texto le permite consultar los datos de ubicación mediante una única entrada de texto de formato libre y devuelve los resultados de los lugares con filtros opcionales como país, círculo geográfico o cuadro delimitador. La API también permite realizar búsquedas a partir del QueryId devuelto de la API de Sugerencias. La respuesta incluye detalles como el nombre del lugar, la dirección, el número de teléfono, la categoría, el tipo de comida, la información de contacto y el horario de apertura. Las características opcionales, como los fonemas, las zonas horarias, etc., también están disponibles en función de parámetros específicos.
nota
Si los resultados se almacenan, se facturarán según el nivel de precios de almacenamiento superior. Utilice el parámetro IntendedUse para especificar si los resultados son para un solo uso o para almacenamiento. Consulte Precios de lugares para implicaciones de los costos asociados a los resultados almacenados.
Para obtener más información, consulta SearchTextla referencia de la API de Amazon Location Service.
Para ver ejemplos de solicitudes, respuestas, cURL y comandos de la CLI para esta API, consulte Cómo usar la búsqueda de textos.
Casos de uso
-
Búsqueda de vecindario por texto: ayude a los clientes a localizar el lugar relevante más cercano. Los clientes pueden encontrar la dirección, el negocio o la atracción más cercana, como museos, tiendas o parques.
-
Descubrimiento de empresas: permita a los usuarios encontrar empresas o tipos de lugares específicos ingresando palabras clave como “restaurante italiano” o “cafetería”. Esta característica es especialmente útil para las aplicaciones de entrega de comida a domicilio o de recomendación de restaurantes.
-
Coloque la búsqueda en las aplicaciones de viajes: permita a los usuarios buscar ubicaciones, puntos de interés o negocios con texto libre, como “hoteles cerca de la Torre Eiffel”, para recibir sugerencias relevantes rápidamente.
-
Búsqueda de instituciones educativas: permita a los usuarios buscar escuelas, facultades o centros de formación (por ejemplo, “escuelas primarias” o “universidades”), una herramienta útil para padres o estudiantes.
Explicación de la solicitud
La solicitud de la API de Búsqueda de textos permite que varios parámetros ajusten la búsqueda. Los parámetros opcionales permiten características adicionales, sesgos de ubicación, criterios de filtrado, preferencias de idioma y límites de resultados. Para obtener más información, consulte la referencia de la API de Búsqueda de textos.
La solicitud incluye los siguientes parámetros claves:
- Autenticación
-
El parámetro
Keyes opcional si se utilizan otros métodos de autenticación.-
Key: clave de la API para la autorización.
Para obtener más información, consulte Autenticación con Amazon Location Service.
-
- Consultas
-
Parámetros utilizados para especificar la búsqueda de textos y el sesgo de ubicación.
-
QueryText: texto de formato libre para buscar lugares. -
QueryId: permite completar las consultas sugeridas desde la API de Sugerencias. -
BiasPosition: prioriza los resultados cerca de una longitud y latitud específicas.
Para obtener más información, consulte Consultas y sesgos.
-
- Ajuste de los resultados
-
Filtra los resultados para restringir los criterios de búsqueda.
-
Filter: permite filtrar por recuadro delimitador o área circular para limitar los resultados de la búsqueda.
Para obtener más información, consulte Filtrado.
-
- Internacionalización y localización
-
Opciones para personalizar el idioma y aplicar una visión política a los resultados.
-
Language: especifica el idioma de los resultados. -
PoliticalView: aplica una visión política que refleja las reclamaciones territoriales.
Para obtener más información, consulte Localización e internacionalización.
-
- Características adicionales
-
Solicita datos adicionales, como información sobre la zona horaria.
-
AdditionalFeatures: opción para solicitar datos adicionales, como detalles de la zona horaria.
Para obtener más información, consulte Características adicionales.
-
Explicación de la respuesta
La respuesta de la API de Búsqueda de textos incluye resultados detallados que coinciden con la consulta, con información sobre la ubicación, los detalles de la dirección, las cadenas empresariales, los contactos, los fonemas, la zona horaria y el horario de apertura. Para obtener más información, consulte la referencia de la API de Búsqueda de textos.
La respuesta incluye los datos de claves siguientes:
- Dirección y detalles relacionados
-
Información completa de la dirección de la ubicación devuelta.
-
Address: incluye detalles de la dirección, como el país, la calle, etc.
-
- Tipos y categorías de lugares
-
Describe el tipo y la categoría del lugar.
-
Categories: una lista de categorías que describen el lugar, como restaurantes o escuelas. -
PlaceType: especifica el tipo de lugar, como una ciudad, una dirección o una región. -
BusinessChains: indica cualquier cadena empresarial asociada.
-
- Detalles adicionales
-
Datos adicionales relacionados con el lugar, según se solicite.
-
Contacts: proporciona correos electrónicos, números de teléfono y sitios web. -
OpeningHours: Horario de funcionamiento del lugar. -
AccessPoints: coordenadas geográficas asociadas al lugar. -
Phonemes: representaciones fonéticas de los componentes de la dirección. -
TimeZone: información de zona horaria, incluida la desviación.
-
