Поиск автомобилей

В рамках сервиса поездок по запросу вы можете находить транспортные средства поблизости с помощью метода SearchVehicles.

Метод SearchVehicles позволяет находить в мобильном приложении для клиентов доступные поблизости транспортные средства, которые лучше всего подходят для выполнения определенного заказа на поездку или доставку. SearchVehicles API возвращает ранжированный список транспортных средств, атрибуты которых соответствуют атрибутам запрашиваемой поездки. Рейтинг упорядочивается по вашему выбору: по расчетному времени прибытия, расстоянию или расстоянию по прямой от пункта посадки.

Используйте метод SearchVehicles

Чтобы использовать SearchVehicles, выполните следующие действия:

1. Создайте объект SearchVehiclesRequest на основе поездки, которую нужно назначить.
2. Вызовите API SearchVehicles (vehicleService.searchVehicles) с помощью созданного запроса.
3. Обработайте SearchVehicleResponse, возвращенный API.

Поля SearchVehiclesRequest

Чтобы создать SearchVehiclesRequest, используйте следующие обязательные атрибуты:

Полный набор полей SearchVehicleRequest приведен в справочной документации.

Сценарии SearchVehiclesRequest

В этом разделе приведены примеры создания SearchVehiclesRequest.

Например, клиент хочет, чтобы его забрали из ресторана X, а у вас есть четыре автомобиля:

• Транспортное средство 1 находится в 3500 м от ресторана X.
• Транспортное средство 2 находится в 100 м от ресторана X и выполняет активную поездку с посадкой и высадкой в пунктах A и B.
• Транспортное средство 3 находится в 200 м от ресторана X, и ему осталось доставить один заказ, но очень далеко.
• Автомобиль 4 находится в 1000 м от ресторана X.

Ниже показаны различные запросы и возвращаемые ими транспортные средства.

     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
    

Поля SearchVehiclesResponse

SearchVehiclesResponse состоит из списка объектов VehicleMatch, упорядоченных по атрибуту order_by, указанному в SearchVehiclesRequest. Каждый объект VehicleMatch содержит следующие поля:

Полный список полей VehicleMatch можно найти в следующих статьях:

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

Как использовать запросы для фильтрации

SearchVehicles и ListVehicles поддерживают фильтрацию по атрибутам транспортных средств с помощью запроса фильтра.

Фильтрация запросов поддерживается ТОЛЬКО для настраиваемых атрибутов транспортных средств и не может использоваться для других полей. Если в поисковом запросе есть другие критерии, например minimum_capacity или vehicle_types, то фильтр работает как условие AND.

Например, если вы ищете автомобиль, вмещающий не менее шести человек, и выбираете фильтр attributes, например "Можно с животными", в результатах поиска будут показаны только те автомобили, которые соответствуют обоим критериям.

Примеры синтаксиса запросов фильтрации приведены в AIP-160. Подробную информацию о создании атрибутов транспортных средств можно найти в разделе Поле атрибутов транспортного средства руководства Обновление полей транспортного средства.

Пример SearchVehicles

В примере ниже показано, как использовать SearchVehicles API с помощью библиотеки gRPC для Java. Полный список поддерживаемых языков можно найти в статье Клиентские библиотеки для сервисов поездок по запросу.

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.

Дальнейшие действия

• DeleteVehicle