REST Resource: providers.deliveryVehicles

Resource: 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 ล้าสมัยและชี้ไปยังจุดจอดรถก่อนหน้า

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

สตริงที่เข้ารหัส 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 ใหม่

get

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

list

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

patch

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