Method: providers.trips.get

1 回のルートに関する情報を取得します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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 データが取得される最小タイムスタンプ（除く）を示します。このタイムスタンプ以降にルートデータが変更されていない場合、レスポンスでルート フィールドは設定されません。最小値が指定されていない場合、ルートデータは常に取得されます。

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 ポリライン圧縮アルゴリズムでエンコードされたポリライン。デコードはまだサポートされていません。