Szukaj pojazdów

W ramach usługi podróży 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ć SearchVehicles, wykonaj te ogólne czynności:

1. Utwórz SearchVehiclesRequest na podstawie podróży, która ma zostać przypisana.
2. Wywołaj interfejs SearchVehicles API (vehicleService.searchVehicles) za pomocą utworzonego żądania.
3. Przetwórz SearchVehicleResponse zwrócony 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 1 miejsce wysiadki w dużej odległości.
• 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 w tych dokumentach:

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

Korzystanie z zapytań filtra

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 pól, 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 Java gRPC. Pełną listę obsługiwanych języków znajdziesz w sekcji Biblioteki klienta usług podróży 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