Method: providers.trips.get
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בקשת HTTP
GET https://fleetengine.googleapis.com/v1/{name=providers/*/trips/*}
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
| פרמטרים |
name |
string
חובה. הפורמט הנדרש הוא providers/{provider}/trips/{trip}. הספק חייב להיות מזהה הפרויקט (לדוגמה, sample-cloud-project) של פרויקט Google Cloud שבו חשבון השירות שמבצע את הקריאה הזו הוא חבר.
|
פרמטרים של שאילתה
| פרמטרים |
header |
object (RequestHeader)
כותרת הבקשה הרגילה של Fleet Engine.
|
view |
enum (TripView)
קבוצת המשנה של שדות הנסיעה שצריך להחזיר והפרשנות שלהם.
|
currentRouteSegmentVersion |
string (Timestamp format)
מציין את חותמת הזמן המינימלית (לא כולל) שלגביה מתבצעת אחזור של נתוני Trip.route או Trip.current_route_segment. אם נתוני המסלול לא השתנו מאז חותמת הזמן הזו, שדה המסלול לא מוגדר בתגובה. אם לא מציינים ערך מינימלי, נתוני המסלול מאוחזרים תמיד. הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
|
remainingWaypointsVersion
(deprecated) |
string (Timestamp format)
הוצא משימוש: Trip.remaining_waypoints תמיד מאוחזרים. אפשר להשתמש ב-remainingWaypointsRouteVersion כדי לקבוע מתי המערכת תאחזר את הנתונים של Trip.remaining_waypoints.traffic_to_waypoint ו-Trip.remaining_waypoints.path_to_waypoint. הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
|
routeFormatType |
enum (PolylineFormatType)
הפורמט של המסלול הנוכחי שמוחזר, LAT_LNG_LIST_TYPE (ב-Trip.route) או ENCODED_POLYLINE_TYPE (ב-Trip.current_route_segment). ברירת המחדל היא LAT_LNG_LIST_TYPE.
|
currentRouteSegmentTrafficVersion |
string (Timestamp format)
מציין את חותמת הזמן המינימלית (לא כולל) שלגביה מתבצע אחזור של Trip.current_route_segment_traffic. אם נתוני התנועה לא השתנו מאז חותמת הזמן הזו, השדה currentRouteSegmentTraffic לא מוגדר בתגובה. אם לא צוין מינימום, נתוני התנועה תמיד מאוחזרים. לתשומת ליבכם: התכונה 'תנועה' זמינה רק ללקוחות עם פתרון לנסיעות ולמשלוחים על פי דרישה. הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
|
remainingWaypointsRouteVersion |
string (Timestamp format)
מציין את חותמת הזמן המינימלית (לא כולל) שלגביה מתבצע אחזור של נתוני Trip.remaining_waypoints.traffic_to_waypoint ו-Trip.remaining_waypoints.path_to_waypoint. אם הנתונים לא השתנו מאז חותמת הזמן הזו, השדות שלמעלה לא מוגדרים בתגובה. אם לא מציינים את remainingWaypointsRouteVersion, תמיד מתבצעת אחזור של התנועה והנתיב. הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
אם הפעולה מצליחה, גוף התגובה מכיל מופע של Trip.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-31 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-08-31 (שעון UTC)."],[[["\u003cp\u003eRetrieves detailed trip information for a specified provider and trip ID.\u003c/p\u003e\n"],["\u003cp\u003eAllows customization of the data returned using query parameters such as \u003ccode\u003eview\u003c/code\u003e, \u003ccode\u003erouteFormatType\u003c/code\u003e, and various version parameters.\u003c/p\u003e\n"],["\u003cp\u003eRequires an empty request body and a valid \u003ccode\u003ename\u003c/code\u003e path parameter in the format \u003ccode\u003eproviders/{provider}/trips/{trip}\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eIf successful, the response includes a \u003ccode\u003eTrip\u003c/code\u003e object containing comprehensive trip details.\u003c/p\u003e\n"],["\u003cp\u003eOffers the flexibility to request routes in either \u003ccode\u003eLAT_LNG_LIST_TYPE\u003c/code\u003e or \u003ccode\u003eENCODED_POLYLINE_TYPE\u003c/code\u003e format.\u003c/p\u003e\n"]]],[],null,[]]
