Method: providers.vehicles.get
HTTP 要求
GET https://fleetengine.googleapis.com/v1/{name=providers/*/vehicles/*}
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
name |
string
必要欄位。格式必須為 providers/{provider}/vehicles/{vehicle} 。供應者必須是發出此呼叫的服務帳戶所屬 Google Cloud 專案的專案 ID (例如 sample-cloud-project )。
|
查詢參數
參數 |
header |
object (RequestHeader )
標準 Fleet Engine 要求標頭。
|
currentRouteSegmentVersion |
string (Timestamp format)
表示擷取 Vehicle.current_route_segment 時的最低時間戳記 (不含)。如果路線自此時間戳記起未變更,回應中就不會設定 currentRouteSegment 欄位。如果未指定最小值,系統一律會擷取 currentRouteSegment 。 使用 RFC 3339,產生的輸出內容一律會經過 Z 規格化,並使用 0、3、6 或 9 小數位數。系統也接受「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 小數位數。系統也接受「Z」以外的偏移值。例如:"2014-10-02T15:01:23Z" 、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30" 。
|
回應主體
如果成功,回應主體會包含 Vehicle
的執行例項。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-02-26 (世界標準時間)。
[null,null,["上次更新時間:2025-02-26 (世界標準時間)。"],[[["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"]]