Szukaj pojazdów

W ramach usługi przejazdów na żądanie możesz znaleźć pojazdy w pobliżu, korzystając z metody SearchVehicles.

Metoda SearchVehicles umożliwia znajdowanie dostępnych w pobliżu pojazdów w aplikacji mobilnej dla konsumentów, które najlepiej pasują do konkretnego przejazdu lub prośby o dostawę. Interfejs SearchVehicles API zwraca uporządkowaną listę pojazdów, których atrybuty pasują do atrybutów żądanej podróży. Kolejność jest określana na podstawie wybranego przez Ciebie kryterium: szacowanego czasu przyjazdu, odległości lub odległości w linii prostej od miejsca odbioru.

Użyj metody SearchVehicles

Aby korzystać z SearchVehicles, wykonaj te ogólne czynności:

1. Utwórz SearchVehiclesRequest na podstawie podróży, która ma zostać przypisana.
2. Wywołaj interfejs API SearchVehicles (vehicleService.searchVehicles) za pomocą utworzonego żądania.
3. Przetwórz wartość SearchVehicleResponse zwróconą przez interfejs API.

Pola SearchVehiclesRequest

Aby utworzyć SearchVehiclesRequest, użyj tych wymaganych pól atrybutów:

Pełny zestaw pól SearchVehicleRequest znajdziesz w dokumentacji.

Scenariusze SearchVehiclesRequest

W tej sekcji znajdziesz przykłady tworzenia SearchVehiclesRequest.

Załóżmy na przykład, że klient chce, aby go odebrano z restauracji X, a Ty masz 4 pojazdy:

• Pojazd 1: 3500 m od restauracji X.
• Pojazd 2: 100 m od restauracji X, aktywny przejazd z miejscem odbioru i docelowym w lokalizacjach A i B.
• Pojazd 3: 200 m od restauracji X, z 1 pozostałym miejscem dostawy bardzo daleko.
• Pojazd 4: 1000 m od Restauracji X.

Poniżej znajdziesz różne żądania według pojazdu, który je zwraca.

     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
    

Pola SearchVehiclesResponse

SearchVehiclesResponse składa się z listy VehicleMatch elementów, które są uporządkowane według atrybutu order_by określonego w SearchVehiclesRequest. Każdy obiekt VehicleMatch ma te pola:

Pełną listę pól VehicleMatch znajdziesz w tych artykułach:

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

Używanie zapytań filtra

SearchVehicles i ListVehicles obsługują filtrowanie atrybutów pojazdu za pomocą zapytania filtra.

Zapytania dotyczące filtrowania obsługują TYLKO filtrowanie według atrybutów niestandardowych pojazdów i nie można ich używać w przypadku innych pól. Jeśli jest używane w wyszukiwaniu, które zawiera inne kryteria pola, np. minimum_capacity lub vehicle_types, zapytanie filtra działa jak klauzula AND.

Jeśli na przykład wyszukasz pojazd o minimalnej pojemności 6 osób i zastosujesz filtr attributes, np. „przyjazny zwierzętom”, kryteria wyszukiwania zwrócą tylko te pojazdy, które są przyjazne zwierzętom i mogą przewozić co najmniej 6 pasażerów.

Przykłady składni zapytań filtra znajdziesz w AIP-160. Więcej informacji o tworzeniu atrybutów pojazdu znajdziesz w sekcji Pole atrybutów pojazdu w przewodniku Aktualizowanie pól pojazdu.

Przykład SearchVehicles

Poniższy przykład pokazuje, jak korzystać z interfejsu API SearchVehicles za pomocą biblioteki gRPC w języku Java. Pełną listę obsługiwanych języków znajdziesz w artykule Biblioteki klienta dla usług przejazdów na żądanie.

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.

Co dalej?

• DeleteVehicle