Cómo buscar ubicaciones de recogida
Antes de buscar autos de alquiler disponibles, necesita coordenadas geográficas para los lugares de recogida y devolución. El punto final de Autocompletar permite a los usuarios buscar por ciudad o nombre de aeropuerto y devuelve ubicaciones coincidentes con las coordenadas requeridas por el punto final de búsqueda.
Punto final
GET /cars/api/v2/autocomplete?key={search_term}
Parámetros de solicitud
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
key | cadena | Sí | Nombre parcial o completo de una ciudad o aeropuerto. |
key admite coincidencias parciales, por lo que los resultados aparecerán a medida que el usuario escriba. Por ejemplo, key=new yo devolverá resultados para ubicaciones del área de Nueva York.
Solicitud de ejemplo
HTTP
GET /cars/api/v2/autocomplete?key=new yo
x-api-key: YOURAPIKEY
x-correlation-id: 550e8400-e29b-41d4-a716-446655440000
Authorization: Bearer YOUR_SIGNATURE
Ejemplo de respuesta
JSON
{
"message": "success",
"data": [
{
"id": "1001",
"name": "John F. Kennedy International Airport",
"city_name": "New York",
"country_name": "United States",
"iata_code": "JFK",
"type": "airport",
"coordinates": {
"lat": 40.6413,
"lon": -73.7781
},
"region_id": "us-east"
},
{
"id": "1002",
"name": "New York City",
"city_name": "New York",
"country_name": "United States",
"iata_code": null,
"type": "city",
"coordinates": {
"lat": 40.7128,
"lon": -74.006
},
"region_id": "us-east"
},
{
"id": "1003",
"name": "LaGuardia Airport",
"city_name": "New York",
"country_name": "United States",
"iata_code": "LGA",
"type": "airport",
"coordinates": {
"lat": 40.7772,
"lon": -73.8726
},
"region_id": "us-east"
}
]
}Campos de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
id | cadena | Identificador único de la ubicación. |
name | cadena | Nombre completo del aeropuerto o ciudad. |
cityname | cadena | Ciudad donde se encuentra la ubicación. |
countryname | cadena | Nombre del país. |
iatacode | cadena | Código de aeropuerto IATA. Presente para resultados de aeropuertos, null para ciudades. |
type | cadena | Ya sea "airport" o "city". |
coordinates | objeto | Contiene lat (latitud) y lon (longitud). |
regionid | cadena | Identificador de región interna. |
Resultados de ciudad versus aeropuerto
El campo type distingue entre dos tipos de resultados:
"airport"— Una ubicación de aeropuerto específica. Estos resultados incluyen uniata_codey corresponden a mostradores de alquiler en el aeropuerto. Utilice las coordenadas del aeropuerto cuando el viajero recoja directamente en la terminal."city"— Una ubicación general de la ciudad. Las coordenadas representan el centro de la ciudad. Utilice las coordenadas de la ciudad cuando el viajero quiera buscar ubicaciones de alquiler cerca de un área de la ciudad, que pueden incluir sucursales fuera del aeropuerto.
Uso de coordenadas en el punto final de búsqueda
Los valores lat y lon de la respuesta de autocompletar se asignan directamente a los parámetros pickupcode y returncode en el extremo de búsqueda de alquileres:
GET /cars/api/v2/rentals?pickuptype=geo&pickupcode=40.7128,-74.006&returntype=geo&returncode=40.7128,-74.006&...
Las coordenadas se pasan como un par lat,lon separados por comas.
Mejores prácticas
- Activa la función de autocompletar después de 2 o 3 caracteres para reducir las llamadas API innecesarias y al mismo tiempo brindar sugerencias relevantes.
- Muestre el campo
typeen su interfaz de usuario para que los usuarios puedan distinguir entre los resultados del aeropuerto y de la ciudad (por ejemplo, con un ícono de avión para los aeropuertos). - Guarde las coordenadas seleccionadas: las necesitará para la solicitud de búsqueda en el siguiente paso.
- Permitir diferentes ubicaciones de recogida y devolución ejecutando dos consultas de autocompletar independientes y pasando diferentes coordenadas para
pickupcodeyreturncode.