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

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

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

object (LatLng)

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

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

integer

ระยะทางการขับรถที่เหลือสำหรับ currentRouteSegment โดยปกติแล้วแอป Driver จะให้ข้อมูลช่องนี้ แต่มีบางกรณีที่ 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 โดยปกติแล้วแอป Driver จะให้ข้อมูลช่องนี้ แต่มีบางกรณีที่ 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

อธิบายแอตทริบิวต์ยานพาหนะเป็นคู่คีย์-ค่า สตริง "key:value" ต้องไม่เกิน 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 รายการต้องเหมือนกัน ไม่เช่นนั้นระบบจะแสดงข้อผิดพลาด ระบบจะเติมข้อมูลให้กับทั้ง 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