REST Resource: providers.taskTrackingInfo

المورد: TaskTrackingInfo

رسالة TaskTrackingInfo تحتوي الرسالة على معلومات تتبُّع المهام التي سيتم استخدامها للعرض. إذا كان معرّف التتبّع مرتبطًا بمهام متعدّدة، يستخدم Fleet Engine طريقة استقرائية لتحديد TaskTrackingInfo للمهمة التي سيتم اختيارها.

تمثيل 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 حرفًا. * تم تسويتها وفقًا لنموذج تسويتها في يونيكود 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 أرقام عشرية. يتم أيضًا قبول العناصر غير "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 أرقام عشرية. يتم أيضًا قبول العناصر غير "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 أرقام عشرية. يتم أيضًا قبول العناصر غير "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)

السمات المخصّصة التي تم ضبطها على المهمة.

الطُرق

get

لعرض مثيل TaskTrackingInfo المحدّد.