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)

應傳回的 Trip 欄位子集及其解讀方式。
currentRouteSegmentVersion

string (Timestamp format)

表示擷取 Trip.route 或 Trip.current_route_segment 資料的最低時間戳記 (不含)。如果路線資料自此時間戳記以來未變更，回應中就不會設定路線欄位。如果未指定最低值，系統一律會擷取路線資料。

RFC3339 世界標準時間「Zulu」格式的時間戳記，精確度達奈秒單位，最多九個小數位數。例如 "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」格式的時間戳記，精確度達奈秒單位，最多九個小數位數。例如 "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」格式的時間戳記，精確度達奈秒單位，最多九個小數位數。範例："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 使用折線壓縮演算法編碼的折線。目前不支援解碼。