REST Resource: providers.taskTrackingInfo

משאב: TaskTrackingInfo

ההודעה TaskTrackingInfo. ההודעה מכילה את פרטי המעקב אחרי המשימה, שעל סמך אותם פרטים היא תוצג. אם מזהה מעקב משויך לכמה משימות, מערכת Fleet Engine משתמשת בהיוריסטיקה כדי להחליט איזה TaskTrackingInfo של Task לבחור.

ייצוג ב-JSON 
{
  "name": string,
  "trackingId": string,
  "vehicleLocation": {
    object (DeliveryVehicleLocation)
  },
  "routePolylinePoints": [
    {
      object (LatLng)
    }
  ],
  "remainingStopCount": integer,
  "remainingDrivingDistanceMeters": integer,
  "estimatedArrivalTime": string,
  "estimatedTaskCompletionTime": string,
  "state": enum (State),
  "taskOutcome": enum (TaskOutcome),
  "taskOutcomeTime": string,
  "plannedLocation": {
    object (LocationInfo)
  },
  "targetTimeWindow": {
    object (TimeWindow)
  },
  "attributes": [
    {
      object (TaskAttribute)
    }
  ]
}
שדות
name

string

חייב להיות בפורמט providers/{provider}/taskTrackingInfo/{tracking}, כאשר tracking מייצג את המזהה לצורכי מעקב.
trackingId

string

לא ניתן לשינוי. המזהה לצורכי מעקב של משימה. * חייבת להיות מחרוזת Unicode תקינה. * מוגבל לאורך של 64 תווים לכל היותר. * עבר נירמול בהתאם ל-Unicode Normalization Form C. * אסור לכלול את תווי ה-ASCII הבאים: '/',‏ ':',‏ '?',‏ ',' או '#'.
vehicleLocation

object (DeliveryVehicleLocation)

המיקום האחרון של הרכב.
routePolylinePoints[]

object (LatLng)

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

integer

מספר העצירות שנותרו לרכב עד שמגיעים לתחנה של המשימה, כולל התחנה של המשימה. לדוגמה, אם התחנה הבאה של הרכב היא התחנה של המשימה, הערך יהיה 1.
remainingDrivingDistanceMeters

integer

המרחק הכולל שנותר במטרים עד ל-VehicleStop הרצוי.
estimatedArrivalTime

string (Timestamp format)

חותמת הזמן שמציינת את זמן ההגעה המשוער לתחנה.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
estimatedTaskCompletionTime

string (Timestamp format)

חותמת הזמן שמציינת את מועד הסיום המשוער של משימה.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
state

enum (State)

מצב הביצוע הנוכחי של המשימה.
taskOutcome

enum (TaskOutcome)

התוצאה של ניסיון להריץ משימה.
taskOutcomeTime

string (Timestamp format)

חותמת הזמן שמציינת מתי הספק הגדיר את התוצאה של המשימה.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
plannedLocation

object (LocationInfo)

לא ניתן לשינוי. המיקום שבו המשימה תושלם.
targetTimeWindow

object (TimeWindow)

חלון הזמן שבו המשימה צריכה להסתיים.
attributes[]

object (TaskAttribute)

המאפיינים המותאמים אישית שהוגדרו במשימה.

Methods

get

 הפונקציה מחזירה את מופע TaskTrackingInfo שצוין.