כדי למצוא את הנסיעות הפעילות בשדות ספציפיים, משתמשים בהודעה 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 עודכן כראוי.
[[["התוכן קל להבנה","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"]],["עדכון אחרון: 2025-02-28 (שעון UTC)."],[[["Fleet Engine's `SearchTripsRequest` helps find trips, useful for identifying active trips and reconciling vehicle availability."],["Use `SearchTripsRequest` with `vehicle_id` and `active_trips_only` to find a specific vehicle's active trips."],["Discrepancies between your system and Fleet Engine's vehicle availability can be addressed by using `SearchTripsRequest` to identify open trips and ensure trip statuses are synchronized."],["Trips older than 7 days are automatically deleted in Fleet Engine."]]],["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"]]
