TaskLog

היומן של משאב משימה ב-Deliveries API.

ייצוג JSON 
{
  "name": string,
  "type": enum (TaskTypeLog),
  "state": enum (TaskStateLog),
  "taskOutcome": enum (TaskOutcomeLog),
  "taskOutcomeTime": string,
  "taskOutcomeLocation": {
    object (LocationInfoLog)
  },
  "taskOutcomeLocationSource": enum (TaskOutcomeLocationSourceLog),
  "trackingId": string,
  "deliveryVehicleId": string,
  "plannedLocation": {
    object (LocationInfoLog)
  },
  "taskDuration": string,
  "targetTimeWindow": {
    object (TimeWindowLog)
  },
  "journeySharingInfo": {
    object (JourneySharingInfoLog)
  },
  "taskTrackingViewConfig": {
    object (TaskTrackingViewConfigLog)
  },
  "attributes": [
    {
      object (TaskAttributeLog)
    }
  ]
}
שדות
name

string

שם משאב המשימה בפורמט providers/{providerId}/tasks/{taskId}.
type

enum (TaskTypeLog)

סוג המשימה.
state

enum (TaskStateLog)

המצב של משימה שמציינת את ההתקדמות שלה.
taskOutcome

enum (TaskOutcomeLog)

התוצאה של ניסיון לבצע משימה. כאשר TaskState סגור, זה מציין אם המשימה הושלמה בהצלחה.
taskOutcomeTime

string (Timestamp format)

חותמת הזמן של קביעת התוצאה של המשימה (הספק).

חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
taskOutcomeLocation

object (LocationInfoLog)

המיקום שבו הוגדרה תוצאת המשימה.
taskOutcomeLocationSource

enum (TaskOutcomeLocationSourceLog)

מציין את מקור הערך של taskOutcomeLocation.
trackingId

string

השדה הזה מאפשר לשמור עבור הלקוח מזהה כדי להימנע ממיפוי מיותר או מורכב.
deliveryVehicleId

string

מזהה הרכב שמבצע את המשימה הזו.
plannedLocation

object (LocationInfoLog)

המיקום שבו המשימה הושלמה.
taskDuration

string (Duration format)

תוספת זמן לביצוע פעולה במיקום הזה.

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

object (TimeWindowLog)

חלון הזמן שבמהלכו רוצים להשלים את המשימה.
journeySharingInfo

object (JourneySharingInfoLog)

שיתוף תהליך עם שדות ספציפיים.
taskTrackingViewConfig

object (TaskTrackingViewConfigLog)

הגדרה של מעקב אחרי משימות, שמציינת אילו רכיבי נתונים גלויים למשתמשי הקצה ובאילו נסיבות.
attributes[]

object (TaskAttributeLog)

רשימת מאפיינים בהתאמה אישית של משימות. לכל מאפיין צריך להיות מפתח ייחודי.

JourneySharingInfoLog

שיתוף תהליך עם שדות ספציפיים.

ייצוג JSON 
{
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegmentLog)
    }
  ],
  "lastLocation": {
    object (DeliveryVehicleLocationLog)
  },
  "lastLocationSnappable": boolean
}
שדות
remainingVehicleJourneySegments[]

object (VehicleJourneySegmentLog)

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

object (DeliveryVehicleLocationLog)

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

boolean

ההערה מציינת אם אפשר להצמיד את lastLocation של הרכב לcurrentRouteSegment. False אם lastLocation או currentRouteSegment לא קיימים.

TaskTrackingViewConfigLog

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

ייצוג JSON 
{
  "routePolylinePointsVisibility": {
    object (VisibilityOptionLog)
  },
  "estimatedArrivalTimeVisibility": {
    object (VisibilityOptionLog)
  },
  "estimatedTaskCompletionTimeVisibility": {
    object (VisibilityOptionLog)
  },
  "remainingDrivingDistanceVisibility": {
    object (VisibilityOptionLog)
  },
  "remainingStopCountVisibility": {
    object (VisibilityOptionLog)
  },
  "vehicleLocationVisibility": {
    object (VisibilityOptionLog)
  }
}
שדות
routePolylinePointsVisibility

object (VisibilityOptionLog)

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

object (VisibilityOptionLog)

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

object (VisibilityOptionLog)

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

object (VisibilityOptionLog)

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

object (VisibilityOptionLog)

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

object (VisibilityOptionLog)

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

VisibilityOptionLog

הודעת האפשרות שקובעת מתי משתמשי הקצה יכולים לראות רכיב מסוים של נתונים.

ייצוג JSON 
{

  // Union field visibility_option can be only one of the following:
  "remainingStopCountThreshold": integer,
  "durationUntilEstimatedArrivalTimeThreshold": string,
  "remainingDrivingDistanceMetersThreshold": integer,
  "always": boolean,
  "never": boolean
  // End of list of possible types for union field visibility_option.
}
שדות

שדה איחוד visibility_option.

הערך של visibility_option יכול להיות רק אחת מהאפשרויות הבאות:
remainingStopCountThreshold

integer

רכיב הנתונים הזה גלוי למשתמשי הקצה אם מספר ההפסקות שנותר <= נותר StopCountRate.
durationUntilEstimatedArrivalTimeThreshold

string (Duration format)

רכיב הנתונים הזה גלוי למשתמשי הקצה אם זמן ההגעה המשוער עד לעצירה <= durationpendingArrivalTimeRate.

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

integer

רכיב הנתונים הזה גלוי למשתמשי הקצה אם מרחק הנסיעה שנותר במטרים הוא במטרים <= ההגנהDurationMeters אותנו.
always

boolean

אם המדיניות מוגדרת כ-True, רכיב הנתונים הזה תמיד יהיה גלוי למשתמשי הקצה ללא ערכי סף.
never

boolean

אם המדיניות מוגדרת כ-True, רכיב הנתונים הזה תמיד מוסתר ממשתמשי הקצה ללא ערכי סף.

TaskAttributeLog

מתאר מאפיין של משימה כצמד מפתח/ערך. האורך של המחרוזת "key:value" לא יכול לחרוג מ-256 תווים.

ייצוג JSON 
{
  "key": string,

  // Union field task_attribute_value can be only one of the following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field task_attribute_value.
}
שדות
key

string

מפתח המאפיין. המקשים לא יכולים להכיל את תו הנקודתיים (:).
שדה איחוד task_attribute_value. ערך המאפיין יכול להיות במחרוזת, בערך בוליאני או בטיפוס כפול. אם לא הוגדר ערך, מזהה TaskAttribute string_value יאוחסן כמחרוזת הריקה "". הערך task_attribute_value יכול להיות רק אחד מהערכים הבאים:
stringValue

string

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

boolean

ערך מאפיין מוקלד בוליאני.
numberValue

number

ערך מאפיין שהוקלד פעמיים.