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