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

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