VehicleJourneySegment

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

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

object (VehicleStop)

ระบุตำแหน่งแวะพัก พร้อมกับ Task ที่เชื่อมโยงกับจุดแวะพัก ช่องบางช่องของ VehicleStop อาจไม่แสดงหากส่วนของการเดินทางนี้เป็นส่วนหนึ่งของ 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 C
  • ต้องไม่มีอักขระ ASCII ต่อไปนี้: '/', ':', '?', ',' หรือ '#'
taskDuration

string (Duration format)

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

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

targetTimeWindow

object (TimeWindow)

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

รัฐ

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

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