REST Resource: providers.deliveryVehicles

ทรัพยากร: DeliveryVehicle

ข้อความ DeliveryVehicle รถนำส่งจะขนส่งพัสดุจากคลังสินค้าไปยังสถานที่นำส่งและจากจุดรับไปยังคลังสินค้า ในบางกรณี รถนำส่งจะขนส่งสินค้าจากจุดรับสินค้าไปยังจุดนำส่งโดยตรงด้วย

หมายเหตุ: gRPC และ REST API ใช้รูปแบบการตั้งชื่อฟิลด์ที่แตกต่างกัน เช่น ช่อง DeliveryVehicle.current_route_segment ใน gRPC API และช่อง DeliveryVehicle.currentRouteSegment ใน REST API จะอ้างอิงถึงช่องเดียวกัน

การแสดง JSON 
{
  "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)
}
ช่อง
name

string

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

object (DeliveryVehicleLocation)

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

enum (DeliveryVehicleNavigationStatus)

สถานะการนำทางของรถนำส่ง
currentRouteSegment

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 ไม่มีอัปเดต และชี้ไปที่จุดจอดรถก่อนหน้า

ในกรณีเหล่านี้ เครื่องยนต์ของฝูงรถจะป้อนข้อมูลเส้นทางจาก VehicleStop ที่เพิ่งผ่านมาล่าสุดไปยัง VehicleStop ที่กําลังจะมาถึงในช่องนี้ เพื่อให้ผู้บริโภคของช่องนี้มีข้อมูลที่ดีที่สุดเกี่ยวกับเส้นทางปัจจุบันของยานพาหนะนำส่ง

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

object (LatLng)

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

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

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 ว่างเปล่า
remainingDuration

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"
remainingVehicleJourneySegments[]

object (VehicleJourneySegment)

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

object (DeliveryVehicleAttribute)

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

enum (DeliveryVehicleType)

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

DeliveryVehicleNavigationStatus

สถานะการนำทางของรถ

Enum
UNKNOWN_NAVIGATION_STATUS สถานะการนำทางที่ไม่ระบุ
NO_GUIDANCE การนําทางของแอปคนขับรถอยู่ในโหมด FREE_NAV
ENROUTE_TO_DESTINATION การนำทางแบบเลี้ยวต่อเลี้ยวพร้อมใช้งานและการนำทางในแอปคนขับเข้าสู่โหมด GUIDED_NAV
OFF_ROUTE ยานพาหนะออกนอกเส้นทางที่แนะนำ
ARRIVED_AT_DESTINATION รถจะอยู่ห่างจากจุดหมายภายในระยะประมาณ 50 เมตร

DeliveryVehicleAttribute

อธิบายแอตทริบิวต์ยานพาหนะเป็นคู่คีย์-ค่า ความยาวสตริง "คีย์:ค่า" ต้องไม่เกิน 256 อักขระ

การแสดง JSON 
{
  "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.
}
ช่อง
key

string

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

string

ค่าแอตทริบิวต์
ช่องการรวม delivery_vehicle_attribute_value ค่าของแอตทริบิวต์อาจเป็นสตริง บูลีน หรือประเภท Double delivery_vehicle_attribute_value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
stringValue

string

ค่าแอตทริบิวต์ที่พิมพ์โดยสตริง

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

boolean

ค่าแอตทริบิวต์ที่พิมพ์ด้วยบูลีน
numberValue

number

ค่าแอตทริบิวต์การพิมพ์คู่

DeliveryVehicleType

ประเภทยานพาหนะที่ใช้นำส่ง

Enum
DELIVERY_VEHICLE_TYPE_UNSPECIFIED ค่านี้ไม่ได้นำไปใช้งาน
AUTO รถยนต์
TWO_WHEELER รถจักรยานยนต์ โมเพด หรือยานพาหนะ 2 ล้ออื่นๆ
BICYCLE การขนย้ายที่ขับเคลื่อนด้วยแรงมนุษย์
PEDESTRIAN ผู้ขนส่งที่เป็นมนุษย์ซึ่งโดยทั่วไปจะเดินหรือวิ่ง สัญจรไปตามทางเท้า

เมธอด

create

 สร้างและแสดงผล DeliveryVehicle ใหม่

get

 แสดงผลอินสแตนซ์ DeliveryVehicle ที่ระบุ

list

 รับ DeliveryVehicle ทั้งหมดที่ตรงกับเกณฑ์การกรองที่ระบุ

patch

 เขียนข้อมูล DeliveryVehicle ที่อัปเดตแล้วไปยัง Fleet Engine และกำหนด Tasks ให้กับ DeliveryVehicle