پیدا کردن سفرها
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
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 بهدرستی بهروز شده است.
تاریخ آخرین بهروزرسانی 2026-10-11 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2026-10-11 بهوقت ساعت هماهنگ جهانی."],[],["The `SearchTripsRequest` endpoint in Fleet Engine allows finding trips, focusing on two scenarios. First, setting `vehicle_id` and `active_trips_only` to `true` identifies active trips for a specific vehicle. Second, to reconcile vehicle availability, `vehicle_id` is left empty, `active_trips_only` is `true`, and `minimum_staleness` is set to over an hour. This identifies open, outdated trips (neither `COMPLETE` nor `CANCELED`) for status reconciliation. Trips are only searchable for seven days.\n"]]