Como parte del servicio de viajes de movilidad a pedido, puedes encontrar vehículos cercanos con el método SearchVehicles
.
El método SearchVehicles
te permite encontrar vehículos cercanos disponibles en tu app para dispositivos móviles de consumo que son más adecuados para un viaje específico o una solicitud de entrega. La API de SearchVehicles
devuelve una lista clasificada de vehículos cuyos atributos coinciden con los atributos del viaje solicitados. La clasificación se ordena según tu elección de ETA, distancia o distancia en línea recta desde el punto de partida.
Atributos de búsqueda | Atributos del vehículo |
---|---|
|
|
Usa el método SearchVehicles
Para usar SearchVehicles
, sigue este proceso general:
- Construye un objeto
SearchVehiclesRequest
basado en el viaje que se asignará. - Llama a la API de
SearchVehicles
(vehicleService.searchVehicles
) con la solicitud construida. - Procesa el
SearchVehicleResponse
que devuelve la API.
Campos de SearchVehiclesRequest
Usa los siguientes campos de atributos obligatorios para construir un SearchVehiclesRequest
:
Campo | Descripción |
---|---|
elemento superior | Obligatorio. Debe tener el formato providers/{proveedor}. El proveedor debe ser el ID del proyecto de Google Cloud del que la cuenta de servicio que realiza esta llamada es miembro. |
vehicle_types | Obligatorio. Tipos de vehículos solicitados, que pueden ser AUTO, TWO_WHEELER, TAXI, TRUCK, BICYCLE o PEDESTRIAN. |
trip_types | Obligatorio. Puede ser EXCLUSIVE (un viaje activo a la vez por conductor) o SHARED (uno o varios viajes a la vez por conductor). |
minimum_capacity | Obligatorio. Es la capacidad restante mínima del vehículo para un viaje nuevo, ya sea para pasajeros o entregas. |
pickup_point | Obligatorio. Ubicación de partida del viaje en coordenadas de latitud y longitud. |
dropoff_point | Opcional. Ubicación de destino del viaje en coordenadas de latitud y longitud. El campo es obligatorio si trip_types contiene TripType.SHARED. |
pickup_radius_meters | Obligatorio. Radio en metros del área de búsqueda de vehículos desde el punto de partida. |
order_by | Obligatorio. Ordena los vehículos según uno de los siguientes criterios:
|
count | Obligatorio. Es la cantidad máxima de vehículos que se devolverán, de 1 a 50. |
filtrar | Opcional. Es una consulta de filtro que se aplica cuando se buscan vehículos. |
maximum_staleness | Opcional. Restringe la búsqueda solo a los vehículos que enviaron actualizaciones de ubicación a Fleet Engine dentro del período especificado. Si no se establece este campo, el servidor usa cinco minutos como valor predeterminado. |
Consulta la documentación de referencia para ver el conjunto completo de campos de SearchVehicleRequest.
Situaciones de SearchVehiclesRequest
En esta sección, se muestran ejemplos de cómo construir un SearchVehiclesRequest
.
Por ejemplo, supongamos que un cliente quiere que lo recojan en RestaurantX y tienes cuatro vehículos:
- Vehículo 1: A 3,500 m de RestaurantX.
- Vehículo 2: A 100 m de RestaurantX con un viaje activo con retiro y entrega en las ubicaciones A y B.
- Vehículo 3: A 200 m de RestaurantX con una entrega restante muy lejos.
- Vehículo 4: A 1,000 m de RestaurantX.
A continuación, se muestran varias solicitudes por el vehículo que las devuelve.
Devuelve el vehículo 4
Pickup at RestaurantX, radius = 1200m, order by PICKUP_POINT_ETA
Devuelve los vehículos 3 y 4
Pickup at RestaurantX, radius = 1200m, order by PICKUP_POINT_ETA, is_back_to_back enabled
Devuelve los vehículos 2, 3 y 4
Pickup at RestaurantX, radius = 1200m, order by PICKUP_POINT_ETA, current_trips_present = ALL
Campos de SearchVehiclesResponse
Un SearchVehiclesResponse
consiste en una lista de entidades VehicleMatch
, clasificadas según el atributo order_by especificado en el SearchVehiclesRequest
. Cada entidad VehicleMatch
tiene los siguientes campos:
Campo | Descripción |
---|---|
vehículo | Objeto Vehicle , incluidos los atributos vehicle_id y Vehicle . |
vehicle_pickup_eta | Hora estimada de llegada del vehículo al punto de partida si este viaje se asignara al vehículo ahora mismo. |
vehicle_pickup_distance_meter | Es la distancia en metros entre el vehículo y la ubicación de partida del viaje nuevo. |
vehicle_pickup_straight_line_distance_meter | Es la distancia en metros en línea recta entre el vehículo y la ubicación de partida del viaje nuevo. |
vehicle_dropoff_eta | Hora estimada de llegada del vehículo al punto de destino si este viaje se asignara al vehículo ahora mismo. |
vehicle_trips_waypoints | Es una lista de los puntos de referencia restantes, incluidos los puntos de partida y destino, de los viajes activos que se asignaron al vehículo. |
vehicle_match_type | Es el tipo de viaje del vehículo, que puede ser EXCLUSIVE, BACK_TO_BACK, CARPOOL o CARPOOL_BACK_TO_BACK. |
Para obtener una lista completa de los campos de VehicleMatch
, consulta lo siguiente:
VehicleMatch message
(gRPC)VehicleMatch resource
(REST)
Usa consultas de filtro
SearchVehicles
y ListVehicles
admiten el filtrado según los atributos del vehículo con una consulta de filtro.
Las consultas de filtro SOLO admiten el filtrado en atributos personalizados para vehículos y no se pueden usar para otros campos. Cuando se usa en una búsqueda que incluye otros criterios de campo, como minimum_capacity
o vehicle_types
, la consulta de filtro funciona como una cláusula AND
.
Por ejemplo, si buscas un vehículo con una capacidad mínima de 6 personas y filtras un attributes
, como apto para mascotas, tus criterios solo mostrarán los vehículos que sean aptos para mascotas y puedan transportar al menos a 6 pasajeros.
Para ver la sintaxis de las consultas de filtro, consulta AIP-160 para ver ejemplos. Para obtener detalles sobre cómo crear atributos de vehículos, consulta el campo Atributos del vehículo en la guía Actualiza los campos del vehículo.
Ejemplo de SearchVehicles
En el siguiente ejemplo, se muestra cómo usar la API de SearchVehicles
con la biblioteca de gRPC de Java.
static final String PROJECT_ID = "project-id";
VehicleServiceBlockingStub vehicleService =
VehicleService.newBlockingStub(channel);
String parent = "providers/" + PROJECT_ID;
SearchVehiclesRequest searchVehiclesRequest = SearchVehiclesRequest.newBuilder()
.setParent(parent)
.setPickupPoint( // Grand Indonesia East Mall
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder().setLatitude(-6.195139).setLongitude(106.820826)))
.setDropoffPoint( // Balai Sidang Jkt Convention Center
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder().setLatitude(-6.213796).setLongitude(106.807195)))
.setPickupRadiusMeters(2000)
.setCount(10)
.setMinimumCapacity(2)
.addTripTypes(TripType.EXCLUSIVE)
.addVehicleTypes(VehicleType.newBuilder().setCategory(Category.AUTO).build())
.setCurrentTripsPresent(CurrentTripsPresent.ANY)
.setFilter("attributes.on_trip=\"false\"")
.setOrderBy(VehicleMatchOrder.PICKUP_POINT_ETA)
.build();
try {
SearchVehiclesResponse searchVehiclesResponse =
vehicleService.searchVehicles(searchVehiclesRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case NOT_FOUND:
break;
case PERMISSION_DENIED:
break;
}
return;
}
List<VehicleMatch> vehicleMatches =
searchVehicleResponse.getMatchesList();
// Each VehicleMatch contains a Vehicle entity and information about the
// distance and ETA to the pickup point and drop-off point.