REST Resource: providers.deliveryVehicles

{
  "name": string,
  "lastLocation": {
    object (DeliveryVehicleLocation)
  },
  "navigationStatus": enum (DeliveryVehicleNavigationStatus),
  "currentRouteSegment": string,
  "currentRouteSegmentEndPoint": {
    object (LatLng)
  },
  "remainingDistanceMeters": integer,
  "remainingDuration": string,
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegment)
    }
  ],
  "attributes": [
    {
      object (DeliveryVehicleAttribute)
    }
  ],
  "type": enum (DeliveryVehicleType)
}

string

ชื่อที่ไม่ซ้ำกันของยานพาหนะนำส่งนี้ รูปแบบคือ providers/{provider}/deliveryVehicles/{vehicle}

object (DeliveryVehicleLocation)

ตำแหน่งล่าสุดที่รายงานของยานพาหนะนำส่ง

enum (DeliveryVehicleNavigationStatus)

สถานะการนำทางของยานพาหนะนำส่ง

string (bytes format)

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

มีหลายกรณีที่ระบบอาจไม่ใช้ฟิลด์นี้ในการป้อนข้อมูล Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) หรือ Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST)

• ปลายทางของ currentRouteSegment ไม่ตรงกับ DeliveryVehicle.remaining_vehicle_journey_segments[0].stop (gRPC) หรือ DeliveryVehicle.remainingVehicleJourneySegments[0].stop (REST)

• แอปคนขับไม่ได้อัปเดตตำแหน่งเมื่อเร็วๆ นี้ ค่าที่อัปเดตล่าสุดสำหรับฟิลด์นี้จึงอาจล้าสมัย

• แอปคนขับเพิ่งอัปเดตตำแหน่ง แต่ currentRouteSegment ล้าสมัยและชี้ไปยังจุดจอดรถก่อนหน้า

ในกรณีเหล่านี้ Fleet Engine จะป้อนข้อมูลในช่องนี้ด้วยเส้นทางจาก CameraStop ล่าสุดที่ผ่านไปยัง DeviceStop ที่กำลังจะมาถึง เพื่อให้แน่ใจว่าผู้ใช้ข้อมูลในช่องนี้ได้รับข้อมูลที่ดีที่สุดสําหรับเส้นทางปัจจุบันของยานพาหนะที่ใช้นำส่ง

สตริงที่เข้ารหัส Base64

object (LatLng)

ตำแหน่งที่ currentRouteSegment สิ้นสุด ปัจจุบันข้อมูลนี้ยังไม่ได้ป้อนโดยแอปไดรเวอร์ แต่คุณป้อนข้อมูลได้ในการเรียกใช้ deliveryVehicles.patch โดยจะเป็น LatLng จากป้ายจอดรถที่กำลังจะจอด หรือ LatLng สุดท้ายของ currentRouteSegment ก็ได้ จากนั้น Fleet Engine จะพยายามอย่างเต็มที่เพื่อหาค่า VehicleStop จริง

ระบบจะละเว้นช่องนี้ในการเรียกใช้ deliveryVehicles.patch หากช่อง currentRouteSegment ว่างเปล่า

integer

ระยะทางที่เหลือสำหรับการขับขี่ของ currentRouteSegment โดยปกติแล้วแอปไดรเวอร์จะระบุช่องนี้ แต่มีบางกรณีที่ Fleet Engine จะลบล้างค่าที่แอปส่ง ดูข้อมูลเพิ่มเติมได้ที่ DeliveryVehicle.current_route_segment ระบบจะแสดงผลช่องนี้ใน Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) หรือ Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST) สำหรับ Task ที่ใช้งานอยู่ทั้งหมดซึ่งกำหนดให้กับพาหนะการนำส่ง

Fleet Engine จะละเว้นช่องนี้ใน UpdateDeliveryVehicleRequest หากช่อง currentRouteSegment ว่างเปล่า

string (Duration format)

ระยะเวลาขับรถที่เหลืออยู่สำหรับ currentRouteSegment โดยปกติแล้วแอปไดรเวอร์จะระบุช่องนี้ แต่ก็มีบางกรณีที่ Fleet Engine จะลบล้างค่าที่แอปส่งมา ดูข้อมูลเพิ่มเติมได้ที่ DeliveryVehicle.current_route_segment ระบบจะแสดงผลช่องนี้ใน Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) หรือ Task.remainingVehicleJourneySegments[0].drivingDuration (REST) สำหรับงานทั้งหมดที่ทำงานอยู่ซึ่งกำหนดให้กับยานพาหนะการนำส่ง

Fleet Engine จะละเว้นช่องนี้ใน UpdateDeliveryVehicleRequest หากช่อง currentRouteSegment ว่างเปล่า

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

object (VehicleJourneySegment)

กลุ่มการเดินทางที่กำหนดให้กับยานพาหนะนำส่งนี้ โดยเริ่มจากตำแหน่งที่รายงานล่าสุดของยานพาหนะ ช่องนี้จะไม่แสดงในคำตอบของ deliveryVehicles.list

object (DeliveryVehicleAttribute)

รายการแอตทริบิวต์ยานพาหนะสำหรับนำส่งแบบกำหนดเอง ยานพาหนะสำหรับจัดส่งจะมีแอตทริบิวต์ได้สูงสุด 100 รายการ และแอตทริบิวต์แต่ละรายการต้องมีคีย์ที่ไม่ซ้ำกัน

enum (DeliveryVehicleType)

ประเภทของยานพาหนะที่ใช้นำส่ง หากไม่ได้ตั้งค่า ระบบจะใช้ค่าเริ่มต้นเป็น AUTO

{
  "key": string,
  "value": string,

  // Union field delivery_vehicle_attribute_value can be only one of the
  // following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field
  // delivery_vehicle_attribute_value.
}

string

คีย์ของแอตทริบิวต์

string

ค่าแอตทริบิวต์

string

ค่าแอตทริบิวต์ที่เป็นสตริง

หมายเหตุ: ช่องนี้เหมือนกับช่อง value ซึ่งจะเลิกใช้งานในที่สุด สำหรับวิธีการสร้างหรืออัปเดต คุณจะใช้ฟิลด์ใดก็ได้ แต่เราขอแนะนำอย่างยิ่งให้ใช้ stringValue หากตั้งค่าทั้ง stringValue และ value ค่าทั้งสองต้องเหมือนกัน ไม่เช่นนั้นระบบจะแสดงข้อผิดพลาด ระบบจะป้อนข้อมูลในช่องทั้ง 2 ช่องในคำตอบ

boolean

ค่าแอตทริบิวต์ประเภทบูลีน

number

ค่าแอตทริบิวต์ประเภท Double