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 使用折線壓縮演算法編碼的折線。目前不支援解碼。