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

كجزء من خدمة الرحلات عند الطلب في Mobility، يمكنك العثور على المركبات القريبة باستخدام طريقة 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، ولديها رحلة نشطة مع استلام وتوصيل في الموقعَين 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 مثل pet-friendly، لن تعرض المعايير سوى المركبات التي تسمح باصطحاب الحيوانات الأليفة والتي يمكنها استيعاب 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