Locations Details

El componente Locations Details permite a los usuarios obtener información de TripAdvisor sobre un lugar concreto. Con él puedes consultar los detalles del lugar, las reseñas de los visitantes o las fotos publicadas, todo en un solo paso.

¿Cómo funciona?

Cuando lo arrastras al dashboard, el componente se conecta al servicio de TripAdvisor mediante una API. El usuario introduce el identificador del lugar (por ejemplo, un número que representa la ubicación en TripAdvisor) y elige qué tipo de información desea obtener:

• Location details – datos generales del lugar (nombre, dirección, puntuación, etc.).
• Location reviews – reseñas escritas por usuarios.
• location photos – fotos asociadas al lugar.

El componente envía una petición a TripAdvisor con la clave API que ya has configurado en Nappai y devuelve los resultados dentro de un objeto Data. Así puedes usar esos datos en otras partes del flujo de trabajo, como mostrarlos en un panel o guardarlos en tu base de datos.

Entradas

Campos de Entrada

• Input
  Datos que se enviarán a la API. Puedes introducirlos como texto, como un objeto Data, o como una lista de estos.
• Api Selection
  Selecciona el tipo de información que quieres obtener: Location details, Location reviews o location photos.
• Default Currency
  Define la moneda que se mostrará en los resultados (por ejemplo, EUR, USD, GBP, etc.).
• Default Language
  Establece el idioma en el que se devolverán los textos (en, es, fr, de, etc.).

Nota sobre credenciales
Este componente necesita una credencial de tipo TripAdvisor API.

1. Ve a la sección de credenciales de Nappai y crea una nueva credencial llamada TripAdvisor API.
2. Introduce tu clave API de TripAdvisor (puedes obtenerla en https://www.tripadvisor.com/developers?screen=credentials).
3. En el componente, selecciona esa credencial en el campo Credential (no aparece en la lista de entradas porque ya está preconfigurada).

Salidas

• Data
  Devuelve una lista de objetos Data. Cada objeto contiene el identificador del lugar y, según la operación elegida, añade una de las siguientes claves:
  • details – información general del lugar.
  • reviews – lista de reseñas.
  • photos – lista de fotos.
    Puedes usar esta salida para alimentar visualizaciones, guardarla en tu base de datos o pasarla a otro componente.

Ejemplo de Uso

1. Añade el componente al flujo de trabajo.
2. Configura la credencial de TripAdvisor API.
3. Introduce el identificador del lugar en el campo Input (por ejemplo, {"location_id": 123456}).
4. Selecciona Location reviews en Api Selection.
5. Elige la moneda y el idioma que prefieras.
6. Ejecuta el flujo.
7. La salida Data mostrará todas las reseñas del lugar, listas para mostrarlas en un panel de comentarios o analizarlas con otro componente.

Componentes Relacionados

• Data Fetcher – para obtener datos de otras APIs.
• Data Transformer – para limpiar o reestructurar la información recibida.
• Dashboard Card – para visualizar los resultados en una tarjeta del panel.

Consejos y Mejores Prácticas

• Limita la cantidad de datos: si solo necesitas los primeros 10 comentarios, filtra la respuesta antes de usarla.
• Maneja errores: si la API devuelve un error, muestra un mensaje claro al usuario.
• Reutiliza la credencial: crea una sola credencial de TripAdvisor y úsala en todos los componentes que la necesiten.
• Actualiza la clave: si cambias tu clave API, recuerda actualizar la credencial en Nappai.

Consideraciones de Seguridad

• La clave API se almacena de forma segura en la sección de credenciales de Nappai; no aparece en el flujo de trabajo.
• Evita exponer la clave en logs o en la salida del componente.
• Si compartes el flujo con otros usuarios, asegúrate de que tengan acceso a la credencial correspondiente.