Cómo buscar ubicaciones de alquiler vacacional
Antes de buscar propiedades de alquiler vacacional, debe encontrar un destino utilizando el punto final de autocompletar. Esto devuelve datos de ubicación (coordenadas, ID de lugar) y un ID de correlación que se requiere para el paso de búsqueda de propiedad.
Punto final de autocompletar
La API de alquileres vacacionales utiliza el mismo punto final de autocompletar que los hoteles y complejos turísticos.
Solicitud
GET /hotels/api/v2/autocomplete?key=miami
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
key | cadena | Sí | Palabra clave de búsqueda: nombre de ciudad, región, estado o punto de referencia |
Encabezados opcionales
| Encabezado | Requerido | Descripción |
|---|---|---|
Accept-Language | No | Código de idioma para resultados localizados (por ejemplo, "ar" para árabe, "es" para español) |
Respuesta
{
"data": [
{
"id": "place_abc123",
"country": "US",
"full_name": "Miami, Florida, United States",
"location": {
"lat": 25.7617,
"long": -80.1918
},
"name": "Miami",
"state": "Florida",
"type": "city"
},
{
"id": "place_def456",
"country": "US",
"full_name": "Miami Beach, Florida, United States",
"location": {
"lat": 25.7907,
"long": -80.13
},
"name": "Miami Beach",
"state": "Florida",
"type": "city"
}
]
}Campos de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
data | matriz | Lista de ubicaciones coincidentes |
data[].id | cadena | Identificador de lugar único (utilizado como placeid en la búsqueda) |
data[].country | cadena | Código de país de dos letras |
data[].fullname | cadena | Nombre completo para mostrar de la ubicación |
data[].location.lat | número | Coordenada de latitud |
data[].location.long | número | Coordenada de longitud |
data[].name | cadena | Nombre corto de la ubicación |
data[].state | cadena | Nombre del estado o provincia |
data[].type | cadena | Tipo de ubicación: "city", "state" o "multicity" |
Tipos de ubicación
| Tipo | Descripción | Ejemplo |
|---|---|---|
city | Una ciudad específica | Miami, París, Tokio |
state | Un estado, provincia o región | Florida, Baviera, Toscana |
multicity | Un área más amplia que abarca varias ciudades | Área metropolitana de Miami |
Capturando el ID de correlación
El x-correlation-id se devuelve como encabezado de respuesta (no en el cuerpo de la respuesta). Debe capturar este valor e incluirlo en la solicitud de búsqueda de alquiler vacacional posterior.
Ejemplo (JavaScript)
const response = await fetch(
'https://uat.travelapi.ai/hotels/api/v2/autocomplete?key=lake+tahoe',
{ headers: { 'Authorization': 'Bearer YOUR_TOKEN' } }
);
const correlationId = response.headers.get('x-correlation-id');
const data = await response.json();
// Use correlationId and data for the next search step
console.log('Correlation ID:', correlationId);
console.log('First result:', data.data[0]);
Ejemplo (Python)
import requests
response = requests.get(
'https://uat.travelapi.ai/hotels/api/v2/autocomplete',
params={'key': 'lake tahoe'},
headers={'Authorization': 'Bearer YOUR_TOKEN'}
)
correlation_id = response.headers.get('x-correlation-id')
data = response.json()
print(f"Correlation ID: {correlation_id}")
print(f"First result: {data['data'][0]}")
Soporte en varios idiomas
Para recibir nombres de ubicaciones en un idioma específico, pase el encabezado Accept-Language con un código de idioma admitido:
GET /hotels/api/v2/autocomplete?key=paris
Accept-Language: ar
Esto devuelve nombres de ubicaciones traducidos al idioma solicitado donde hay traducciones disponibles.
Valores necesarios para la búsqueda
De la respuesta de autocompletar, extraiga los siguientes valores para usarlos en la búsqueda de alquileres vacacionales:
| Valor | Fuente | Usado como |
|---|---|---|
| ID de correlación | x-correlation-id encabezado de respuesta | x-correlation-id encabezado de solicitud en búsqueda |
| Latitud | data[].location.lat | lat en el cuerpo de búsqueda |
| Longitud | data[].location.long | long en el cuerpo de búsqueda |
| ID del lugar | data[].id | place_id en el cuerpo de búsqueda |
Próximos pasos
Con una ubicación seleccionada y una ID de correlación capturada, está listo para buscar propiedades de alquiler vacacional disponibles.