REST Resource: providers.trips

{
  "name": string,
  "vehicleId": string,
  "tripStatus": enum (TripStatus),
  "tripType": enum (TripType),
  "pickupPoint": {
    object (TerminalLocation)
  },
  "actualPickupPoint": {
    object (StopLocation)
  },
  "actualPickupArrivalPoint": {
    object (StopLocation)
  },
  "pickupTime": string,
  "intermediateDestinations": [
    {
      object (TerminalLocation)
    }
  ],
  "intermediateDestinationsVersion": string,
  "intermediateDestinationIndex": integer,
  "actualIntermediateDestinationArrivalPoints": [
    {
      object (StopLocation)
    }
  ],
  "actualIntermediateDestinations": [
    {
      object (StopLocation)
    }
  ],
  "dropoffPoint": {
    object (TerminalLocation)
  },
  "actualDropoffPoint": {
    object (StopLocation)
  },
  "dropoffTime": string,
  "remainingWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "vehicleWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "route": [
    {
      object (LatLng)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentTraffic": {
    object (ConsumableTrafficPolyline)
  },
  "currentRouteSegmentTrafficVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeToFirstWaypoint": string,
  "remainingWaypointsVersion": string,
  "remainingWaypointsRouteVersion": string,
  "numberOfPassengers": integer,
  "lastLocation": {
    object (VehicleLocation)
  },
  "lastLocationSnappable": boolean,
  "view": enum (TripView)
}

string

出力専用。形式は「providers/{provider}/trips/{trip}」です。

string

このルートを行う車両の ID。

enum (TripStatus)

ルートの現在のステータス。

enum (TripType)

ルートのタイプ。

object (TerminalLocation)

お客様が集荷すると示している場所。

object (StopLocation)

入力のみの顧客が迎えに来た実際の場所。このフィールドは、プロバイダが実際の受け取り情報に関するフィードバックを提供するためのものです。

object (StopLocation)

入力のみのドライバーが乗車地点に到着した実際の時刻と場所。このフィールドは、乗車地点での実際の到着情報についてプロバイダがフィードバックを提供するためのものです。

string (Timestamp format)

出力専用。乗客が乗車する推定時刻、または乗車時刻の実際の時刻のいずれかを指定します。

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

object (TerminalLocation)

ルートで（乗車と降車に加えて）中間地点の停車地。最初は共有ルートではサポートされません。

string (Timestamp format)

intermediateDestinations が最後に変更された時刻を示します。サーバーでは、intermediateDestinations が変更されないようにするために、intermediateDestinationIndex の更新時にこの値をキャッシュに保存し、UpdateTripRequest に渡す必要があります。

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

integer

TripStatus が ENROUTE_TO_INTERMEDIATE_DESTINATION の場合、車両が次に通過する中間目的地を示す [0..N-1] の数値。TripStatus が ARRIVED_AT_INTERMEDIATE_DESTINATION の場合、車両がどの中間目的地にいるかを示す [0..N-1] の数値。この値はプロバイダによって設定されます。intermediateDestinations がない場合、このフィールドは無視されます。

object (StopLocation)

入力のみの中間目的地にドライバーが到着した実際の時刻と場所。このフィールドは、中間地点の実際の到着情報に関するフィードバックを提供するために使用します。

object (StopLocation)

入力のみの顧客が中間地点で乗車した実際の時刻と場所。このフィールドは、中間目的地での実際の乗車情報に関するフィードバックを提供するために使用します。

object (TerminalLocation)

お客様が降車すると示されている場所。

object (StopLocation)

入力のみのお客様が降車した実際の時刻と場所。このフィールドは、プロバイダが実際の降車情報に関するフィードバックを提供するためのものです。

string (Timestamp format)

出力専用。乗客が最終目的地で降車される推定時刻、または実際に降車される時刻のいずれか。

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

object (TripWaypoint)

出力専用。現在地から降車地点までのフルパス（両端を含む）。この経路には、他のルートのウェイポイントが含まれる場合があります。

object (TripWaypoint)

このフィールドでは、ルートのウェイポイントの手動順序付けがサポートされています。割り当てられている車両の残りのすべての地点と、そのルートの乗車地点と降車地点がすべて含まれます。ルートが車両に割り当てられていない場合、このフィールドは無視されます。プライバシー上の理由から、このフィールドは trips.update 呼び出しと trips.create 呼び出しでのみサーバーによって設定され、trips.get 呼び出しでは設定されません。

object (LatLng)

出力専用。このルートで、残りの Waypoint の最初の通過地点までの予想ルート。最初のウェイポイントは別のルートに属している可能性があります。

string

出力専用。次のウェイポイントへのエンコードされたパス。

注: このフィールドは、Driver SDK と Consumer SDK による使用のみを目的としています。デコードはまだサポートされていません。

string (Timestamp format)

出力専用。ルートが最後に変更された時刻を示します。

注: このフィールドは、Driver SDK と Consumer SDK による使用のみを目的としています。

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

object (ConsumableTrafficPolyline)

出力専用。currentRouteSegment 沿いの交通状況を表示します（利用可能な場合）。

注: このフィールドは、Driver SDK と Consumer SDK による使用のみを目的としています。

string (Timestamp format)

出力専用。currentRouteSegmentTraffic が最後に変更された時刻を示します。

注: このフィールドは、Driver SDK と Consumer SDK による使用のみを目的としています。

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

object (TripWaypoint)

出力専用。currentRouteSegment の終点となる地点。

integer

出力専用。currentRouteSegment フィールドの残りの走行距離。ルートが車両に割り当てられていない場合、ルートが完了またはキャンセルされた場合、値は指定されません。

string (Timestamp format)

出力専用。次の地点（remainingWaypoints フィールドの最初のエントリ）までの到着予定時刻。ルートが車両に割り当てられていない場合、またはルートが無効（完了またはキャンセルされた）の場合、値は指定されません。

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

string (Duration format)

出力専用。ルートデータが返された時点から Trip.eta_to_first_waypoint の時点までの時間。ルートが車両に割り当てられていない場合、またはルートが無効（完了またはキャンセルされた）の場合、値は指定されません。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"。

string (Timestamp format)

出力専用。remainingWaypoints が最後に変更された時刻（ウェイポイントが追加、削除、変更された時刻）を示します。

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

string (Timestamp format)

出力専用。remainingWaypoints.path_to_waypoint と remainingWaypoints.traffic_to_waypoint が最後に変更された時刻を示します。クライアント アプリはこの値をキャッシュに保存して GetTripRequest に渡して、remainingWaypoints のパスとトラフィックが更新された場合にのみ返されるようにする必要があります。

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

integer

変更不可。このルートの乗客数を示します。運転手は含まれません。車両が vehicles.search レスポンスで返されるには、利用可能な容量が必要です。

object (VehicleLocation)

出力専用。ルート上で最後に報告された車両の位置を示します。

boolean

出力専用。車両の lastLocation を currentRouteSegment にスナップできるかどうかを示します。lastLocation または currentRouteSegment が存在しない場合は false。Fleet Engine によって計算されます。クライアントからの更新は無視されます。

enum (TripView)

入力される Trip フィールドのサブセットと、それらの解釈方法。

{
  "point": {
    object (LatLng)
  },
  "timestamp": string,
  "stopTime": string
}

object (LatLng)

必須。実際の場所を示します。

string (Timestamp format)

停止が行われた時間を示します。

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

string (Timestamp format)

入力のみの非推奨です。タイムスタンプ フィールドを使用します。

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