Search API

Search TripAdvisor locations using the TripAdvisor API.
El componente permite enviar consultas de búsqueda a TripAdvisor y recibir información sobre hoteles, atracciones, restaurantes o ubicaciones geográficas según la categoría elegida.

¿Cómo funciona?

El componente se conecta al servicio de TripAdvisor mediante la librería TripAdvisorAPIClientAsync.

1. Se crea un cliente con la clave API que el usuario ha configurado previamente en la sección de credenciales de Nappai.
2. Se establecen la moneda y el idioma por defecto que se usarán en la respuesta.
3. El usuario envía datos de entrada que pueden ser texto, mensajes o objetos Data.
4. Para cada entrada se extraen los campos query, latitude, longitude y radius_km.
5. Si se dispone de los cuatro parámetros, se realiza una búsqueda con rango; si solo se tiene query y category, se hace una búsqueda básica.
6. Los resultados se añaden al objeto de datos bajo la clave correspondiente a la categoría seleccionada.
7. Finalmente, el componente devuelve la lista de objetos Data con la información enriquecida.

Entradas

Campos de Entrada

• Input: Datos que se enviarán a la API. Pueden ser texto, mensajes o objetos Data.
• Category: Selecciona la categoría de la búsqueda (hotels, attractions, restaurants, geos).
• Default Currency: Define la moneda que se usará en los resultados (por ejemplo, EUR, USD, GBP).
• Default Language: Define el idioma de los resultados (en, es, fr, de, etc.).

Nota: Este componente requiere una credencial de tipo TripAdvisor API.

1. Configura la credencial en la sección de credenciales de Nappai.
2. Selecciona la credencial en el campo Credential del componente.

Salidas

• Data: Lista de objetos Data que contienen la información de la búsqueda. Cada objeto incluye la categoría seleccionada con los resultados devueltos por TripAdvisor.

Ejemplo de Uso

1. Configura la credencial:

   • Ve a Credenciales → Agregar credencial → TripAdvisor API.
   • Introduce tu clave API y guarda.

2. Añade el componente al flujo y selecciona la credencial creada.

3. Configura los campos:

   • Category: hotels
   • Default Currency: EUR
   • Default Language: en

4. Proporciona la entrada (puedes usar un objeto Data con JSON):

   {
     "query": "Hotel",
     "latitude": 40.4168,
     "longitude": -3.7038,
     "radius_km": 5
   }

5. Ejecuta el flujo.
   El componente devolverá una lista de hoteles cercanos a la ubicación indicada, con precios en euros y descripciones en inglés.

Componentes Relacionados

• NappaiBaseComponent – Base para todos los componentes de Nappai.
• TripAdvisorAPIClientAsync – Cliente asíncrono que realiza las llamadas a la API de TripAdvisor.

Consejos y Mejores Prácticas

• Usa un rango de búsqueda razonable: Un radio demasiado grande puede devolver demasiados resultados y ralentizar el flujo.
• Valida la entrada: Asegúrate de que latitude y longitude estén en formato decimal correcto.
• Prueba con diferentes categorías: La categoría geos devuelve datos de ubicación sin detalles de negocio.
• Maneja los errores: Si la API devuelve un error, revisa la clave API y los límites de uso.

Consideraciones de Seguridad

• La clave API se almacena de forma segura en la sección de credenciales de Nappai y no se expone en el flujo.
• Evita compartir la credencial en entornos públicos o con usuarios no autorizados.
• Si sospechas que la clave ha sido comprometida, revísala y genera una nueva en el portal de TripAdvisor.