Method: providers.trips.get

取得單一行程的相關資訊。

HTTP 要求

GET https://fleetengine.googleapis.com/v1/{name=providers/*/trips/*}

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
name

string

必要欄位。格式須為 providers/{provider}/trips/{trip}。提供者必須是發出此呼叫的服務帳戶所屬 Google Cloud 專案的專案 ID (例如 sample-cloud-project)。

查詢參數

參數
header

object (RequestHeader)

標準 Fleet Engine 要求標頭。
view

enum (TripView)

應傳回的行程欄位子集和解讀內容。
currentRouteSegmentVersion

string (Timestamp format)

指出擷取 Trip.route 或 Trip.current_route_segment 資料的最小時間戳記 (不含)。如果從此時間戳記之後的路線資料維持不變，則回應中不會設定路線欄位。如果未指定最小值，系統一律會擷取路線資料。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
remainingWaypointsVersion

string (Timestamp format)

指出擷取 Trip.remaining_waypoints 的最小時間戳記 (不含)。如果從這個時間戳記後未發生任何變化，則不會在回應中設定 remainingWaypoints。如未指定這個欄位，系統一律會擷取 remainingWaypoints。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
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 欄位。如果未指定最小值，系統一律會擷取流量資料。請注意，只有隨選乘車和運送服務解決方案客戶才能查詢路況。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
remainingWaypointsRouteVersion

string (Timestamp format)

指出擷取 Trip.remaining_waypoints.traffic_to_waypoint 和 Trip.remaining_waypoints.path_to_waypoint 資料的最小時間戳記 (不含)。如果自此時間戳記後資料維持不變，則回應中不會設定以上欄位。如果未指定 remainingWaypointsRouteVersion，一律會擷取流量和路徑。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

要求主體

要求主體必須為空白。

回應主體

如果成功，回應主體會包含 Trip 的執行例項。

PolylineFormatType

折線格式的類型。

列舉
UNKNOWN_FORMAT_TYPE 未指定或不明格式。
LAT_LNG_LIST_TYPE google.type.LatLng 清單。
ENCODED_POLYLINE_TYPE 使用折線壓縮演算法編碼的折線。目前不支援解碼。