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

string (Timestamp format)

Trip.remaining_waypoints が取得される最小タイムスタンプ(除外)を示します。このタイムスタンプ以降に変更されていない場合、remainingWaypoints はレスポンスに設定されません。このフィールドが指定されていない場合、常に remainingWaypoints が取得されます。

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