חיפוש נסיעות

‫Fleet Engine מספק את נקודת הקצה 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:

  • השדה vehicle_id צריך להיות ריק.
  • הערך של active_trips_only צריך להיות true.
  • הערך של minimum_staleness צריך להיות זמן ארוך יותר מרוב משכי הנסיעות. לדוגמה, שעה אחת.

התוצאות של בקשה כזו כוללות נסיעות שהן לא COMPLETE ולא CANCELED, ושלא עודכנו במשך יותר משעה. לאחר מכן תוכלו לבדוק את הנסיעות האלה כדי לוודא שהסטטוס שלהן ב-Fleet Engine מתעדכן בצורה תקינה.

המאמרים הבאים