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 מתעדכן בצורה תקינה.