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