Buscar vehículos

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 disponibles cercanos en tu app para consumidores que sean más adecuados para un viaje específico o una solicitud de entrega. La API de SearchVehicles muestra 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 la hora de llegada estimada, la distancia o la distancia en línea recta desde el punto de partida.

Atributos de búsqueda Atributos del vehículo
  • Ubicaciones de partida y destino
  • Tipos de vehículos y viajes solicitados
  • Capacidad requerida
  • Otros atributos de coincidencia obligatorios
  • La última ubicación conocida de un vehículo
  • El estado, el tipo o la capacidad del vehículo
  • Otros atributos personalizados

Usa el método SearchVehicles

Para usar SearchVehicles, sigue este proceso general:

  1. Crea un SearchVehiclesRequest en función del viaje que se asignará.
  2. Llama a la API de SearchVehicles (vehicleService.searchVehicles) con la solicitud que se compiló.
  3. Procesa el SearchVehicleResponse que muestra la API.

Campos de SearchVehiclesRequest

Usa los siguientes campos de atributos obligatorios para crear un SearchVehiclesRequest:

Campo Descripción
elemento superior Obligatorio. Debe tener el formato providers/{provider}. El proveedor debe ser el ID del proyecto de Google Cloud del que es miembro la cuenta de servicio que realiza esta llamada.
vehicle_types Obligatorio. Son los tipos de vehículos solicitados, ya sea AUTO, TWO_WHEELER, TAXI, TRUCK, BICYCLE o PEDESTRIAN.
trip_types Obligatorio. EXCLUSIVO (un viaje activo a la vez por conductor) o COMPARTIDO (uno o varios viajes a la vez por conductor).
minimum_capacity Obligatorio. Es la capacidad mínima restante del vehículo para un viaje nuevo, ya sea de pasajeros o de entregas.
pickup_point Obligatorio. Es la ubicación de partida del viaje en coordenadas de latitud y longitud.
dropoff_point Opcional. La 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. Es el radio en metros del área de búsqueda del vehículo desde el punto de partida.
order_by Obligatorio. Ordena los vehículos según una de las siguientes opciones:
  • PICKUP_POINT_ETA, la hora de llegada estimada del vehículo al punto de partida.
  • PICKUP_POINT_DISTANCE, la distancia entre el vehículo y el punto de partida.
  • DROPOFF_POINT_ETA, la hora de llegada estimada (ETA) del vehículo para completar el viaje en el punto de destino
  • PICKUP_POINT_STRAIGHT_DISTANCE, la distancia en línea recta (no en ruta) entre el vehículo y el punto de partida.
count Obligatorio. Es la cantidad máxima de vehículos que se mostrarán, de 1 a 50.
Filtro Opcional. Es una consulta de filtro que se aplica cuando se buscan vehículos.

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 el Restaurante X y tienes cuatro vehículos:

  • Vehículo 1: A 3,500 m de RestaurantX.
  • Vehículo 2: A 100 m del restaurante X, con un viaje activo con partida y destino en las ubicaciones A y B.
  • Vehículo 3: A 200 m de RestaurantX, con un viaje restante muy lejos.
  • Vehículo 4: A 1,000 m de RestaurantX.

A continuación, se muestran varias solicitudes según el vehículo que devuelven.

Muestra el vehículo 4.

     Pickup at RestaurantX, radius = 1200m, order by PICKUP_POINT_ETA

Muestra los vehículos 3 y 4.

     Pickup at RestaurantX, radius = 1200m, order by PICKUP_POINT_ETA, is_back_to_back enabled

Muestra los vehículos 2, 3 y 4.

     Pickup at RestaurantX, radius = 1200m, order by PICKUP_POINT_ETA, current_trips_present = ALL

Campos de SearchVehiclesResponse

Una SearchVehiclesResponse consiste en una lista de entidades VehicleMatch, clasificadas según el atributo order_by especificado en SearchVehiclesRequest. Cada entidad VehicleMatch tiene los siguientes campos:

Campo Descripción
vehículo El objeto Vehicle, incluidos los atributos vehicle_id y Vehicle
vehicle_pickup_eta La hora de llegada estimada del vehículo a la ubicación de partida del viaje nuevo Esta es la hora de llegada estimada conduciendo.
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 línea recta en metros entre el vehículo y la ubicación de partida del viaje nuevo.
vehicle_dropoff_eta La marca de tiempo de la hora de llegada estimada del vehículo a la ubicación de partida del viaje nuevo Ten en cuenta que la hora de llegada estimada es la hora de llegada estimada en automóvil.
vehicle_trips_waypoints Es una lista de los puntos de referencia restantes, incluidos los puntos de partida y destino, de los viajes activos asignados actualmente al vehículo.
vehicle_match_type Es el tipo de viaje del vehículo, ya sea EXCLUSIVE, BACK_TO_BACK, CARPOOL o CARPOOL_BACK_TO_BACK.

Para obtener una lista completa de los campos VehicleMatch, consulta lo siguiente:

Usa consultas de filtro

SearchVehicles y ListVehicles admiten el filtrado de atributos de vehículos con una búsqueda de filtro.

Las consultas de filtro SOLO admiten el filtrado de 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 que tenga una capacidad mínima de 6 y filtres un attributes, como apto para mascotas, tus criterios solo mostrarán aquellos vehículos que sean aptos para mascotas y que puedan transportar al menos 6 pasajeros.

Para ver ejemplos de la sintaxis de la consulta de filtro, consulta AIP-160. Para obtener detalles sobre cómo crear atributos de vehículos, consulta el Campo de atributos de vehículos en la guía Actualiza los campos de vehículos.

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.

¿Qué sigue?