Fleet Engine מספק את נקודת הקצה SearchTripsRequest שאפשר להשתמש בה כדי למצוא נסיעות. במסמך הזה מתוארים שני תרחישים שבהם כדאי להשתמש בתכונה הזו.
gRPC: SearchTripsRequest. ב-REST: trips.Search.
איך בודקים אילו נסיעות פעילות ברכב
כדי למצוא את הנסיעות הפעילות בשדות ספציפיים, משתמשים בהודעה 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 עודכן כראוי.