SearchVehiclesLog

รายละเอียดเกี่ยวกับคำขอและคำตอบของ SearchVehicles

หมายเหตุ: บันทึกนี้อาจมีการแยกในช่องการจับคู่หากขนาดบันทึกทั้งหมดเกิน 256 KB ดูรายละเอียดเพิ่มเติมได้ที่แยกบันทึก

การแสดง JSON
{
  "request": {
    object (SearchVehiclesRequestLog)
  },
  "response": {
    object (SearchVehiclesResponseLog)
  },
  "errorResponse": {
    object (ErrorResponseLog)
  }
}
ช่อง
request

object (SearchVehiclesRequestLog)

คำขอที่ส่งไปยัง Fleet Engine

response

object (SearchVehiclesResponseLog)

คำตอบที่ส่งกลับไปยังไคลเอ็นต์ หากการเรียก RPC ทำให้เกิดข้อผิดพลาด ระบบจะไม่ตั้งค่าการตอบกลับ

errorResponse

object (ErrorResponseLog)

การตอบกลับข้อผิดพลาดที่ส่งกลับไปยังไคลเอ็นต์ ระบบจะไม่ตั้งค่าหากการเรียก RPC สําเร็จ

SearchVehiclesRequestLog

รายละเอียดเกี่ยวกับคำขอ SearchVehicles

การแสดง JSON
{
  "header": {
    object (RequestHeaderLog)
  },
  "pickupPoint": {
    object (TerminalLocationLog)
  },
  "dropoffPoint": {
    object (TerminalLocationLog)
  },
  "pickupRadiusMeters": integer,
  "count": integer,
  "minimumCapacity": integer,
  "searchTripTypes": [
    enum (TripTypeLog)
  ],
  "maximumStaleness": string,
  "vehicleTypes": [
    {
      object (VehicleTypeLog)
    }
  ],
  "requiredAttributes": [
    {
      object (VehicleAttributeLog)
    }
  ],
  "requiredOneOfAttributes": [
    {
      object (VehicleAttributeListLog)
    }
  ],
  "requiredOneOfAttributeSets": [
    {
      object (VehicleAttributeListLog)
    }
  ],
  "matchOrderBy": enum (VehicleMatchOrderLog),
  "includeBackToBack": boolean,
  "tripId": string,
  "filter": string
}
ช่อง
header

object (RequestHeaderLog)

ส่วนหัวของคำขอ

pickupPoint

object (TerminalLocationLog)

จุดรับสินค้าที่จะค้นหาใกล้ๆ

dropoffPoint

object (TerminalLocationLog)

สถานที่ส่งสินค้าที่ต้องการของลูกค้า

pickupRadiusMeters

integer

ระบุรัศมีการค้นหายานพาหนะรอบจุดรับ

count

integer

ระบุจำนวนยานพาหนะสูงสุดที่จะแสดง

minimumCapacity

integer

ระบุความจุขั้นต่ำของยานพาหนะที่ต้องใช้

searchTripTypes[]

enum (TripTypeLog)

จำกัดการค้นหาให้แสดงเฉพาะยานพาหนะที่รองรับประเภทการเดินทางที่ระบุอย่างน้อย 1 ประเภท

maximumStaleness

string (Duration format)

จำกัดการค้นหาให้เหลือเฉพาะยานพาหนะที่อัปเดตตำแหน่งภายในระยะเวลาที่ระบุนับจากนี้

ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย s เช่น "3.5s"

vehicleTypes[]

object (VehicleTypeLog)

ประเภทยานพาหนะที่ค้นหา

requiredAttributes[]

object (VehicleAttributeLog)

จำกัดการค้นหาเฉพาะยานพาหนะที่มีแอตทริบิวต์ที่ระบุ

requiredOneOfAttributes[]

object (VehicleAttributeListLog)

จำกัดการค้นหาเฉพาะยานพาหนะที่มีแอตทริบิวต์ที่ระบุอย่างน้อย 1 รายการซึ่งใช้กับ VehicleAttributeList แต่ละรายการ

requiredOneOfAttributeSets[]

object (VehicleAttributeListLog)

จำกัดการค้นหาเฉพาะยานพาหนะที่มีแอตทริบิวต์ที่ระบุอย่างน้อย 1 ชุดใน VehicleAttributeList

matchOrderBy

enum (VehicleMatchOrderLog)

ลําดับการจัดเรียงผลการค้นหา

includeBackToBack

boolean

ระบุว่ายานพาหนะที่อยู่ระหว่างการเดินทางมีสิทธิ์ได้รับการจับคู่อีกครั้งหรือไม่

tripId

string

รหัสของการเดินทางที่เชื่อมโยงกับ searchVehiclesRequest

filter

string

