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 C
  • ต้องไม่มีอักขระ ASCII ต่อไปนี้: "/", ":", "?", "," หรือ "#"
taskDuration

string (Duration format)

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

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

targetTimeWindow

object (TimeWindow)

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

รัฐ

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

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