TaskLog

บันทึกของทรัพยากรงานใน 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" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "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)

เวลาเพิ่มเติมในการดำเนินการที่สถานที่นี้

ระยะเวลาเป็นวินาทีโดยมีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย "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

ผู้ใช้ปลายทางจะเห็นองค์ประกอบข้อมูลนี้หากจำนวนการหยุดที่เหลือ <= leftStopCountThreshold
durationUntilEstimatedArrivalTimeThreshold

string (Duration format)

องค์ประกอบข้อมูลนี้จะปรากฏให้ผู้ใช้ปลายทางเห็นหากเวลา ETA ถึงป้ายหยุด <=DurationUntil ExplorerTimeThreshold

ระยะเวลาเป็นวินาทีโดยมีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย "s" ตัวอย่างเช่น "3.5s"
remainingDrivingDistanceMetersThreshold

integer

องค์ประกอบข้อมูลนี้จะปรากฏแก่ผู้ใช้ปลายทางหากระยะทางการขับขี่ที่เหลือเป็นเมตร <=leftHourMetersThreshold
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 ค่าของแอตทริบิวต์อาจเป็นสตริง บูลีน หรือประเภท Double หากไม่ได้ตั้งค่าไว้ ระบบจะจัดเก็บ TaskAttribute string_value เป็นสตริงว่าง "" task_attribute_value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
stringValue

string

ค่าแอตทริบิวต์ที่พิมพ์โดยสตริง
boolValue

boolean

ค่าแอตทริบิวต์ที่พิมพ์ด้วยบูลีน
numberValue

number

ค่าแอตทริบิวต์ที่พิมพ์คู่