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.
Sugerencia
Sugerencias proporciona predicciones o recomendaciones en función de las aportaciones o el contexto del usuario, como lugares relevantes, puntos de interés, términos de consulta o categorías de búsqueda. Ayuda a los usuarios a encontrar lugares o puntos de interés o a identificar consultas de seguimiento en función de una entrada incompleta o mal escrita. La API devuelve una lista de posibles coincidencias o mejoras, que se puede utilizar para formular una consulta más precisa. Los usuarios pueden seleccionar la sugerencia adecuada para seguir buscando. La API permite filtrar los resultados por ubicación y otros atributos, y ofrece características adicionales, como fonemas y zonas horarias. La respuesta incluye términos de consulta ajustados e información detallada sobre el lugar.
nota
De forma predeterminada, la API de Sugerencias devuelve solo los campos ID y Title, lo que proporciona una opción rentable. Se pueden solicitar componentes de dirección y aspectos destacados adicionales configurando additionalFeatures en Core. Consulte los Precios de lugares para las implicaciones económicas de los resultados almacenados.
Para obtener más información, consulte Sugerencias en la 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 Sugerencias.
Casos de uso
-
Servicios de transporte: proporciona sugerencias en tiempo real para completar rápidamente las direcciones de las ubicaciones de recogida y entrega, a fin de garantizar la precisión y agilizar la reserva de viajes.
-
Servicios de viaje y navegación: ofrecen predicciones en tiempo real de ubicaciones o puntos de referencia, incluso en el caso de términos mal escritos o ingresados parcialmente, como “Eifel” para “Torre Eiffel”. La API ajusta las sugerencias para ofrecer puntos de interés cercanos relevantes, lo que ayuda a los usuarios a localizar los lugares con precisión.
-
Asistencia para la búsqueda de restaurantes: anticipa los intereses de los usuarios por los restaurantes y sugiere opciones gastronómicas cercanas para mejorar la experiencia de búsqueda.
Explicación de la solicitud
La solicitud de la API de Sugerencias utiliza parámetros para generar sugerencias en función de las entradas del usuario. Los parámetros opcionales permiten los resultados de búsqueda ajustados mediante criterios de filtrado y sesgos de ubicación. Para obtener más información, consulte la referencia de la API de Sugerencias.
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
-
Define la búsqueda de texto libre y el sesgo de ubicación.
-
QueryText: texto de formato libre para generar sugerencias (obligatorio). -
BiasPosition: prioriza las sugerencias 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, consulta 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 detalles adicionales, como datos de zona horaria o fonéticos.
Para obtener más información, consulte Características adicionales
-
- Limitación de resultados
-
Establece límites en la cantidad de resultados o ajustes de consulta devueltos.
-
MaxQueryRefinements: limita el número de términos de ajuste de consultas devueltos. -
MaxResults: limita el número de sugerencias devueltas.
-
Explicación de la respuesta
La respuesta proporciona direcciones o lugares sugeridos en función de la consulta de entrada, con atributos como la ubicación, los detalles de la dirección, las cadenas comerciales, los contactos, los fonemas, la zona horaria y el horario de apertura. La API devuelve ResultItems, que representan las posibles coincidencias a la hora de completar la consulta de entrada. Hay dos tipos de resultados, identificados por SuggestResultItemType: los resultados del tipo Query sugieren una categoría de seguimiento o una cadena de consultas, que se pueden utilizar para obtener resultados centrados para una categoría específica pasando QueryID a la API de SearchText. Los resultados de tipo Place proporcionan un resultado final con una dirección e información adicional sobre el lugar. Para obtener más información, consulte la referencia de la API de Sugerencias.
La respuesta incluye los datos de claves siguientes:
- Análisis de los resultados
-
Proporciona información sobre cómo ajustar la consulta de entrada.
-
QueryRefinements: términos que se pueden usar para ajustar la consulta de búsqueda. -
Highlights: resalta las partes de la dirección o el título que coinciden con la consulta.
-
- Tipos y categorías de lugares
-
Describe el tipo y la categoría del lugar.
-
Categories: 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
-
Información adicional sobre el lugar, como se especifica en la solicitud.
-
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.
-
