הצגת כל הנסיעות ברכב מסוים.
בקשת 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 |
אם צוינה אפשרות, המערכת תחזיר את הנסיעות שלא עודכנו אחרי השעה משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-' |
גוף התשובה
הודעת תגובה של Travel.search.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{
"trips": [
{
object ( |
שדות | |
---|---|
trips[] |
רשימת הנסיעות של הרכב המבוקש. |
nextPageToken |
מעבירים את האסימון הזה ב-SearchTripsRequest לדף דרך תוצאות הרשימה. ה-API מחזיר רשימת נסיעות בכל שיחה, וכשלא נותרו תוצאות נוספות רשימת הנסיעות ריקה. |