Szukaj pojazdów

W ramach usługi przewozów na żądanie możesz znajdować pojazdy w pobliżu za pomocą metody SearchVehicles.

Metoda SearchVehicles umożliwia znajdowanie dostępnych pojazdów w pobliżu 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 czasu przyjazdu, odległości lub odległości w linii prostej od miejsca odbioru.

Korzystanie z metody SearchVehicles

Aby użyć metody SearchVehicles:

1. Utwórz SearchVehiclesRequest na podstawie podróży, która ma zostać przypisana.
2. Wywołaj interfejs SearchVehicles API (vehicleService.searchVehicles) z utworzonym żądaniem.
3. Przetwórz odpowiedź 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 referencyjnej.

Scenariusze SearchVehiclesRequest

W tej sekcji znajdziesz przykłady tworzenia SearchVehiclesRequest.

Załóżmy na przykład, że klient chce zostać odebrany z restauracji X, a Ty masz 4 pojazdy:

• Pojazd 1: 3500 m od restauracji X.
• Pojazd 2: 100 m od restauracji X, który realizuje aktywną podróż z odbiorem i wysiadką w lokalizacjach A i B.
• Pojazd 3: 200 m od restauracji X, który ma jeszcze jedną wysiadkę w bardzo odległym miejscu.
• Pojazd 4: 1000 m od restauracji X.

Poniżej znajdziesz różne żądania według zwracanego pojazdu.

     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 encji VehicleMatch uporządkowanych według atrybutu order_by określonego w SearchVehiclesRequest. Każda encja VehicleMatch ma te pola:

Pełną listę pól VehicleMatch znajdziesz tutaj:

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

Korzystanie z zapytań filtra

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

Zapytania filtra obsługują TYLKO filtrowanie według atrybutów niestandardowych pojazdów i nie można ich używać w przypadku innych pól. Gdy są używane w wyszukiwaniu, które obejmuje inne kryteria pola, takie jak minimum_capacity lub vehicle_types, zapytanie filtra działa jako klauzula AND.

Jeśli na przykład wyszukujesz pojazd o minimalnej pojemności 6 osób i filtrujesz attributes (np. pet-friendly), kryteria zwrócą tylko te pojazdy, które są przyjazne zwierzętom i mogą przewieźć co najmniej 6 pasażerów.

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

Ten przykład pokazuje, jak używać interfejsu SearchVehicles API za pomocą biblioteki gRPC Java. Pełną listę obsługiwanych języków znajdziesz w artykule Biblioteki klienta usług przewozó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