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

توفّر 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.

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