การค้นหา AIP-160 ที่จำกัดจำนวนยานพาหนะที่แสดงผลตามแอตทริบิวต์ยานพาหนะ

VehicleAttributeListLog

ประเภทข้อมูลลิสต์ของลิสต์สำหรับ VehicleAttributeLog

การแสดง JSON
{
  "attributes": [
    {
      object (VehicleAttributeLog)
    }
  ]
}
ช่อง
attributes[]

object (VehicleAttributeLog)

รายการแอตทริบิวต์ในคอลเล็กชันนี้

SearchVehiclesResponseLog

รายละเอียดในการตอบกลับ SearchVehicles

การแสดง JSON
{
  "matchIds": [
    string
  ],
  "matches": [
    {
      object (VehicleMatchLog)
    }
  ]
}
ช่อง
matchIds[]
(deprecated)

string

เลิกใช้งานแล้ว: รายการรหัสยานพาหนะสำหรับยานพาหนะที่ส่งคืน โปรดใช้ matches.vehicle.name เพื่อดึงข้อมูลรหัสนี้

matches[]

object (VehicleMatchLog)

รายการ VehicleMatches สำหรับยานพาหนะที่ส่งคืน

VehicleMatchLog

บันทึกของผลการค้นหา VehicleMatch ของ SearchVehicles

การแสดง JSON
{
  "vehicle": {
    object (VehicleLog)
  },
  "vehiclePickupEta": string,
  "vehiclePickupDistanceMeters": integer,
  "vehiclePickupStraightLineDistanceMeters": integer,
  "vehicleDropoffEta": string,
  "vehiclePickupToDropoffDistanceMeters": integer,
  "tripType": enum (TripTypeLog),
  "vehicleMatchType": enum (VehicleMatchTypeLog),
  "requestedOrderedBy": enum (VehicleMatchOrderLog),
  "orderedBy": enum (VehicleMatchOrderLog)
}
ช่อง
vehicle

object (VehicleLog)

ยานพาหนะที่ตรงกับคำขอ

vehiclePickupEta

string (Timestamp format)

เวลาถึงโดยประมาณของยานพาหนะในการขับรถไปยังจุดรับที่ระบุในคำขอ ค่าว่างบ่งบอกว่าคำนวณเวลาถึงโดยประมาณสำหรับยานพาหนะไม่สำเร็จ

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่างเช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

vehiclePickupDistanceMeters

integer

ระยะทางในการขับรถของยานพาหนะไปยังจุดรับที่ระบุในคำขอ รวมถึงจุดรับหรือจุดส่งระหว่างทางสำหรับการเดินทางที่มีอยู่ ค่าว่างบ่งบอกว่าคำนวณระยะทางของยานพาหนะไม่สำเร็จ

vehiclePickupStraightLineDistanceMeters

integer

ระยะทางตรงระหว่างยานพาหนะกับจุดรับลูกค้าที่ระบุในคำขอ รวมถึงจุดแวะพักระหว่างทางสำหรับการเดินทางที่มีอยู่

vehicleDropoffEta

string (Timestamp format)

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

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่างเช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

vehiclePickupToDropoffDistanceMeters

integer

ระยะทางขับรถ (เป็นเมตร) ของยานพาหนะจากจุดรับส่งที่ระบุในคำขอ ระยะทางคือระยะทางระหว่าง 2 จุดเท่านั้น โดยไม่รวมตำแหน่งของยานพาหนะหรือจุดแวะพักอื่นๆ ก่อนที่ยานพาหนะจะมาถึงจุดรับหรือจุดส่ง ระบบจะป้อนค่าก็ต่อเมื่อมีการระบุจุดส่งในคำขอเท่านั้น ค่าว่างบ่งชี้ว่าคำนวณระยะทางจากจุดรับส่งที่ระบุในคำขอไม่สำเร็จ

tripType

enum (TripTypeLog)

ประเภทการเดินทางของคำขอที่ใช้คำนวณเวลาถึงจุดรับ

vehicleMatchType

enum (VehicleMatchTypeLog)

ประเภทการจับคู่ยานพาหนะ

requestedOrderedBy

enum (VehicleMatchOrderLog)

วิธีที่ผู้โทรขอจัดเรียงการจับคู่ยานพาหนะ

orderedBy

enum (VehicleMatchOrderLog)

วิธีการจริงที่ใช้สั่งซื้อยานพาหนะนี้ โดยปกติแล้ว ฟิลด์นี้จะจับคู่กับฟิลด์ "order_by" จากคำขอ อย่างไรก็ตาม ในบางกรณี เช่น แบ็กเอนด์ของ Google Maps ไม่ทำงาน ระบบอาจใช้วิธีอื่น (เช่น PICKUP_POINT_STRAIGHT_DISTANCE)