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

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

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

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

لاستخدام SearchVehicles، اتّبِع العملية العامة التالية:

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

حقول SearchVehiclesRequest

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

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

سيناريوهات SearchVehiclesRequest

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

على سبيل المثال، لنفترض أنّ أحد العملاء يريد أن يتم استلامه من مطعم "أ"، ولديك أربع مركبات:

• المركبة 1: على بُعد 3500 متر من مطعم "س"
• المركبة 2: على بُعد 100 متر من مطعم "س"، وهي في رحلة نشِطة تشمل عملية نقل وإرجاع في الموقعَين "أ" و"ب".
• المركبة 3: على بُعد 200 متر من مطعم "س"، وتتوفّر عملية تسليم واحدة متبقّية في مكان بعيد جدًا.
• المركبة 4: على بُعد 1,000 متر من مطعم "س"

يعرض الجدول التالي طلبات مختلفة حسب المركبة التي تعرضها.

     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 باستخدام مكتبة 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.

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

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