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

يوفّر Fleet Engine نقطة نهاية SearchTripsRequest التي يمكنك استخدامها للعثور على الرحلات. يوضّح هذا المستند سيناريوهَين قد تستخدم فيهما هذه الميزة.

يُرجى الاطّلاع على SearchTripsRequest لمعرفة كيفية استخدام gRPC أو trips.Search لمعرفة كيفية استخدام REST.

تحديد الرحلات النشطة لمركبة

للعثور على الرحلات النشطة في حقول معيّنة، استخدِم SearchTripsRequest الرسالة لضبط vehicle_id على المركبة المعنيّة وضبط active_trips_only على true.

مواءمة مدى توفّر المركبات بين نظامك وFleet Engine

في بعض الحالات، قد تظهر لك نتائج يعرضها SearchVehicles لا تتطابق مع المركبات التي تعرف أنّها متوفّرة في نظامك ووحدتك. يحدث ذلك لأنّ SearchVehicles لا يعرض المركبات التي لديها رحلات نشطة أو ينقلها إلى أسفل ترتيب النتائج. ويعود سبب ذلك إلى أنّ المركبات قد أكملت الرحلات، ولكن لم يتم ضبط حالة الرحلة بشكلٍ سليم على COMPLETE أو CANCELED. باستخدام SearchTrips للعثور على الرحلات المفتوحة، يمكنك تقييم المركبات للتأكّد من أنّ TripStatus في نظامك مطابق لتلك الواردة في Fleet Engine.

لاستخدام SearchTrips بهذه الطريقة، عليك ضبط ما يلي في SearchTripsRequest الرسالة:

  • يجب أن يكون الحقل vehicle_id فارغًا.
  • يجب أن يكون active_trips_only هو true.
  • يجب أن يكون minimum_staleness وقتًا أطول من معظم مدد الرحلات، مثلاً، ساعة واحدة.

تشمل نتائج هذا الطلب الرحلات التي لم يتم COMPLETE أو CANCELED، ولم يتم تعديلها منذ أكثر من ساعة. يمكنك بعد ذلك فحص هذه الرحلات للتأكّد من تعديل حالتها في Fleet Engine بشكل صحيح.

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