VehicleJourneySegment

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

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

object (VehicleStop)

מציין את מיקום התחנה, יחד עם הערכים של Task שמשויכים לתחנה. אם קטע הנסיעה הזה הוא חלק מ-JourneySharingInfo, יכול להיות שחלק מהשדות ב-vehicleStop לא יהיו זמינים.
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

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

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

object (LocationInfo)

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

object (TaskInfo)

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

enum (State)

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

TaskInfo

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

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

string

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

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

string (Duration format)

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

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

object (TimeWindow)

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

מדינה

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

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