SearchVehiclesLog

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

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

ייצוג ב-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)

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

requiredOneOfAttributeSets[]

object (VehicleAttributeListLog)

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

matchOrderBy

enum (VehicleMatchOrderLog)

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

includeBackToBack

boolean

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

tripId

string

המזהה של הנסיעה שמשויכת לבקשת searchVehicles.

filter

string

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

VehicleAttributeListLog

סוג נתונים של רשימה של רשימות עבור VehicleAttributeLog.

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

object (VehicleAttributeLog)

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

SearchVehiclesResponseLog

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

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

string

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

matches[]

object (VehicleMatchLog)

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

VehicleMatchLog

היומן של תוצאת VehicleMatch ב-SearchVehicles.

ייצוג ב-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)

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

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

vehiclePickupDistanceMeters

integer

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

vehiclePickupStraightLineDistanceMeters

integer

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

vehicleDropoffEta

string (Timestamp format)

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

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

vehiclePickupToDropoffDistanceMeters

integer

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

tripType

enum (TripTypeLog)

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

vehicleMatchType

enum (VehicleMatchTypeLog)

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

requestedOrderedBy

enum (VehicleMatchOrderLog)

השיטה שהמבצע של הקריאה החוזרת ביקש למיון ההתאמות של כלי הרכב.

orderedBy

enum (VehicleMatchOrderLog)

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