- แหล่งข้อมูล: งาน
- ประเภท
- TaskOutcomeLocationSource
- JourneySharingInfo
- TaskTrackingViewConfig
- VisibilityOption
- เมธอด
ทรัพยากร: งาน
งานใน Delivery API จะแสดงการดำเนินการหนึ่งที่ต้องติดตาม โดยทั่วไปแล้วจะมีความแตกต่างกันระหว่าง "งานที่เกี่ยวข้องกับการจัดส่ง" และ "งานช่วงพัก" การจัดส่งหนึ่งๆ จะเชื่อมโยงกับงานได้หลายรายการ เช่น อาจมีงาน 1 งานสำหรับการรับสินค้าและอีกงานหนึ่งสำหรับการไปรับหรือโอนรถ นอกจากนี้ ยานพาหนะที่ต่างกันยังจัดการงานต่างๆ สำหรับการจัดส่งแต่ละรายการได้ด้วย เช่น ยานพาหนะ 1 คันอาจรับและนำส่งพัสดุไปยังฮับ ส่วนยานพาหนะอีกคันขับเคลื่อนการจัดส่งแบบเดียวกันจากฮับไปยังจุดส่งพัสดุ
หมายเหตุ: gRPC และ REST API ใช้รูปแบบการตั้งชื่อช่องต่างกัน เช่น ช่อง Task.journey_sharing_info
ใน gRPC API และช่อง Task.journeySharingInfo
ใน REST API จะเป็นช่องเดียวกัน
การแสดง JSON |
---|
{ "name": string, "type": enum ( |
ช่อง | |
---|---|
name |
ต้องอยู่ในรูปแบบ |
type |
ต้องระบุ เปลี่ยนแปลงไม่ได้ กำหนดประเภทของงาน เช่น ช่วงพักหรือการจัดส่ง |
state |
ต้องระบุ สถานะการดำเนินการปัจจุบันของงาน |
taskOutcome |
ผลลัพธ์ของงาน |
taskOutcomeTime |
การประทับเวลาที่บ่งบอกว่าผู้ให้บริการกำหนดผลลัพธ์ของ การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขที่เป็นเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
taskOutcomeLocation |
ตำแหน่งที่มีการตั้งค่าผลลัพธ์ของ |
taskOutcomeLocationSource |
บ่งบอกว่าค่าของ |
trackingId |
เปลี่ยนแปลงไม่ได้ ช่องนี้ช่วยจัดเก็บรหัสเพื่อให้คุณหลีกเลี่ยงการใช้การแมปที่ซับซ้อนได้ คุณไม่สามารถตั้งค่า
|
deliveryVehicleId |
เอาต์พุตเท่านั้น รหัสของยานพาหนะที่ดำเนินงานนี้ รหัสยานพาหนะที่นำส่งจะอยู่ภายใต้ข้อจำกัดต่อไปนี้
|
plannedLocation |
เปลี่ยนแปลงไม่ได้ ตำแหน่งที่งานจะเสร็จสมบูรณ์ ไม่บังคับสำหรับ |
taskDuration |
ต้องระบุ เปลี่ยนแปลงไม่ได้ เวลาที่ต้องใช้ในการดำเนินงานงานในตำแหน่งนี้ ระยะเวลาเป็นวินาทีที่มีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย " |
targetTimeWindow |
กรอบเวลาที่ควรทำงานให้เสร็จ |
journeySharingInfo |
เอาต์พุตเท่านั้น ช่องสำหรับการแชร์เส้นทางการท่องเว็บโดยเฉพาะ ไม่ได้ป้อนข้อมูลเมื่อรัฐเป็น |
taskTrackingViewConfig |
การกำหนดค่าสำหรับการติดตามงานที่ระบุว่าผู้ใช้ปลายทางมองเห็นองค์ประกอบใดในสถานการณ์ใด |
attributes[] |
รายการแอตทริบิวต์งานที่กำหนดเอง แต่ละแอตทริบิวต์ต้องมีคีย์ที่ไม่ซ้ำกัน |
ประเภท
ประเภทของงาน
Enum | |
---|---|
TYPE_UNSPECIFIED |
โดยค่าเริ่มต้น ระบบจะไม่รู้จักประเภทงาน |
PICKUP |
งานรับสินค้าคือการดำเนินการรับสินค้าจากลูกค้า บริการรับรถจากสถานีรับส่งสินค้าหรือรถป้อนอาหารควรใช้ประเภท SCHEDULED_STOP |
DELIVERY |
งานการนำส่งคือการดำเนินการเพื่อนำส่งพัสดุไปยังลูกค้าปลายทาง จุดทิ้งของยานพาหนะที่ทิ้งเทปหรือฟีดเดอร์ควรใช้ประเภท SCHEDULED_STOP |
SCHEDULED_STOP |
ระบบจะใช้งานหยุดที่กำหนดเวลาไว้เพื่อวัตถุประสงค์ในการวางแผน เช่น อาจเป็นการรับหรือทิ้งพัสดุจากยานพาหนะสำหรับฟีดเดอร์หรือคลังสินค้า ไม่ควรใช้กับการจัดส่งที่มีการรับสินค้าหรือส่งคืนจากลูกค้าปลายทาง |
UNAVAILABLE |
งานที่หมายความว่ารถยนต์ไม่พร้อมรับบริการ เช่น กรณีนี้อาจเกิดขึ้นเมื่อคนขับหยุดพัก หรือเมื่อรถเติมน้ำมัน |
TaskOutcomeLocationSource
ข้อมูลประจำตัวของแหล่งที่มาที่ป้อนข้อมูล taskOutcomeLocation
Enum | |
---|---|
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED |
ผลลัพธ์ของงานก่อนที่จะตั้งค่า |
PROVIDER |
ผู้ให้บริการระบุ taskOutcomeLocation |
LAST_VEHICLE_LOCATION |
ผู้ให้บริการไม่ได้ระบุ taskOutcomeLocation ดังนั้น Fleet Engine จึงใช้ตำแหน่งของรถที่ทราบล่าสุด |
JourneySharingInfo
เส้นทางการแชร์ช่องที่เฉพาะเจาะจง
การแสดง JSON |
---|
{ "remainingVehicleJourneySegments": [ { object ( |
ช่อง | |
---|---|
remainingVehicleJourneySegments[] |
ข้อมูลการติดตามจุดแวะพักที่รถที่ได้รับมอบหมายจะสร้างขึ้นก่อนที่จะทำงานนี้เสร็จ โปรดทราบว่ารายการนี้อาจมีจุดแวะจากงานอื่นๆ อยู่ด้วย ส่วนแรก |
lastLocation |
ระบุตำแหน่งที่รายงานล่าสุดของรถคันนั้น |
lastLocationSnappable |
ระบุว่าสามารถสแนปตำแหน่งสุดท้ายของรถไปยัง |
TaskTrackingViewConfig
ข้อความการกําหนดค่าที่ระบุว่าผู้ใช้ปลายทางควรมองเห็นองค์ประกอบข้อมูลของงานเมื่อใด
การแสดง JSON |
---|
{ "routePolylinePointsVisibility": { object ( |
ช่อง | |
---|---|
routePolylinePointsVisibility |
ช่องที่ระบุว่าจะแสดงให้เห็นจุดโพลีไลน์ของเส้นทางเมื่อใด หากไม่ได้ระบุช่องนี้ ระบบจะใช้การกำหนดค่าระดับการเข้าถึงเริ่มต้นระดับโปรเจ็กต์สำหรับข้อมูลนี้ |
estimatedArrivalTimeVisibility |
ฟิลด์ที่ระบุว่าเวลาถึงโดยประมาณจะแสดงให้เห็นได้เมื่อใด หากไม่ได้ระบุช่องนี้ ระบบจะใช้การกำหนดค่าระดับการเข้าถึงเริ่มต้นระดับโปรเจ็กต์สำหรับข้อมูลนี้ |
estimatedTaskCompletionTimeVisibility |
ช่องที่ระบุว่าจะแสดงเวลาเสร็จสมบูรณ์ของงานโดยประมาณเมื่อใด หากไม่ได้ระบุช่องนี้ ระบบจะใช้การกำหนดค่าระดับการเข้าถึงเริ่มต้นระดับโปรเจ็กต์สำหรับข้อมูลนี้ |
remainingDrivingDistanceVisibility |
ฟิลด์ที่ระบุว่าจะสามารถมองเห็นระยะการขับรถที่เหลืออยู่ได้เมื่อใด หากไม่ได้ระบุช่องนี้ ระบบจะใช้การกำหนดค่าระดับการเข้าถึงเริ่มต้นระดับโปรเจ็กต์สำหรับข้อมูลนี้ |
remainingStopCountVisibility |
ช่องที่ระบุว่าจำนวนการหยุดที่เหลืออยู่จะปรากฏขึ้นเมื่อใด หากไม่ได้ระบุช่องนี้ ระบบจะใช้การกำหนดค่าระดับการเข้าถึงเริ่มต้นระดับโปรเจ็กต์สำหรับข้อมูลนี้ |
vehicleLocationVisibility |
ช่องที่ระบุว่าตําแหน่งของยานพาหนะจะแสดงได้เมื่อใด หากไม่ได้ระบุช่องนี้ ระบบจะใช้การกำหนดค่าระดับการเข้าถึงเริ่มต้นระดับโปรเจ็กต์สำหรับข้อมูลนี้ |
VisibilityOption
ข้อความตัวเลือกที่กําหนดว่าผู้ใช้ปลายทางควรมองเห็นองค์ประกอบข้อมูลเมื่อใด
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ฟิลด์สหภาพ visibility_option ตัวเลือกระดับการเข้าถึงที่เจาะจงที่เลือกไว้ visibility_option ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
remainingStopCountThreshold |
องค์ประกอบข้อมูลนี้จะปรากฏแก่ผู้ใช้ปลายทางหากจำนวนการหยุดที่เหลืออยู่ <= remainingStopCountThreshold |
durationUntilEstimatedArrivalTimeThreshold |
องค์ประกอบข้อมูลนี้จะมองเห็นได้โดยผู้ใช้ปลายทางหากเวลาถึงโดยประมาณถึงหยุด <= periodUntiเป็นเรื่องที่คาดการณ์ไว้ArrivalTimeThreshold ระยะเวลาเป็นวินาทีที่มีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย " |
remainingDrivingDistanceMetersThreshold |
ผู้ใช้ปลายทางจะเห็นองค์ประกอบข้อมูลนี้หากระยะทางการขับขี่ที่เหลือเป็นเมตร <= leftDrivingDistanceMetersThreshold |
always |
หากตั้งค่าเป็น "จริง" ผู้ใช้ปลายทางจะเห็นองค์ประกอบข้อมูลนี้โดยไม่มีเกณฑ์เสมอ ตั้งค่าช่องนี้เป็น "เท็จ" ไม่ได้ |
never |
หากตั้งค่าเป็น "จริง" องค์ประกอบข้อมูลนี้จะซ่อนจากผู้ใช้ปลายทางโดยไม่มีเกณฑ์เสมอ ตั้งค่าช่องนี้เป็น "เท็จ" ไม่ได้ |
วิธีการ |
|
---|---|
|
สร้างและแสดงผลชุดของออบเจ็กต์ Task ใหม่ |
|
สร้างและแสดงผลออบเจ็กต์ Task ใหม่ |
|
รับข้อมูลเกี่ยวกับ Task |
|
รับ Task ทั้งหมดที่ตรงกับเกณฑ์การกรองที่ระบุ |
|
อัปเดตข้อมูล Task |