Method: providers.trips.search

รับข้อมูลการเดินทางทั้งหมดสำหรับรถคันใดคันหนึ่ง

คำขอ HTTP

POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/trips:search

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
parent

string

ต้องระบุ ต้องอยู่ในรูปแบบ providers/{provider} ผู้ให้บริการต้องเป็นรหัสโปรเจ็กต์ (เช่น sample-cloud-project) ของโปรเจ็กต์ Google Cloud ที่บัญชีบริการที่ใช้การโทรนี้เป็นสมาชิก

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "header": {
    object (RequestHeader)
  },
  "vehicleId": string,
  "activeTripsOnly": boolean,
  "pageSize": integer,
  "pageToken": string,
  "minimumStaleness": string
}
ช่อง
header

object (RequestHeader)

ส่วนหัวคำขอ Fleet Engine มาตรฐาน
vehicleId

string

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

  • currentRouteSegment
  • remainingWaypoints
  • remainingDistanceMeters
  • etaToFirstWaypoint
activeTripsOnly

boolean

หากตั้งค่าเป็น "จริง" การตอบกลับจะรวม "การเดินทาง" ที่ส่งผลต่อเส้นทางของคนขับ
pageSize

integer

หากไม่ได้ตั้งค่า เซิร์ฟเวอร์จะกำหนดจำนวนผลลัพธ์ที่จะแสดง
pageToken

string

ตั้งค่านี้เป็นค่าที่เคยแสดงผลก่อนหน้านี้ใน SearchTripsResponse เพื่อดำเนินการต่อจากผลลัพธ์ก่อนหน้า
minimumStaleness

string (Duration format)

หากระบุไว้ ระบบจะแสดงผลการเดินทางที่ยังไม่ได้อัปเดตหลังจากวันที่ (current - minimumStaleness)

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

เนื้อหาการตอบกลับ

ข้อความตอบกลับ Tries.search

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "trips": [
    {
      object (Trip)
    }
  ],
  "nextPageToken": string
}
ช่อง
trips[]

object (Trip)

รายการการเดินทางสำหรับยานพาหนะที่ขอ
nextPageToken

string

ส่งโทเค็นนี้ใน SearchTripsRequest เพื่อไปยังหน้ารายการผลการค้นหา API จะส่งกลับรายการการเดินทางในการเรียกแต่ละครั้ง และเมื่อไม่มีผลลัพธ์เพิ่มเติมอีก รายการการเดินทางจะว่างเปล่า