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 資料的最低時間戳記 (不含)。如果路線資料自此時間戳記起未變更，回應中就不會設定路線欄位。如果未指定最低值，系統一律會擷取路線資料。

使用 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"。
remainingWaypointsVersion
(deprecated)

string (Timestamp format)

已淘汰：系統一律會擷取 Trip.remaining_waypoints。使用 remainingWaypointsRouteVersion 控管 Trip.remaining_waypoints.traffic_to_waypoint 和 Trip.remaining_waypoints.path_to_waypoint 資料的擷取時機。

使用 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"。
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 欄位。如果未指定最低值，系統一律會擷取流量資料。請注意，只有隨選乘車與運送服務解決方案的客戶可以使用流量。

使用 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"。
remainingWaypointsRouteVersion

string (Timestamp format)

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

使用 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"。

要求主體

要求主體必須為空白。

回應主體

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

PolylineFormatType

折線格式的類型。

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