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

كجزء من خدمة الرحلات حسب الطلب في Mobility on-demand، يمكنك العثور على المركبات القريبة باستخدام طريقة 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: على بُعد 1000 متر من "مطعم س"

تعرض القائمة التالية طلبات مختلفة حسب المركبة التي يتم عرضها.

     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.

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

• DeleteVehicle