TaskLog

سجلّ مورد Task في 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)

الطابع الزمني لوقت ضبط نتيجة المهمة (من مقدّم الخدمة)

يستخدم معيار 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"
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)

الحقل الذي يحدّد الحالات التي يمكن فيها ظهور نقاط الخطوط المتعددة للمسار في حال عدم تحديد هذا الحقل، سيتم استخدام الإعدادات التلقائية لمستوى مستوى المشروع لمستوى مستوى المشروع لهذه البيانات.
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

يظهر عنصر البيانات هذا للمستخدمين النهائيين إذا كان عدد المحطات المتبقية <= remainingStopCountThreshold.
durationUntilEstimatedArrivalTimeThreshold

string (Duration format)

يظهر عنصر البيانات هذا للمستخدمين النهائيين إذا كان الوقت المقدَّر للوصول إلى المحطة <= الحدّ الأدنى لمدة الوصول المقدَّرة.

المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".
remainingDrivingDistanceMetersThreshold

integer

يظهر عنصر البيانات هذا للمستخدمين النهائيين إذا كانت المسافة المتبقية للقيادة بالكيلومترات <= remainingDrivingDistanceMetersThreshold.
always

boolean

في حال ضبطها على "صحيح"، يكون عنصر البيانات هذا مرئيًا دائمًا للمستخدمين النهائيين بدون حدود.
never

boolean

في حال ضبط القيمة على "صحيح"، يتم دائمًا إخفاء عنصر البيانات هذا عن المستخدمين النهائيين بدون حدود.

TaskAttributeLog

تصف سمة مهمة كزوج مفتاح/قيمة. لا يمكن أن يتجاوز طول سلسلة "المفتاح:القيمة" 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 يمكن أن تكون قيمة السمة من النوع string أو bool أو double. في حال عدم ضبط أيّ منها، سيتم تخزين سلسلة_قيمة سمة_المهمة على أنّها السلسلة الفارغة "". يمكن أن يكون task_attribute_value أحد الخيارَين التاليَين فقط:
stringValue

string

قيمة سمة من النوع سلسلة
boolValue

boolean

قيمة سمة من النوع المنطقي
numberValue

number

قيمة سمة ذات نوع مزدوج