Pesquisar veículos

Como parte do serviço de viagens sob demanda de mobilidade, é possível encontrar veículos por perto usando o método SearchVehicles.

O método SearchVehicles permite encontrar veículos por perto disponíveis no seu aplicativos para dispositivos móveis para consumidores mais adequados para uma viagem ou entrega específica. solicitação. A API SearchVehicles retorna uma lista de classificação de veículos com atributos correspondem aos atributos de viagem solicitados. A classificação é ordenada pelo seu escolha de HEC, distância ou distância em linha reta a partir do ponto de embarque.

Pesquisar atributos	Atributos do veículo
Locais de embarque e desembarque Tipos de veículo e viagem solicitados Capacidade exigida Outros atributos de correspondência obrigatórios	a última localização conhecida de um veículo O estado, o tipo ou a capacidade do veículo Outros atributos personalizados

Observação: você precisa ter o papel de administrador sob demanda ou usuário do SDK do consumidor do Fleet Engine para usar a API SearchVehicles. Para mais informações, consulte Papéis da conta de serviço do Fleet Engine.

Usar o método SearchVehicles

Para usar SearchVehicles, siga este processo geral:

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

Campos SearchVehiclesRequest

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

Campo	Descrição
primária	Obrigatório. Precisa estar no formato provedores/{provider}. O provedor precisa ser o ID do projeto do Google Cloud de que a conta de serviço que está fazendo a chamada faz parte.
vehicle_types	Obrigatório. Tipos de veículos solicitados: AUTO, TWO_WHEELER, TAXI, TRUCK, BICYCLE ou PEDESTRIAN.
trip_types	Obrigatório. EXCLUSIVE (uma viagem ativa por vez por motorista) ou SHARED (uma ou várias viagens por vez por motorista).
minimum_capacity	Obrigatório. A capacidade mínima restante do veículo para uma nova viagem, seja para passageiros ou entregas.
pickup_point	Obrigatório. O local de embarque da viagem em coordenadas de latitude/longitude.
dropoff_point	Opcional. O local de desembarque da viagem em coordenadas de latitude/longitude. O campo é obrigatório se trip_types contiver TripType.SHARED.
pickup_radius_meters	Obrigatório. O raio em metros da área de pesquisa do veículo a partir do ponto de embarque.
order_by	Obrigatório. Ordene os veículos de uma das seguintes maneiras: PICKUP_POINT_ETA, HEC do veículo no ponto de embarque. PICKUP_POINT_DISTANCE, a distância entre o veículo e o ponto de embarque. DROPOFF_POINT_ETA, HEC do veículo para concluir a viagem no ponto de desembarque. PICKUP_POINT_STRAIGHT_DISTANCE, a distância em linha reta (não no trajeto) entre o veículo e o ponto de embarque.
contagem	Obrigatório. O número máximo de veículos para retornar, de 1 a 50.
Filtro	Opcional. Uma consulta de filtro para aplicar ao pesquisar veículos.

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

Cenários de SearchVehiclesRequest

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

Por exemplo, suponha que um cliente queira ser retirado no RestaurantX, e quatro veículos:

• Veículo 1: a 3.500 m do RestaurantX.
• Veículo 2: a 100 metros do RestaurantX com uma viagem ativa com embarque e desembarque nos locais A e B.
• Veículo 3: a 200 m do RestaurantX, com um desembarque restante longe.
• Veículo 4: a 1.000 m do RestaurantX.

Confira abaixo várias solicitações de acordo com o veículo retornado.

Devolve o veículo 4

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

Devolve os veículos 3 e 4

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

Devolve os veículos 2, 3 e 4

     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 A entidade VehicleMatch tem os seguintes campos:

Campo	Descrição
veículo	O objeto Vehicle, incluindo os atributos de ID do veículo e Vehicle.
vehicle_pickup_eta	HEC do veículo no local de embarque da nova viagem. Este é o HEC de dDriving.
vehicle_pickup_distance_meter	A distância em metros entre o veículo e o local de embarque da nova viagem.
vehicle_pickup_straight_line_distance_meter	A distância em linha reta em metros entre o veículo e o local de embarque da nova viagem.
vehicle_dropoff_eta	O carimbo de data/hora do HEC do veículo no local de embarque da nova viagem. O HEC é de dDriving.
vehicle_trips_waypoints	Uma lista de waypoints restantes, incluindo pontos de embarque e desembarque, das viagens ativas atualmente atribuídas ao veículo.
vehicle_match_type	O tipo de viagem do veículo (EXCLUSIVE, BACK_TO_BACK, CARPOOL ou CARPOOL_BACK_TO_BACK).

Para conferir uma lista completa dos campos VehicleMatch, consulte:

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

.

Observação :um veículo precisa estar on-line (comvehicle_state=ONLINE) para ser pesquisável e retornado por SearchVehicles.

Usar consultas com filtro

SearchVehicles e ListVehicles são compatíveis com a filtragem de atributos do veículo usando uma consulta de filtro.

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

Por exemplo, se você pesquisar um veículo que tenha uma capacidade mínima de 6 filtrar um attributes, por exemplo, se aceita animais de estimação, os critérios retornariam apenas aqueles veículos que permitem animais de estimação e podem transportar pelo menos seis passageiros.

Para conferir a sintaxe da consulta de filtro, acesse AIP-160. para ver exemplos. Para detalhes sobre a criação de atributos do veículo, consulte Veículo atributos no guia Atualizar campos do veículo.

Observação :como prática recomendada, evite usar os seguintes campos de atributo ao emitindo uma consulta de filtro: required_attributes, required_one_of_attributes ou required_one_of_attributes_sets. Em vez disso, use o campo filter, que substitui esses campos. Além disso, você receberá uma mensagem de erro se o solicitação especifique um valor no campo filter e no outro atributo campos.

Exemplo de SearchVehicles

O exemplo a seguir mostra como usar a API SearchVehicles com o biblioteca Java gRPC.

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

• Criar uma viagem sob demanda