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)

การประทับเวลาที่กําหนดผลลัพธ์ของงาน (จากผู้ให้บริการ)

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 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)

เวลาเพิ่มเติมในการดําเนินการ ณ ตําแหน่งนี้

ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 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

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

string (Duration format)

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

ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย 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_value ของ TaskAttribute เป็นสตริงว่าง "" task_attribute_value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
stringValue

string

ค่าแอตทริบิวต์ที่เป็นสตริง
boolValue

boolean

ค่าแอตทริบิวต์ประเภทบูลีน
numberValue

number

ค่าแอตทริบิวต์ประเภท Double