הצגת כל הנסיעות של רכב מסוים.
בקשת HTTP
POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/trips:search
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
parent |
חובה. חייב להיות בפורמט |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"header": {
object ( |
שדות | |
---|---|
header |
כותרת הבקשה הרגילה של Fleet Engine. |
vehicleId |
הרכב שמשויך לנסיעות שצוינו בבקשה. אם לא צוין, הנסיעות שהוחזרו לא יכללו:
|
activeTripsOnly |
אם היא מוגדרת כ-True, התשובה תכלול נסיעות שמשפיעות על מסלול הנהג. |
pageSize |
אם המדיניות לא מוגדרת, השרת קובע את מספר התוצאות שיוחזרו. |
pageToken |
יש להגדיר זאת לערך שהוחזר בעבר ב- |
minimumStaleness |
אם צוין, מוחזרת הנסיעות שלא עודכנו אחרי התאריך משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, המסתיים ב-' |
גוף התגובה
הודעת התשובה של Trips.search.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{
"trips": [
{
object ( |
שדות | |
---|---|
trips[] |
רשימת הנסיעות עבור הרכב המבוקש. |
nextPageToken |
מעבירים את האסימון הזה ב-SearchTripsRequest לדף בין התוצאות ברשימה. ה-API מחזיר רשימת נסיעות בכל קריאה, ואם לא נותרו תוצאות, רשימת הנסיעות ריקה. |