Method: providers.vehicles.get
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
הפונקציה מחזירה רכב מ-Fleet Engine.
בקשת HTTP
GET https://fleetengine.googleapis.com/v1/{name=providers/*/vehicles/*}
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
| פרמטרים |
name |
string
חובה. הפורמט הנדרש הוא providers/{provider}/vehicles/{vehicle}. הספק חייב להיות מזהה הפרויקט (לדוגמה, sample-cloud-project) של פרויקט Google Cloud שבו חשבון השירות שמבצע את הקריאה הזו הוא חבר.
|
פרמטרים של שאילתה
| פרמטרים |
header |
object (RequestHeader)
כותרת הבקשה הרגילה של Fleet Engine.
|
currentRouteSegmentVersion |
string (Timestamp format)
מציין את חותמת הזמן המינימלית (לא כולל) שלגביה מתבצע אחזור של Vehicle.current_route_segment. אם המסלול לא השתנה מאז חותמת הזמן הזו, השדה currentRouteSegment לא מוגדר בתגובה. אם לא צוין ערך מינימלי, הערך של currentRouteSegment תמיד מאוחזר. הפורמט הזה משתמש ב-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".
|
waypointsVersion |
string (Timestamp format)
מציין את חותמת הזמן המינימלית (לא כולל) שלגביה מתבצע אחזור של נתוני Vehicle.waypoints. אם נקודות הדרך לא השתנו מאז חותמת הזמן הזו, נתוני vehicle.waypoints לא מוגדרים בתגובה. אם לא מציינים את השדה הזה, תמיד מתבצע אחזור של vehicle.waypoints. הפורמט הזה משתמש ב-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".
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
אם הפעולה מצליחה, גוף התגובה מכיל מופע של Vehicle.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-02-26 (שעון 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-02-26 (שעון UTC)."],[[["Retrieves a vehicle's real-time information, such as location and status, from the Fleet Engine."],["Requires specifying the provider and vehicle IDs in the URL path."],["Optionally, allows filtering the retrieved data by timestamps for route segment and waypoints."],["Request body should be left empty."],["A successful response provides detailed vehicle data including its current state and attributes."]]],["This document details retrieving a vehicle from the Fleet Engine using a `GET` request. The URL format is `https://fleetengine.googleapis.com/v1/{name=providers/*/vehicles/*}`, with the `name` path parameter specifying the provider and vehicle. Query parameters include `header` for the Fleet Engine request header, `currentRouteSegmentVersion` and `waypointsVersion` which allow for conditional data retrieval based on timestamps. The request body is empty, and a successful response contains a `Vehicle` instance.\n"]]
