Fleet Engine מספק את נקודת הקצה (endpoint) 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
message:
- השדה
vehicle_idצריך להיות ריק. active_trips_onlyצריך להיותtrue.- משך הזמן של
minimum_stalenessצריך להיות ארוך יותר מרוב משך הנסיעה. עבור למשל, שעה אחת.
התוצאות של הבקשה הזו כוללות נסיעות שהן לא COMPLETE וגם לא
CANCELED, ולא עודכנו במשך יותר משעה. לאחר מכן תוכלו לבדוק
הנסיעות האלה כדי לוודא שהסטטוס שלהן ב-Fleet Engine מעודכן כמו שצריך.