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

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

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

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

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

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

Поля SearchVehiclesRequest

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

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

Сценарии использования SearchVehiclesRequest

В этом разделе приведены примеры того, как создать SearchVehiclesRequest.

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

• Автомобиль 1 находится в 3500 м от ресторана X.
• Автомобиль 2 находится в 100 м от ресторана X и выполняет активную поездку с посадкой и высадкой в пунктах А и Б.
• Автомобиль 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