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)
  },
  "pastLocations": [
    {
      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)

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

object (DeliveryVehicleLocation)

อินพุตเท่านั้น ตำแหน่งที่รถนำส่งคันนี้เคยอยู่ซึ่งยังไม่ได้รายงานไปยัง Fleet Engine ข้อมูลนี้ใช้ใน UpdateDeliveryVehicleRequest เพื่อบันทึกตำแหน่งที่ก่อนหน้านี้ไม่สามารถส่งไปยังเซิร์ฟเวอร์ได้ ซึ่งมักเกิดขึ้นเมื่อยานพาหนะนำส่งไม่มีการเชื่อมต่ออินเทอร์เน็ต
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 ค่าของแอตทริบิวต์อาจเป็นสตริง บูลีน หรือเลขทศนิยม delivery_vehicle_attribute_value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
stringValue

string

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

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

boolean

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

number

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

DeliveryVehicleType

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

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

เมธอด

create

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

delete

 ลบ DeliveryVehicle ออกจาก Fleet Engine

get

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

list

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

patch

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