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 עודכן כראוי.