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 ที่กำลังจะมาถึง เพื่อให้แน่ใจว่าผู้ใช้ข้อมูลในช่องนี้ได้รับข้อมูลที่ดีที่สุดสําหรับเส้นทางปัจจุบันของยานพาหนะที่ใช้นำส่ง

สตริงที่เข้ารหัสฐาน 64

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