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)

返される Trip フィールドのサブセットとその解釈。

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