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 הגיעה לתחנה. בהנחה שכשהרכב עובר לתחנה הבאה, כל העצירות הקודמות הושלמו.