TaskLog

سجلّ مورد المهام في واجهة برمجة تطبيقات التسليم

تمثيل 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 "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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)

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

يكون عنصر البيانات هذا مرئيًا للمستخدمين إذا كان عدد التوقف المتبقي <= الاحتفاظ بـStopCountThreshold.
durationUntilEstimatedArrivalTimeThreshold

string (Duration format)

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

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

integer

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

boolean

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

boolean

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

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، سيتم تخزين سلسلة_قيمة_السلسلة الفارغة "". ويمكن أن تكون القيمة "task_attribute_value" واحدة فقط مما يلي:
stringValue

string

قيمة سمة كتابة السلسلة
boolValue

boolean

قيمة السمة المكتوبة بقيم منطقية.
numberValue

number

قيمة السمة المكتوبة بحروف مزدوجة