Cómo utilizar los filtros de búsqueda de alquiler de coches
El punto final de Search Rentals admite un potente sistema de filtrado que le permite limitar los resultados por características del vehículo, precio y más. Los filtros se pasan como un único parámetro de consulta filter mediante una sintaxis estructurada.
Sintaxis del filtro
Cada expresión de filtro sigue el formato:
Para aplicar varios filtros, sepárelos con comas:
filter=price:lte:100,vehicletype:in:SUV,transmissiontype:eq:Automatic
Todos los filtros se aplican juntos como condiciones AND. Un resultado debe coincidir con todos los filtros que se incluirán.
Campos de filtro disponibles
Precio
| Filtro | Descripción | Ejemplo |
|---|
price:lte:{amount} | Precio máximo (menor o igual). | price:lte:150 |
price:gte:{amount} | Precio mínimo (mayor o igual). | price:gte:50 |
Combine ambos para definir un rango de precios:
filter=price:gte:50,price:lte:150
Marca del vehículo
| Filtro | Descripción | Ejemplo |
|---|
rentalcarbrand:in:{brands} | Filtrar por una o más empresas de alquiler. | rentalcarbrand:in:Hertz |
Utilice el operador in con valores separados por tuberías para varias marcas:
filter=rentalcarbrand:in:Hertz|Enterprise|Avis
Capacidad de pasajeros
| Filtro | Descripción | Ejemplo |
|---|
passengerquantity:eq:{count} | Número exacto de pasajeros. | passengerquantity:eq:5 |
passengerquantity:gte:{count} | Número mínimo de pasajeros. | passengerquantity:gte:4 |
Capacidad de equipaje
| Filtro | Descripción | Ejemplo |
|---|
baggagequantity:eq:{count} | Capacidad exacta de equipaje. | baggagequantity:eq:2 |
baggagequantity:gte:{count} | Capacidad mínima de equipaje. | baggagequantity:gte:3 |
Recuento de puertas
| Filtro | Descripción | Ejemplo |
|---|
doorcount:gte:{count} | Número mínimo de puertas. | doorcount:gte:4 |
Tipo de transmisión
| Filtro | Descripción | Ejemplo |
|---|
transmissiontype:eq:{type} | Filtrar por tipo de transmisión. | transmissiontype:eq:Manual |
Valores comunes: Manual, Automatic.
Tipo de combustible
| Filtro | Descripción | Ejemplo |
|---|
fueltype:eq:{type} | Filtrar por tipo de combustible. | fueltype:eq:Petrol |
Valores comunes: Petrol, Diesel, Electric, Hybrid.
Tipo de unidad
| Filtro | Descripción | Ejemplo |
|---|
drivetype:eq:{type} | Filtrar por tipo de unidad. | drivetype:eq:4WD |
Valores comunes: 2WD, 4WD, AWD.
Aire acondicionado
| Filtro | Descripción | Ejemplo |
|---|
airconditioning:eq:{val} | Filtrar por estado del aire acondicionado. | airconditioning:eq:true |
Tipo de vehículo
| Filtro | Descripción | Ejemplo |
|---|
vehicletype:in:{types} | Filtrar por uno o más tipos de vehículos. | vehicletype:in:SUV |
Valores comunes: Sedan, SUV, Van, Convertible, Wagon, Pickup, Coupe.
Utilice valores separados por tuberías para varios tipos:
filter=vehicle_type:in:SUV|Van
Tamaño del vehículo
| Filtro | Descripción | Ejemplo |
|---|
vehiclesize:in:{sizes} | Filtrar por uno o más tamaños de vehículos. | vehiclesize:in:Standard |
Valores comunes: Mini, Economy, Compact, Standard, Full-size, Premium, Luxury.
Utilice valores separados por tuberías para varios tamaños:
filter=vehicle_size:in:Standard|Full-size|Premium
Modelo de vehículo
| Filtro | Descripción | Ejemplo |
|---|
vehiclemodel:eq:{model} | Coincidencia exacta del modelo. | vehiclemodel:eq:Toyota Camry |
vehiclemodel:in:{models} | Combina uno o más modelos. | vehiclemodel:in:Toyota Camry | Honda Accord |
Clasificación
Utilice el parámetro de consulta sort junto con los filtros:
| Valor | Descripción |
|---|
distance | Ordenar por proximidad a las coordenadas de búsqueda (el más cercano primero). |
price | Ordenar por precio total (el más bajo primero). |
GET /cars/api/v2/rentals?...&sort=price&filter=vehicle_type:in:SUV
Paginación con filtros
Los filtros funcionan perfectamente con la paginación. Los parámetros page y limit se aplican después de los filtros:
GET /cars/api/v2/rentals?...&filter=price:lte:100&sort=price&page=1&limit=10
Ejemplo completo
Busca SUV automáticos de al menos 5 plazas por menos de 200$/día, ordenados por precio:
HTTP
GET /cars/api/v2/rentals?country=US&pickupdate=2026-06-15T10:00:00&returndate=2026-06-20T10:00:00&pickuptype=geo&returntype=geo&pickupcode=40.7128,-74.006&returncode=40.7128,-74.006¤cy=USD&sort=price&filter=vehicletype:in:SUV,transmissiontype:eq:Automatic,passenger_quantity:gte:5,price:lte:200
x-api-key: YOURAPIKEY
x-correlation-id: 550e8400-e29b-41d4-a716-446655440000
Authorization: Bearer YOUR_SIGNATURE
Consejos
- Empiece de forma amplia y luego restringida. Ejecute una búsqueda inicial sin filtros para ver qué hay disponible y luego aplique filtros para refinar los resultados.
- Combine clasificación con filtros para la mejor experiencia de usuario. Por ejemplo, filtre por
vehicle_type:in:SUV y ordene por price. - Utilice
gte para campos de capacidad en lugar de eq cuando el usuario necesite "al menos" una determinada cantidad de asientos o maletas. - Los valores de filtro distinguen entre mayúsculas y minúsculas. Utilice las mayúsculas y minúsculas exactas que se muestran en las tablas anteriores (por ejemplo,
Manual, no manual).