SearchVehiclesLog

פרטים על הבקשה והתגובה של SearchVehicles.

הערה: היומן הזה כפוף לפיצול בשדה ההתאמות אם גודל היומן הכולל חורג מ-256KB. לפרטים נוספים, ראו יומנים מפוצלים.

ייצוג JSON
{
  "request": {
    object (SearchVehiclesRequestLog)
  },
  "response": {
    object (SearchVehiclesResponseLog)
  },
  "errorResponse": {
    object (ErrorResponseLog)
  }
}
שדות
request

object (SearchVehiclesRequestLog)

הבקשה נשלחה אל Fleet Engine.

response

object (SearchVehiclesResponseLog)

התשובה הוחזרה ללקוח. אם הקריאה ל-RPC מובילה לשגיאה, התגובה לא מוגדרת.

errorResponse

object (ErrorResponseLog)

תגובת השגיאה שהוחזרה ללקוח. היא תבוטל אם הקריאה ל-RPC תושלם בהצלחה.

SearchVehiclesRequestLog

פרטים בבקשת SearchVehicles.

ייצוג JSON
{
  "header": {
    object (RequestHeaderLog)
  },
  "pickupPoint": {
    object (TerminalLocationLog)
  },
  "dropoffPoint": {
    object (TerminalLocationLog)
  },
  "pickupRadiusMeters": integer,
  "count": integer,
  "minimumCapacity": integer,
  "searchTripTypes": [
    enum (TripTypeLog)
  ],
  "maximumStaleness": string,
  "vehicleTypes": [
    {
      object (VehicleTypeLog)
    }
  ],
  "requiredAttributes": [
    {
      object (VehicleAttributeLog)
    }
  ],
  "requiredOneOfAttributes": [
    {
      object (VehicleAttributeListLog)
    }
  ],
  "requiredOneOfAttributeSets": [
    {
      object (VehicleAttributeListLog)
    }
  ],
  "matchOrderBy": enum (VehicleMatchOrderLog),
  "includeBackToBack": boolean,
  "tripId": string,
  "filter": string
}
שדות
header

object (RequestHeaderLog)

כותרת הבקשה.

pickupPoint

object (TerminalLocationLog)

נקודת האיסוף שבה יש לחפש.

dropoffPoint

object (TerminalLocationLog)

מיקום המסירה המיועד של הלקוח.

pickupRadiusMeters

integer

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

count

integer

מציינת את מספר הרכבים המקסימלי שצריך להחזיר.

minimumCapacity

integer

מציינת את הקיבולת המינימלית הנדרשת של הרכב.

searchTripTypes[]

enum (TripTypeLog)

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

maximumStaleness

string (Duration format)

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

משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-'s'. לדוגמה: "3.5s".

vehicleTypes[]

object (VehicleTypeLog)

סוגי כלי הרכב שמחפשים.

requiredAttributes[]

object (VehicleAttributeLog)

מגביל את החיפוש רק לרכבים עם המאפיינים שצוינו.

requiredOneOfAttributes[]

object (VehicleAttributeListLog)

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

requiredOneOfAttributeSets[]

object (VehicleAttributeListLog)

מגביל את החיפוש רק לרכבים עם לפחות קבוצה אחת מהמאפיינים שצוינו ב-vehicleAttributeList.

matchOrderBy

enum (VehicleMatchOrderLog)

סדר המיון של תוצאת החיפוש.

includeBackToBack

boolean

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

tripId

string

מזהה הנסיעה שמשויכת ל-searchVehiclesRequest.

filter

string

שאילתת AIP-160 שמגבילה כלי רכב שהוחזרו על סמך מאפייני רכב.

VehicleAttributeListLog

סוג נתונים של רשימת היתרים ל-vehicleAttributeLog.

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

object (VehicleAttributeLog)

רשימת מאפיינים באוסף הזה.

SearchVehiclesResponseLog

פרטים על התגובה SearchVehicles.

ייצוג JSON
{
  "matchIds": [
    string
  ],
  "matches": [
    {
      object (VehicleMatchLog)
    }
  ]
}
שדות
matchIds[]
(deprecated)

string

הוצא משימוש: רשימת מזהי הרכבים של כלי הרכב שהוחזרו. אפשר להשתמש ב-matchs.vehicle.name כדי להסיק את המזהה.

matches[]

object (VehicleMatchLog)

רשימת התאמות לכלי הרכב שהוחזרו.

VehicleMatchLog

היומן של תוצאה SearchVehicles ToolMatch.

ייצוג JSON
{
  "vehicle": {
    object (VehicleLog)
  },
  "vehiclePickupEta": string,
  "vehiclePickupDistanceMeters": integer,
  "vehiclePickupStraightLineDistanceMeters": integer,
  "vehicleDropoffEta": string,
  "vehiclePickupToDropoffDistanceMeters": integer,
  "tripType": enum (TripTypeLog),
  "vehicleMatchType": enum (VehicleMatchTypeLog),
  "requestedOrderedBy": enum (VehicleMatchOrderLog),
  "orderedBy": enum (VehicleMatchOrderLog)
}
שדות
vehicle

object (VehicleLog)

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

vehiclePickupEta

string (Timestamp format)

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

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

vehiclePickupDistanceMeters

integer

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

vehiclePickupStraightLineDistanceMeters

integer

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

vehicleDropoffEta

string (Timestamp format)

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

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

vehiclePickupToDropoffDistanceMeters

integer

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

tripType

enum (TripTypeLog)

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

vehicleMatchType

enum (VehicleMatchTypeLog)

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

requestedOrderedBy

enum (VehicleMatchOrderLog)

השיטה שהמתקשר ביקש למיון התאמות לרכב.

orderedBy

enum (VehicleMatchOrderLog)

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