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)

مهر زمانی زمانی که نتیجه کار تنظیم شد (از ارائه دهنده).

مهر زمانی در قالب 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 )

لیستی از ویژگی های Task سفارشی. هر ویژگی باید یک کلید منحصر به فرد داشته باشد.

JourneySharingInfoLog

سفر به اشتراک گذاری زمینه های خاص.

نمایندگی JSON
{
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegmentLog)
    }
  ],
  "lastLocation": {
    object (DeliveryVehicleLocationLog)
  },
  "lastLocationSnappable": boolean
}
زمینه های
remainingVehicleJourneySegments[]

object ( VehicleJourneySegmentLog )

اطلاعات ردیابی برای هر توقفی که وسیله نقلیه تعیین شده قبل از تکمیل این کار به آن سفر خواهد کرد. این لیست ممکن است شامل توقف هایی از وظایف دیگر باشد.

lastLocation

object ( DeliveryVehicleLocationLog )

آخرین مکان گزارش شده خودرو

lastLocationSnappable

boolean

نشان می دهد که آیا می توان lastLocation وسیله نقلیه را به currentRouteSegment منتقل کرد یا خیر. اگر lastLocation یا currentRouteSegment وجود نداشته باشد، False .

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

اگر تعداد توقف باقیمانده <= restingStopCountThreshold باشد، این عنصر داده برای کاربران نهایی قابل مشاهده است.

durationUntilEstimatedArrivalTimeThreshold

string ( Duration format)

این عنصر داده برای کاربران نهایی قابل مشاهده است در صورتی که ETA به توقف <= durationUntilEstimatedArrivalTimeThreshold باشد.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

remainingDrivingDistanceMetersThreshold

integer

این عنصر داده برای کاربران نهایی قابل مشاهده است اگر فاصله رانندگی باقیمانده بر حسب متر <= باقیماندهDrivingDistanceMetersThreshold.

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 . مقدار مشخصه می تواند از نوع رشته ای، bool یا دوگانه باشد. اگر هیچ یک تنظیم نشده باشد، TaskAttribute string_value به عنوان رشته خالی "" ذخیره می شود. task_attribute_value تنها می تواند یکی از موارد زیر باشد:
stringValue

string

مقدار مشخصه را رشته ای تایپ کرد.

boolValue

boolean

مقدار مشخصه تایپ شده بولی.

numberValue

number

مقدار مشخصه را دوبار تایپ کرد.