VehicleJourneySegment

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

ייצוג JSON 
{
  "stop": {
    object (VehicleStop)
  },
  "drivingDistanceMeters": integer,
  "drivingDuration": string,
  "path": [
    {
      object (LatLng)
    }
  ]
}
שדות
stop

object (VehicleStop)

מציין את מיקום העצירה, יחד עם סימני ה-Task המשויכים לתחנה. יכול להיות שחלק מהשדות ב-VehicleStop לא יופיעו אם קטע הנסיעה הזה הוא חלק מ-JourneySharingInfo.
drivingDistanceMeters

integer

פלט בלבד. מרחק הנסיעה מהתחנה הקודמת לתחנה הזו. אם התחנה הנוכחית היא התחנה הראשונה ברשימת קטעי הנסיעה, נקודת ההתחלה היא המיקום של הרכב שתועד בזמן שהעצירה הזו נוספה לרשימה. יכול להיות שהשדה הזה לא יופיע אם קטע המסלול הזה הוא חלק מ-JourneySharingInfo.
drivingDuration

string (Duration format)

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

אם השדה הזה מוגדר בנתיב Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) או Task.remainingVehicleJourneySegments[0].drivingDuration (REST), אפשר לאכלס אותו בערך מ-DeliveryVehicle.remaining_duration (gRPC) או DeliveryVehicle.remainingDuration (REST). העמודה הזו מספקת את משך הנסיעה שנותר מהמיקום הידוע האחרון של אפליקציית הנהג ולא את זמן הנסיעה מהתחנה הקודמת.

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, המסתיים ב-'s'. דוגמה: "3.5s".
path[]

object (LatLng)

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

אם השדה הזה מוגדר בנתיב Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) או Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST), אפשר לאכלס אותו עם התווים LatLng שמפוענחים מ-DeliveryVehicle.current_route_segment (gRPC) או מ-DeliveryVehicle.currentRouteSegment (REST). ההגדרה הזו מספקת את נתיב הנסיעה מהמיקום האחרון הידוע של אפליקציית הנהג ולא את הנתיב מהתחנה הקודמת.

VehicleStop

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

ייצוג JSON 
{
  "plannedLocation": {
    object (LocationInfo)
  },
  "tasks": [
    {
      object (TaskInfo)
    }
  ],
  "state": enum (State)
}
שדות
plannedLocation

object (LocationInfo)

חובה. מיקום העצירה. לתשומת ליבך: ייתכן שהמיקומים בTask לא יתאימו בדיוק למיקום הזה, אבל הם יהיו במרחק קצר ממנו. השדה הזה לא יאוכלס בתגובה לקריאה של tasks.get או של tasks.search.
tasks[]

object (TaskInfo)

הרשימה של Task לביצוע בתחנה הזו. השדה הזה לא יאוכלס בתגובה לקריאה של tasks.get או של tasks.search.
state

enum (State)

המדינה של VehicleStop. השדה הזה לא יאוכלס בתגובה לקריאה של tasks.get או של tasks.search.

TaskInfo

מידע נוסף לגבי המשימה שבוצעה בעצירה זו.

ייצוג JSON 
{
  "taskId": string,
  "taskDuration": string,
  "targetTimeWindow": {
    object (TimeWindow)
  }
}
שדות
taskId

string

מזהה המשימה. השדה הזה לא יאוכלס בתגובה לקריאה של tasks.get או של tasks.search. מזהי משימות כפופים להגבלות הבאות:

  • חייבת להיות מחרוזת Unicode חוקית.
  • מוגבל לאורך מקסימלי של 64 תווים.
  • מנורמל לפי טופס נירמול Unicode.
  • אינו יכול להכיל אף אחד מתווי ASCII הבאים: '/', ':', '?', ',' או '#'.
taskDuration

string (Duration format)

פלט בלבד. הזמן שנדרש לביצוע המשימה.

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

object (TimeWindow)

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

ארץ

המצב הנוכחי של VehicleStop.

טיפוסים בני מנייה (enums)
STATE_UNSPECIFIED לא ידוע.
NEW הניתוב נוצר, אבל הוא לא נוצר באופן פעיל.
ENROUTE מוקצה וניתוב פעיל.
ARRIVED הגעת לעצירה. בהנחה שכשהרכב במסלול לתחנה הבאה, כל העצירות הקודמות הושלמו.