REST Resource: providers.deliveryVehicles

{
  "name": string,
  "lastLocation": {
    object (DeliveryVehicleLocation)
  },
  "navigationStatus": enum (DeliveryVehicleNavigationStatus),
  "currentRouteSegment": string,
  "currentRouteSegmentEndPoint": {
    object (LatLng)
  },
  "remainingDistanceMeters": integer,
  "remainingDuration": string,
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegment)
    }
  ],
  "attributes": [
    {
      object (DeliveryVehicleAttribute)
    }
  ],
  "type": enum (DeliveryVehicleType)
}

string

השם הייחודי של כלי הרכב להעברה. הפורמט הוא providers/{provider}/deliveryVehicles/{vehicle}.

object (DeliveryVehicleLocation)

המיקום האחרון שדווח על רכב המסירה.

enum (DeliveryVehicleNavigationStatus)

סטטוס הניווט של כלי הרכב לצורך מסירה.

string (bytes format)

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

יש כמה מקרים שבהם לא ניתן להשתמש בשדה הזה כדי לאכלס את Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) או את Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST):

• נקודת הקצה ב-currentRouteSegment לא תואמת ל-DeliveryVehicle.remaining_vehicle_journey_segments[0].stop (gRPC) או ל-DeliveryVehicle.remainingVehicleJourneySegments[0].stop (REST).

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

• אפליקציית הנהג עדכנה לאחרונה את המיקום שלה, אבל אפליקציית currentRouteSegment לא עדכנית והיא מפנה לתחנה קודמת של רכב.

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

מחרוזת בקידוד Base64.

object (LatLng)

המיקום שבו currentRouteSegment מסתיים. בשלב הזה, האפליקציה של הנהג לא מאכלסת את השדה הזה, אבל אפשר לספק אותו בקריאות ל-deliveryVehicles.patch. זהו LatLng מתחנת הרכב הקרובה, או LatLng האחרון של currentRouteSegment. לאחר מכן, Fleet Engine יעשה כמיטב יכולתו כדי לבצע אינטרפולציה ל-VehicleStop בפועל.

המערכת מתעלמת מהשדה הזה בקריאות ל-deliveryVehicles.patch אם השדה currentRouteSegment ריק.

integer

מרחק הנסיעה שנותר עבור currentRouteSegment. בדרך כלל אפליקציית Driver מספקת את השדה הזה, אבל יש מקרים שבהם Fleet Engine יבטל את הערך שנשלח על ידי האפליקציה. מידע נוסף זמין בכתובת DeliveryVehicle.current_route_segment. השדה הזה מוחזר ב-Task.remaining_vehicle_journey_segments[0].driving_distance_meters‏ (gRPC) או ב-Task.remainingVehicleJourneySegments[0].drivingDistanceMeters‏ (REST) לכל הערכים הפעילים של Task שהוקצו לכלי המסירה.

המערכת של Fleet Engine מתעלמת מהשדה הזה ב-UpdateDeliveryVehicleRequest אם השדה currentRouteSegment ריק.

string (Duration format)

משך הנסיעה שנותר ב-currentRouteSegment. השדה הזה בדרך כלל מופיע באפליקציית Driver, אבל יש כמה נסיבות שבהן מערכת Fleet Engine תשנה את הערך שנשלח מהאפליקציה. מידע נוסף זמין במאמר DeliveryVehicle.current_route_segment. השדה הזה מוחזר ב-Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) או ב-Task.remainingVehicleJourneySegments[0].drivingDuration (REST) לכל המשימות הפעילות שהוקצו לכלי המסירה.

המערכת של Fleet Engine מתעלמת מהשדה הזה ב-UpdateDeliveryVehicleRequest אם השדה currentRouteSegment ריק.

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

object (VehicleJourneySegment)

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

object (DeliveryVehicleAttribute)

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

enum (DeliveryVehicleType)

סוג כלי התחבורה למשלוח. אם לא תגדירו את הערך, הערך שמוגדר כברירת מחדל הוא AUTO.

{
  "key": string,
  "value": string,

  // Union field delivery_vehicle_attribute_value can be only one of the
  // following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field
  // delivery_vehicle_attribute_value.
}

string

המַּפתח של המאפיין.

string

הערך של המאפיין.

string

ערך מאפיין מסוג מחרוזת.

הערה: השדה הזה זהה לשדה value, שיוצא משימוש בסופו של דבר. בשיטות ליצירה או לעדכון, אפשר להשתמש בכל אחד מהשדות, אבל מומלץ מאוד להשתמש ב-stringValue. אם גם stringValue וגם value מוגדרים, הם חייבים להיות זהים, אחרת תופיע שגיאה. שני השדות מאוכלסים בתשובות.

boolean

ערך מאפיין מסוג בוליאני.

number

ערך מאפיין מסוג double.