Pesquisar veículos

Como parte do serviço de viagens sob demanda do Mobility, você pode encontrar veículos próximos usando o método SearchVehicles.

O método SearchVehicles permite encontrar veículos disponíveis nas proximidades no app para dispositivos móveis do consumidor que sejam mais adequados para uma viagem ou um pedido de entrega específico. A API SearchVehicles retorna uma lista classificada de veículos cujos atributos correspondem aos atributos de viagem solicitados. A classificação é ordenada pela sua escolha de tempo estimado de chegada, distância ou distância em linha reta do ponto de embarque.

Usar o método SearchVehicles

Para usar SearchVehicles, siga este processo geral:

1. Crie um SearchVehiclesRequest com base na viagem a ser atribuída.
2. Chame a API SearchVehicles (vehicleService.searchVehicles) com a solicitação criada.
3. Processe o SearchVehicleResponse retornado da API.

Campos SearchVehiclesRequest

Use os seguintes campos de atributos obrigatórios para criar um SearchVehiclesRequest:

Consulte a documentação de referência para conferir o conjunto completo de SearchVehicleRequest.

Cenários SearchVehiclesRequest

Esta seção mostra exemplos de como criar um SearchVehiclesRequest.

Por exemplo, suponha que um cliente queira ser buscado no RestauranteX e você tenha quatro veículos:

• Veículo 1: a 3.500 metros do RestauranteX.
• Veículo 2: a 100 metros do RestauranteX com uma viagem ativa com retirada e desembarque nos locais A e B.
• Veículo 3: a 200 metros do RestauranteX com um desembarque restante muito distante.
• Veículo 4: a 1.000 metros do RestauranteX.

A seguir, mostramos várias solicitações pelo veículo que elas retornam.

     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 SearchVehiclesResponse

Um SearchVehiclesResponse consiste em uma lista de entidades VehicleMatch, classificadas pelo atributo order_by especificado no SearchVehiclesRequest. Cada entidade VehicleMatch tem os seguintes campos:

Para conferir uma lista completa de campos VehicleMatch, consulte:

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

Usar consultas de filtro

SearchVehicles e ListVehicles oferecem suporte à filtragem de atributos de veículos usando uma consulta de filtro.

As consultas de filtro oferecem suporte APENAS à filtragem de atributos personalizados para veículos e não podem ser usadas para outros campos. Quando usadas em uma pesquisa que inclui outros critérios de campo, como minimum_capacity ou vehicle_types, a consulta de filtro funciona como uma cláusula AND.

Por exemplo, se você pesquisar um veículo com capacidade mínima de 6 e filtrar um attributes, como aceita animais de estimação, seus critérios vão retornar apenas os veículos que aceitam animais de estimação e podem transportar pelo menos 6 passageiros.

Para a sintaxe de consulta de filtro, consulte AIP-160 para exemplos. Para detalhes sobre como criar atributos de veículo, consulte o campo Atributos do veículo no guia Atualizar campos do veículo.

Exemplo de SearchVehicles

O exemplo a seguir mostra como usar a SearchVehicles API usando a biblioteca Java gRPC. Para conferir uma lista completa de idiomas com suporte, consulte Bibliotecas de cliente para serviços de viagens sob demanda.

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.

A seguir

• DeleteVehicle