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

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

remainingWaypointsVersion

string (Timestamp format)

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

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

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 フィールドが設定されません。最小値が指定されていない場合、常にトラフィック データが取得されます。交通状況を利用できるのは、オンデマンド配車および配達ソリューションのお客様のみです。

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