VehicleJourneySegment

แสดงกลุ่มการเดินทางของยานพาหนะ - จากจุดแวะพักก่อนหน้าถึงจุดแวะปัจจุบัน หากเป็นจุดแวะแรกเข้า ก็จะมาจากตำแหน่งปัจจุบันของรถไปยังจุดแวะนี้

การแสดง JSON
{
  "stop": {
    object (VehicleStop)
  },
  "drivingDistanceMeters": integer,
  "drivingDuration": string,
  "path": [
    {
      object (LatLng)
    }
  ]
}
ช่อง
stop

object (VehicleStop)

ระบุตำแหน่งแวะพัก พร้อมกับ Task ที่เชื่อมโยงกับจุดแวะพัก ช่องบางส่วนของยานพาหนะอาจไม่มีแสดง หากกลุ่มเส้นทางนี้เป็นส่วนหนึ่งของ JourneySharingInfo

drivingDistanceMeters

integer

เอาต์พุตเท่านั้น ระยะทางในการเดินทางจากป้ายจอดรถก่อนหน้ามายังป้ายนี้ หากจุดแวะปัจจุบันเป็นจุดแวะแรกในรายการของส่วนการเดินทาง จุดเริ่มต้นคือตำแหน่งของรถที่บันทึกไว้ ณ เวลาที่เพิ่มจุดแวะนี้ลงในรายการ ช่องนี้อาจไม่แสดงหากกลุ่มเส้นทางนี้เป็นส่วนหนึ่งของ JourneySharingInfo

drivingDuration

string (Duration format)

เอาต์พุตเท่านั้น เวลาที่ใช้ในการเดินทางจากป้ายหยุดก่อนหน้ามายังป้ายนี้ หากจุดแวะปัจจุบันเป็นจุดแวะแรกในรายการส่วนของการเดินทาง จุดเริ่มต้นคือตําแหน่งของยานพาหนะที่บันทึกไว้ ณ เวลาที่เพิ่มจุดแวะนี้ลงในรายการ

หากมีการกำหนดช่องนี้ในเส้นทาง Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) หรือ Task.remainingVehicleJourneySegments[0].drivingDuration (REST) ระบบอาจเติมค่าจาก DeliveryVehicle.remaining_duration (gRPC) หรือ DeliveryVehicle.remainingDuration (REST) ข้อมูลนี้จะแสดงระยะเวลาขับรถที่เหลืออยู่จากตําแหน่งล่าสุดที่ทราบของแอปคนขับ ไม่ใช่ระยะเวลาขับรถจากจุดแวะพักก่อนหน้า

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

path[]

object (LatLng)

เอาต์พุตเท่านั้น เส้นทางจากป้ายหยุดก่อนหน้าไปยังป้ายหยุดนี้ หากจุดแวะปัจจุบันเป็นจุดแวะแรกในรายการของส่วนการเดินทาง แสดงว่าเป็นเส้นทางจากตําแหน่งปัจจุบันของรถไปยังป้ายหยุดนี้ ณ เวลาที่เพิ่มจุดแวะลงในรายการ ช่องนี้อาจไม่แสดงหากกลุ่มเส้นทางนี้เป็นส่วนหนึ่งของ JourneySharingInfo

หากมีการกำหนดช่องนี้ในเส้นทาง Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) หรือ Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) ระบบอาจป้อนข้อมูลด้วย LatLng ที่ถอดรหัสจาก DeliveryVehicle.current_route_segment (gRPC) หรือ DeliveryVehicle.currentRouteSegment (REST) วิธีนี้จะแสดงเส้นทางการขับรถจากตำแหน่งล่าสุดที่ทราบของแอปคนขับ แทนที่จะเป็นเส้นทางจากจุดแวะพักก่อนหน้า

VehicleStop

อธิบายจุดที่ยานพาหนะหยุดเพื่อทำการ Task อย่างน้อย 1 ครั้ง

การแสดง JSON
{
  "plannedLocation": {
    object (LocationInfo)
  },
  "tasks": [
    {
      object (TaskInfo)
    }
  ],
  "state": enum (State)
}
ช่อง
plannedLocation

object (LocationInfo)

ต้องระบุ ตำแหน่งของป้ายจอดรถ โปรดทราบว่าสถานที่ใน Task อาจไม่ตรงกับสถานที่นี้ทั้งหมด แต่จะอยู่ไม่ไกลจากสถานที่นี้ ระบบจะไม่ป้อนข้อมูลในช่องนี้เมื่อเรียก tasks.get

tasks[]

object (TaskInfo)

รายการ Task ที่จะดำเนินการในจุดแวะพักนี้ ระบบจะไม่ป้อนข้อมูลในช่องนี้เมื่อเรียก tasks.get

state

enum (State)

สถานะของ VehicleStop ระบบจะไม่ป้อนข้อมูลในช่องนี้เมื่อเรียก tasks.get

TaskInfo

ข้อมูลเพิ่มเติมเกี่ยวกับงานที่ดําเนินการเมื่อหยุดนี้

การแสดง JSON
{
  "taskId": string,
  "taskDuration": string,
  "targetTimeWindow": {
    object (TimeWindow)
  }
}
ช่อง
taskId

string

รหัสงาน ระบบจะไม่ป้อนข้อมูลในช่องนี้เมื่อเรียก tasks.get รหัสงานอยู่ภายใต้ข้อจำกัดต่อไปนี้

  • ต้องเป็นสตริง Unicode ที่ถูกต้อง
  • จำกัดให้มีความยาวไม่เกิน 64 อักขระ
  • ทำให้เป็นมาตรฐานตามแบบฟอร์มการปรับมาตรฐาน Unicode
  • ต้องไม่มีอักขระ ASCII ต่อไปนี้: '/', ':', '?', ',' หรือ '#'
taskDuration

string (Duration format)

เอาต์พุตเท่านั้น เวลาที่ต้องใช้ในการดำเนินการ

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

targetTimeWindow

object (TimeWindow)

เอาต์พุตเท่านั้น กรอบเวลาที่งานควรเสร็จสิ้น การดำเนินการนี้จะตั้งค่าในการตอบกลับ deliveryVehicles.get เท่านั้น

รัฐ

สถานะปัจจุบันของ VehicleStop

Enum
STATE_UNSPECIFIED ไม่รู้จัก
NEW สร้างแล้ว แต่ไม่ได้กำหนดเส้นทางในขณะนี้
ENROUTE ได้รับมอบหมายและกำลังกำหนดเส้นทาง
ARRIVED มาถึงที่ป้าย สมมติว่าเมื่อรถกำลังกำหนดเส้นทางไปยังจุดแวะพักถัดไป แสดงว่าจุดแวะก่อนหน้าทั้งหมดเสร็จสมบูรณ์แล้ว