SearchVehiclesResponse

vehicles.search レスポンス メッセージ。

JSON 表現
{
  "matches": [
    {
      object (VehicleMatch)
    }
  ]
}
フィールド
matches[]

object (VehicleMatch)

SearchVehiclesRequest 条件に一致する車両のリスト。SearchVehiclesRequest.order_by フィールドに基づいて並べ替えられます。

VehicleMatch

車両 SearchVehiclesRequest の有効なルートのポイントに一致する車両の車両と関連する推定値が含まれます。

JSON 表現
{
  "vehicle": {
    object (Vehicle)
  },
  "vehiclePickupEta": string,
  "vehiclePickupDistanceMeters": integer,
  "vehiclePickupStraightLineDistanceMeters": integer,
  "vehicleDropoffEta": string,
  "vehiclePickupToDropoffDistanceMeters": integer,
  "tripType": enum (TripType),
  "vehicleTripsWaypoints": [
    {
      object (Waypoint)
    }
  ],
  "vehicleMatchType": enum (VehicleMatchType),
  "requestedOrderedBy": enum (VehicleMatchOrder),
  "orderedBy": enum (VehicleMatchOrder)
}
フィールド
vehicle

object (Vehicle)

必須。リクエストに一致する車両。

vehiclePickupEta

string (Timestamp format)

リクエストで指定された乗車場所までの車両の運転 ETA。空の値は、車両の到着予定時刻を計算できなかったことを示します。SearchVehiclesRequest.include_back_to_backtrue で、この車両に有効なルートがある場合、vehiclePickupEta には現在のアクティブなルートを完了するために必要な時間が含まれます。

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

vehiclePickupDistanceMeters

integer

車両の現在地からリクエストで指定された乗車ポイントまでの距離(既存のルートの中間乗車地点または降車地点を含む)。この距離は、計算された運転(ルート)距離と、ナビゲーションの終点とリクエストされた乗車ポイントの間の直線距離で構成されます。(ナビゲーションの終点からリクエストされた乗車ポイントまでの距離は通常短いです)。空の値は、距離の計算でエラーが発生したことを示します。

vehiclePickupStraightLineDistanceMeters

integer

必須。リクエストで指定された乗車場所から車両までの直線距離。

vehicleDropoffEta

string (Timestamp format)

リクエストで指定された降車場所までの車両の到着予定時刻。ETA には、リクエストで指定された dropoffPoint の前にある任意の地点での停車地も含まれます。この値は、降車地点がリクエストで指定されている場合にのみ入力されます。空の値は、到着予定時刻の計算中にエラーが発生したことを示します。

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

vehiclePickupToDropoffDistanceMeters

integer

リクエストで指定された乗車地点から降車地点までの車両の走行距離(メートル単位)。距離は 2 地点間の範囲のみであり、車両の位置や、車両が乗車ポイントまたは降車地点を訪問する前に訪問する必要があるその他のポイントは含まれません。この値は、リクエストで dropoffPoint が指定されている場合にのみ入力されます。空の値は、リクエストで指定された乗車地点から降車地点までの距離を計算できなかったことを示します。

tripType

enum (TripType)

必須。乗車場所までの到着予定時刻を計算するために使用されたリクエストのルートタイプ。

vehicleTripsWaypoints[]

object (Waypoint)

到着予定時刻の計算に使用されるウェイポイントの順序付きリスト。このリストには、車両の位置情報、車両のアクティブなルートの乗車地点、リクエストで提供された乗車地点が含まれます。空のリストは、車両の到着予定時刻を計算できなかったことを示します。

vehicleMatchType

enum (VehicleMatchType)

車両の一致タイプ。

requestedOrderedBy

enum (VehicleMatchOrder)

車両の一致の並べ替えにリクエストされた順序。

orderedBy

enum (VehicleMatchOrder)

この車両に使用された実際の注文。通常、これはリクエストの「orderBy」フィールドと一致しますが、内部サーバーエラーなどの特定の状況では、別のメソッド(PICKUP_POINT_STRAIGHT_DISTANCE など)が使用されることがあります。

ウェイポイント

SearchVehiclesResponseVehicleMatch のルートに沿った中間点を記述します。このコンセプトは、他のすべてのエンドポイントで TripWaypoint として表されます。

JSON 表現
{
  "latLng": {
    object (LatLng)
  },
  "eta": string
}
フィールド
latLng

object (LatLng)

このウェイポイントの位置。

eta

string (Timestamp format)

車両がこの地点に到着する推定時刻。

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

VehicleMatchType

車両の一致タイプ。

列挙型
UNKNOWN 不明な車両マッチタイプ
EXCLUSIVE 車両には現在ルートが割り当てられておらず、乗車地点に進むことができます。
BACK_TO_BACK 車両は現在ルートに割り当てられていますが、進行中のルートの完了後に乗車地点に進むことができます。到着予定時刻と距離の計算では、既存のルートが考慮されます。
CARPOOL 相乗りに十分なキャパシティがある。
CARPOOL_BACK_TO_BACK 車両は、乗車地点より前に現在のアクティブなルートを終了します。到着予定時刻と距離の計算では、既存のルートが考慮されます。