Buscar vehículos

Como parte del servicio de viajes a pedido de Mobility, 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 del consumidor 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 de viaje solicitados. La clasificación se ordena según tu elección de hora estimada de llegada, distancia o distancia en línea recta desde el punto de partida.

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 creada.
3. Procesa la SearchVehicleResponse que muestra la API.

Campos de SearchVehiclesRequest

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

Consulta la documentación de referencia para ver el conjunto completo de SearchVehicleRequest.

Situaciones de SearchVehiclesRequest

En esta sección, se muestran ejemplos de cómo crear 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 un punto de partida y destino en las ubicaciones A y B
• Vehículo 3: A 200 m de RestaurantX con un destino restante muy lejos
• Vehículo 4: A 1,000 m de RestaurantX

A continuación, se muestran varias solicitudes por el vehículo que muestran.

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

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

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

Campos de SearchVehiclesResponse

Un SearchVehiclesResponse consta de una lista de entidades VehicleMatch, clasificadas por el atributo order_by especificado en el SearchVehiclesRequest. Cada entidad VehicleMatch tiene los siguientes campos:

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

• VehicleMatch message (gRPC)
• VehicleMatch resource (REST)

Usa consultas de filtro

SearchVehicles y ListVehicles admiten el filtrado de atributos de vehículos con una consulta 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 filtras un attributes como apto para mascotas, tus criterios solo mostrarán aquellos vehículos que sean aptos para mascotas y puedan transportar al menos 6 pasajeros.

Para obtener la sintaxis de las consultas de filtro, consulta AIP-160 para ver ejemplos. Para obtener detalles sobre la creación de 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 gRPC de Java. Para obtener una lista completa de los idiomas compatibles, consulta Bibliotecas cliente para servicios de viajes a pedido.

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?

• DeleteVehicle