リソース: Trip
ルートのメタデータ。
JSON 表現 |
---|
{ "name": string, "vehicleId": string, "tripStatus": enum ( |
フィールド | |
---|---|
name |
出力のみ。形式は「providers/{provider}/trips/{trip}」です。 |
vehicleId |
このルートを走行する車両の ID。 |
tripStatus |
ルートの現在のステータス。 |
tripType |
ルートのタイプ。 |
pickupPoint |
お客様が集荷場所と指定した場所。 |
actualPickupPoint |
入力のみ。お客様が集荷した実際の場所。このフィールドは、実際のピックアップ情報に関するフィードバックを提供する事業者が使用します。 |
actualPickupArrivalPoint |
入力のみ。ドライバーが乗車地点に到着する実際の時間と場所。このフィールドは、ピックアップ地点での実際の到着情報について、プロバイダがフィードバックを提供するためのものです。 |
pickupTime |
出力のみ。今後乗客が乗車する予定時刻、または乗車時刻の実際の時刻のいずれか。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
intermediateDestinations[] |
(乗車と降車に加えて)ルートが必要な中間停留所。現時点では、共有ルートには対応していません。 |
intermediateDestinationsVersion |
RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
intermediateDestinationIndex |
|
actualIntermediateDestinationArrivalPoints[] |
入力のみ。ドライバーが中間目的地に到着した実際の時間と場所。このフィールドは、プロバイダが中間目的地での実際の到着情報に関するフィードバックを提供するためのものです。 |
actualIntermediateDestinations[] |
入力のみ。中間地点から顧客が集荷された実際の時刻と場所。このフィールドは、事業者が中間目的地での実際のピックアップ情報に関するフィードバックを提供するためのものです。 |
dropoffPoint |
お客様が持ち込みを予定している場所。 |
actualDropoffPoint |
入力のみ。お客様が降車した時刻と場所。このフィールドは実際の降車情報に関するフィードバックを提供するためのものです。 |
dropoffTime |
出力のみ。最終目的地で降車する将来の推定時刻、または降車時刻の実際の時刻のいずれか。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
remainingWaypoints[] |
出力のみ。現在地から降車地点までのフルパス(両端を含む)。この経路には、他のルートの地点を含めることができます。 |
vehicleWaypoints[] |
このフィールドでは、ルートのウェイポイントの手動順序を指定できます。割り当てられた車両の残りのすべての地点と、このルートの乗車地点と降車地点が含まれます。ルートが車両に割り当てられていない場合、このフィールドは無視されます。プライバシー上の理由から、このフィールドは |
route[] |
出力のみ。このルートで最初に残るウェイポイントの最初の入口までの予想ルート。最初の地点は別のルートに属している可能性があります。 |
currentRouteSegment |
出力のみ。次のウェイポイントへのエンコードされたパス。 注: このフィールドは、Driver SDK と Consumer SDK による使用のみを対象としています。デコードはまだサポートされていません。 |
currentRouteSegmentVersion |
出力のみ。ルートが最後に変更された時刻を示します。 注: このフィールドは、Driver SDK と Consumer SDK による使用のみを対象としています。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
currentRouteSegmentTraffic |
出力のみ。 注: このフィールドは、Driver SDK と Consumer SDK による使用のみを対象としています。 |
currentRouteSegmentTrafficVersion |
出力のみ。 注: このフィールドは、Driver SDK と Consumer SDK による使用のみを対象としています。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
currentRouteSegmentEndPoint |
出力のみ。 |
remainingDistanceMeters |
出力のみ。 |
etaToFirstWaypoint |
出力のみ。次のウェイポイント( RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
remainingTimeToFirstWaypoint |
出力のみ。ルートデータが返されてから 「 |
remainingWaypointsVersion |
出力のみ。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
remainingWaypointsRouteVersion |
出力のみ。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
numberOfPassengers |
変更不可。このルートの乗客数を示します。運転手は含みません。 |
lastLocation |
出力のみ。ルート上で最後に報告された車両の位置を示します。 |
lastLocationSnappable |
出力のみ。車両の |
view |
入力されるルート フィールドのサブセットと、その解釈方法。 |
TripStatus
進行状況を示すルートのステータス。
列挙型 | |
---|---|
UNKNOWN_TRIP_STATUS |
デフォルト。未指定または認識できないルート ステータスに使用されます。 |
NEW |
新しく作成されたルート。 |
ENROUTE_TO_PICKUP |
ドライバーは乗車地点に向かっています。 |
ARRIVED_AT_PICKUP |
ドライバーが乗車地点に到着しました。 |
ARRIVED_AT_INTERMEDIATE_DESTINATION |
運転手が中間目的地に到着し、乗客を待っています。 |
ENROUTE_TO_INTERMEDIATE_DESTINATION |
運転手が中間地点(降車地点ではない)に向かっている。 |
ENROUTE_TO_DROPOFF |
ドライバーが乗客を迎え、次の目的地に向かっています。 |
COMPLETE |
この乗客は降車し、ルートは完了です。 |
CANCELED |
ドライバー、乗客、ライドシェア プロバイダが乗車前にキャンセルされた。 |
StopLocation
停車地(乗車/降車)が発生した実際の場所。
JSON 表現 |
---|
{
"point": {
object ( |
フィールド | |
---|---|
point |
必須。実際の場所を表します。 |
timestamp |
駅 / 停留所が発生した時間を示します。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
stopTime |
入力のみ。非推奨です。タイムスタンプ フィールドを使用します。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
TripView
trips.get
レスポンスに含まれるさまざまな Trip フィールド セットのセレクタ。詳しくは AIP-157 をご覧ください。ビューが追加される可能性があります。
列挙型 | |
---|---|
TRIP_VIEW_UNSPECIFIED |
デフォルト値。下位互換性を確保するため、API はデフォルトで SDK ビューになります。安定性とサポートを確保するために、SDK 以外の TripView を選択することをおすすめします。 |
SDK |
一般公開されているライブラリを使用して解釈またはサポートできない可能性があるフィールドが含まれます。 |
JOURNEY_SHARING_V1S |
ルートの各フィールドは、移動経路の共有のユースケースで入力されています。このビューはサーバー間の通信を対象としています。 |
Methods |
|
---|---|
|
Fleet Engine でルートを作成し、新しいルートを返します。 |
|
1 回のルートに関する情報を取得できます。 |
|
特定の車両のすべてのルートを取得できます。 |
|
ルートデータを更新します。 |