البحث عن مركبات

كجزء من خدمة الرحلات عند الطلب للتنقل، يمكنك العثور على المركبات القريبة باستخدام الطريقة SearchVehicles.

تتيح لك طريقة SearchVehicles العثور على المركبات القريبة المتاحة في سيارتك تطبيق للأجهزة الجوّالة للمستهلكين يكون الأنسب لرحلة محدّدة أو توصيل طلبك. تعرض واجهة برمجة التطبيقات SearchVehicles قائمة مرتّبة من المركبات التي تطابق سمات الرحلة المطلوبة يتم ترتيب الترتيب حسب الاختيار بين الوقت المقدّر للوصول أو المسافة أو الخط المستقيم من نقطة الاستلام.

استخدام الطريقة SearchVehicles

لاستخدام SearchVehicles، يُرجى اتّباع العملية العامة التالية:

1. يمكنك إنشاء SearchVehiclesRequest استنادًا إلى الرحلة المطلوب إسنادها.
2. يمكنك طلب واجهة برمجة التطبيقات SearchVehicles (vehicleService.searchVehicles) باستخدام تم إنشاؤه.
3. معالجة SearchVehicleResponse التي تم عرضها من واجهة برمجة التطبيقات

حقول SearchVehiclesRequest

استخدِم حقول السمات المطلوبة التالية لإنشاء SearchVehiclesRequest:

يُرجى مراجعة المستندات المرجعية للاطّلاع على المجموعة الكاملة SearchVehicleRequest.

سيناريوهات طلب SearchVehiclesRequest

يعرض هذا القسم أمثلة حول كيفية إنشاء SearchVehiclesRequest.

على سبيل المثال، لنفترض أن هناك عميلًا يريد أن يتم توصيله من RestaurantX، ولديك أربع مركبات:

• المركبة 1: على بُعد 3500 متر من مطعم RestaurantX.
• المركبة 2: على بُعد 100 متر من مطعم RestaurantX مع رحلة نشطة مع خدمة استلام الطلب واذهب إلى الموقعين "أ" و"ب".
• المركبة 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. للحصول على أمثلة. للحصول على تفاصيل حول إنشاء سمات المركبة، يُرجى الاطّلاع على القسم "المركبة". الخاصة بالسمات في دليل تعديل حقول المركبات.

مثال على SearchVehicles

يوضّح المثال التالي كيفية استخدام SearchVehicles API من خلال مكتبة 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.

الخطوات التالية

• إنشاء رحلة عند الطلب