Search API
Search API busca lugares en TripAdvisor: hoteles, atracciones, restaurantes o destinos. Le pasas lo que quieres buscar y, opcionalmente, unas coordenadas y un radio, y te devuelve los lugares que encuentra TripAdvisor.
Úsalo como primer paso para obtener los lugares y sus identificadores, y después pide sus detalles, opiniones o fotos con Locations Details.
Cuándo usarlo
- Proponer a un viajero restaurantes cerca de su hotel.
- Preparar una lista de atracciones de una ciudad para una guía o un boletín.
- Comparar los hoteles de una zona antes de cerrar una reserva de grupo.
- Dar a un agente de viajes virtual una forma de buscar lugares reales.
Configuración
El componente necesita una credencial TripAdvisor API con tu clave de TripAdvisor. Ver Credenciales.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial de TripAdvisor. |
| Input | Los datos de la búsqueda. Cada elemento debe incluir el campo query con lo que quieres buscar. Para buscar alrededor de un punto, añade también latitude, longitude y radius_km (el radio en kilómetros). Un texto sin más, como un mensaje del chat, se usa como query. |
| Category | Qué tipo de lugar se busca: hotels (hoteles), attractions (atracciones), restaurants (restaurantes) o geos (destinos). Por defecto, attractions. |
| Default Currency | La moneda en la que se muestran los precios. Por defecto, EUR. |
| Default Language | El idioma de los resultados. |
Resultado
La salida Data devuelve los mismos elementos que recibió, cada uno con un campo nuevo, llamado como la categoría elegida (por ejemplo restaurants), que contiene los lugares encontrados con su identificador de TripAdvisor.
Conéctalo a Locations Details para ampliar la información de cada lugar, o a un agente para que elija y presente las mejores opciones.
Ejemplo
Una agencia quiere sugerir restaurantes cerca del hotel de cada cliente:
- Prepara un dato con
query= “tapas”, y la latitud y longitud del hotel, conradius_km= 1. - Conéctalo a Input de Search API y elige restaurants en Category.
- Pasa el resultado a un agente que redacte una recomendación con tres restaurantes.
Componentes relacionados
- Locations Details: obtiene los detalles, las opiniones o las fotos de un lugar.