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