SearchVehiclesResponse

הודעת תגובה אחת (vehicles.search).

ייצוג JSON 
{
  "matches": [
    {
      object (VehicleMatch)
    }
  ]
}
שדות
matches[]

object (VehicleMatch)

רשימה של רכבים שתואמים לקריטריונים של SearchVehiclesRequest, מסודרים לפי השדה SearchVehiclesRequest.order_by.

VehicleMatch

מכילה את הרכב ואומדנים קשורים לרכב שתואמים לנקודות הנסיעות הפעילות ברכב SearchVehiclesRequest.

ייצוג JSON 
{
  "vehicle": {
    object (Vehicle)
  },
  "vehiclePickupEta": string,
  "vehiclePickupDistanceMeters": integer,
  "vehiclePickupStraightLineDistanceMeters": integer,
  "vehicleDropoffEta": string,
  "vehiclePickupToDropoffDistanceMeters": integer,
  "tripType": enum (TripType),
  "vehicleTripsWaypoints": [
    {
      object (Waypoint)
    }
  ],
  "vehicleMatchType": enum (VehicleMatchType),
  "requestedOrderedBy": enum (VehicleMatchOrder),
  "orderedBy": enum (VehicleMatchOrder)
}
שדות
vehicle

object (Vehicle)

חובה. רכב שתואם לבקשה.
vehiclePickupEta

string (Timestamp format)

זמן ההגעה המשוער של הרכב לנקודת האיסוף שצוינה בבקשה. ערך ריק מציין כישלון בחישוב זמן ההגעה המשוער של הרכב. אם הערך של SearchVehiclesRequest.include_back_to_back היה true וברכב הזה יש נסיעה פעילה, vehiclePickupEta כולל את הזמן שנדרש להשלמת הנסיעה הפעילה הנוכחית.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
vehiclePickupDistanceMeters

integer

המרחק מהמיקום הנוכחי של הרכב לנקודת האיסוף שציינתם בבקשה, כולל נקודות ביניים לאיסוף או הורדה לנסיעות קיימות. המרחק הזה כולל את מרחק הנסיעה המחושב (המסלול), וגם את מרחק הקו הישר בין נקודת הקצה של הניווט לבין נקודת האיסוף המבוקשת. (המרחק בין נקודת הסיום של הניווט לבין נקודת האיסוף המבוקשת הוא בדרך כלל קטן). ערך ריק מציין שגיאה בחישוב המרחק.
vehiclePickupStraightLineDistanceMeters

integer

חובה. המרחק הישר בין הרכב לנקודת האיסוף שצוין בבקשה.
vehicleDropoffEta

string (Timestamp format)

זמן ההגעה המשוער ברכב השלם אל נקודת ההורדה שצוינה בבקשה. זמן ההגעה המשוער כולל עצירה בכל ציוני הדרך לפני dropoffPoint שצוינו בבקשה. הערך יאוכלס רק כשתצוין בבקשה נקודת הורדה. ערך ריק מציין שגיאה בחישוב של זמן ההגעה המשוער.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
vehiclePickupToDropoffDistanceMeters

integer

מרחק הנסיעה של הרכב (במטרים) מנקודת האיסוף אל נקודת ההורדה שצוינה בבקשה. המרחק הוא רק בין שתי הנקודות, והוא לא כולל את מיקום הרכב או נקודות אחרות שצריך לבקר בהן לפני שהרכב מגיע לנקודת האיסוף או לנקודת ההורדה. הערך יאוכלס רק כאשר יצוינו dropoffPoint בבקשה. ערך ריק מציין כשל בחישוב המרחק מנקודת האיסוף עד לנקודת ההורדה שצוינה בבקשה.
tripType

enum (TripType)

חובה. סוג הנסיעה לפי הבקשה ששימשה לחישוב זמן ההגעה המשוער לנקודת האיסוף.
vehicleTripsWaypoints[]

object (Waypoint)

רשימה ממוינת של ציוני דרך שמשמשים לחישוב זמן ההגעה המשוער. הרשימה כוללת את מיקום הרכב, נקודות האיסוף של הנסיעות הפעילות של הרכב ונקודות האיסוף שצוינו בבקשה. רשימה ריקה מציינת כשל בחישוב זמן ההגעה המשוער של הרכב.
vehicleMatchType

enum (VehicleMatchType)

סוג ההתאמה של הרכב.
requestedOrderedBy

enum (VehicleMatchOrder)

הסדר המבוקש למיון התאמות כלי רכב.
orderedBy

enum (VehicleMatchOrder)

ההזמנה בפועל שבה נעשה שימוש ברכב הזה. בדרך כלל הערך הזה יתאים לשדה 'orderBy' מהבקשה; עם זאת, בנסיבות מסוימות כמו שגיאת שרת פנימית, ניתן להשתמש בשיטה אחרת (כמו PICKUP_POINT_STRAIGHT_DISTANCE).

נקודת ציון

מתאר נקודות ביניים לאורך מסלול של VehicleMatch בSearchVehiclesResponse. הקונספט הזה מיוצג בתור TripWaypoint בכל נקודות הקצה האחרות.

ייצוג JSON 
{
  "latLng": {
    object (LatLng)
  },
  "eta": string
}
שדות
latLng

object (LatLng)

המיקום של ציון הדרך הזה.
eta

string (Timestamp format)

הזמן המשוער שהרכב יגיע לנקודת הדרך הזו.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

VehicleMatchType

סוג ההתאמה לרכב.

טיפוסים בני מנייה (enums)
UNKNOWN סוג התאמה לא ידוע של רכב
EXCLUSIVE כרגע לא הוקצתה נסיעה לרכב, והוא יכול להמשיך לנקודת האיסוף.
BACK_TO_BACK הרכב מוקצה כרגע לנסיעה, אבל הוא יכול להמשיך לנקודת האיסוף אחרי השלמת הנסיעה. בחישובי זמן ההגעה המשוער והמרחק, הנסיעה הנוכחית נלקחת בחשבון.
CARPOOL יש ברכב מספיק קיבולת לנסיעה משותפת.
CARPOOL_BACK_TO_BACK הרכב יסיים את הנסיעה הפעילה הנוכחית לפני שימשיך לנקודת האיסוף. בחישובי זמן ההגעה המשוער והמרחק, הנסיעה הנוכחית נלקחת בחשבון.