차량 검색

모빌리티 주문형 이동 서비스의 일환으로 SearchVehicles 메서드를 사용하여 주변 차량을 찾을 수 있습니다.

SearchVehicles 메서드를 사용하면 특정 차량 공유 또는 배달에 가장 적합한 소비자 모바일 앱을 요청을 수행합니다. SearchVehicles API는 속성이 요청된 이동 속성과 일치하는 차량의 순위가 지정된 목록을 반환합니다. 순위는 도착 예정 시간, 거리 또는 수령 지점과의 직선 거리 중에서 선택한 항목에 따라 정해집니다.

SearchVehicles 메서드 사용

SearchVehicles를 사용하려면 다음과 같은 일반적인 절차를 따르세요.

1. 할당할 경로를 기반으로 SearchVehiclesRequest를 구성합니다.
2. 다음을 사용하여 SearchVehicles API (vehicleService.searchVehicles)를 호출합니다. 생성할 수 있습니다.
3. API에서 반환된 SearchVehicleResponse를 처리합니다.

SearchVehiclesRequest 필드

다음 필수 속성 필드를 사용하여 SearchVehiclesRequest:

SearchVehicleRequest 필드의 전체 세트는 참조 문서를 참고하세요.

SearchVehiclesRequest 시나리오

이 섹션에서는 SearchVehiclesRequest를 구성하는 방법의 예를 보여줍니다.

예를 들어 고객이 RestaurantX에서 픽업을 원한다고 가정해 보겠습니다. 그리고 네 대의 차량이 있습니다.

• 차량 1: RestaurantX에서 3,500m 거리.
• 차량 2: RestaurantX에서 100m 떨어져 있으며 A와 B 위치에서 승차 및 하차가 있는 활성 이동 중입니다.
• 차량 3: RestaurantX에서 200m 떨어져 있으며, 한 건의 배송만 남아 있고 배송 위치가 매우 멀리 있습니다.
• 차량 4: RestaurantX에서 1,000m 떨어진 거리에 있습니다.

다음은 반환하는 차량의 다양한 요청을 표시합니다.

     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 항목의 목록으로 구성됩니다. SearchVehiclesRequest에 지정된 order_by 속성으로 배송됩니다. 각 VehicleMatch 항목에는 다음과 같은 필드가 있습니다.

VehicleMatch 필드의 전체 목록은 다음을 참조하세요.

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

필터 쿼리 사용

SearchVehicles 및 ListVehicles는 필터 쿼리를 사용하여 차량 속성에 대한 필터링을 지원합니다.

필터 쿼리는 차량의 맞춤 속성에 대한 필터링만 지원하며 다른 필드에는 사용할 수 없습니다. minimum_capacity 또는 vehicle_types와 같은 다른 필드 기준이 포함된 검색에 사용되는 경우 필터 쿼리는 AND 절로 작동합니다.

예를 들어 좌석 수가 6명 이상인 차량을 검색하고 반려동물 동반 가능과 같은 attributes를 필터링하면 반려동물 동반 가능하고 6명 이상 탑승 가능한 차량만 기준에 따라 반환됩니다.

필터 쿼리 구문은 AIP-160을 참고하세요. 를 참조하세요. 차량 속성을 만드는 방법에 대한 자세한 내용은 차량을 참고하세요. 차량 필드 업데이트 가이드의 속성 필드를 참고하세요.

SearchVehicles 예시

다음 예는 다음을 사용하여 SearchVehicles API를 사용하는 방법을 보여줍니다. 자바 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.

다음 단계

• 주문형 경로 만들기