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"

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

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

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

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

object (Trip)

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

nextPageToken

string

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