VehicleJourneySegment

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

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

object (VehicleStop)

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

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