موتور ناوگان، نقطه پایانی SearchTripsRequest را ارائه می‌دهد که می‌توانید برای یافتن سفرها از آن استفاده کنید. این سند دو سناریو را شرح می‌دهد که در آنها می‌توانید از این ویژگی استفاده کنید.
برای gRPC یا trips.Search به SearchTripsRequest مراجعه کنید. REST را جستجو کنید.
تعیین سفرهای فعال برای یک وسیله نقلیه
برای یافتن سفرهای فعال برای یک فیلد خاص، از پیام SearchTripsRequest برای تنظیم vehicle_id به وسیله نقلیه مورد نظر و تنظیم active_trips_only به true استفاده کنید.
تطبیق در دسترس بودن خودرو بین سیستم شما و موتور ناوگان
در برخی شرایط، ممکن است نتایجی را مشاهده کنید که توسط SearchVehicles برگردانده می‌شود و با خودروهایی که می‌دانید در سیستم و ناوگان شما موجود هستند، مطابقت ندارد. این اتفاق می‌افتد زیرا SearchVehicles یا خودروهایی با سفرهای فعال را نشان نمی‌دهد، یا آنها را در رتبه‌بندی نتایج پایین می‌آورد. یکی از دلایل این امر زمانی است که خودروها سفرهای خود را انجام داده‌اند، اما وضعیت سفر به درستی روی COMPLETE یا CANCELED تنظیم نشده است. با استفاده از SearchTrips برای یافتن سفرهای باز، می‌توانید خودروها را ارزیابی کنید تا مطمئن شوید که TripStatus در سیستم شما با Fleet Engine مطابقت دارد.
برای استفاده از SearchTrips به این روش، موارد زیر را در پیام SearchTripsRequest تنظیم کنید:
-
vehicle_idباید خالی باشد. -
active_trips_onlyبایدtrueداشته باشد. -
minimum_stalenessباید زمانی بیشتر از اکثر مدت زمان‌های سفر باشد؛ مثلاً یک ساعت.
نتایج چنین درخواستی شامل سفرهایی است که نه COMPLETE هستند و نه CANCELED و بیش از یک ساعت است که به‌روزرسانی نشده‌اند. سپس می‌توانید این سفرها را بررسی کنید تا مطمئن شوید که وضعیت آنها در Fleet Engine به درستی به‌روزرسانی شده است.