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 به درستی به روز شده است.