VehicleJourneySegment

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

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

object (VehicleStop)

ระบุตำแหน่งจุดแวะ พร้อมด้วย Task ที่เกี่ยวข้องกับจุดแวะนั้น อาจไม่มีช่องบางช่องของ CarStop หากส่วนการเดินทางนี้เป็นส่วนหนึ่งของ 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.search

tasks[]

object (TaskInfo)

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

state

enum (State)

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

TaskInfo

ข้อมูลเพิ่มเติมเกี่ยวกับงานที่ดำเนินการที่จุดแวะนี้

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

string

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

  • ต้องเป็นสตริง 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 มาถึงป้ายแล้ว สมมติว่าเมื่อพาหนะกำลังกำหนดเส้นทางไปยังจุดแวะถัดไป นั่นแปลว่าจุดแวะก่อนหน้าทั้งหมดเสร็จสมบูรณ์แล้ว