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

В рамках услуги «Мобильность по требованию» вы можете найти ближайшие транспортные средства с помощью метода SearchVehicles .

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

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

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

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

Поиск транспортных средствПоля запроса

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

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

Поиск транспортаСценарии запроса

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

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

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

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

     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

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

Синтаксис запроса фильтра см. в разделе AIP-160 . Подробную информацию о создании атрибутов автомобиля см. в разделе Поле «Атрибуты автомобиля» в руководстве «Обновление полей автомобиля» .

Пример поиска транспортных средств

В следующем примере показано, как использовать API SearchVehicles с помощью библиотеки Java gRPC .

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.

Что дальше

• Создайте поездку по запросу