- リソース: Trip
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- TripStatus
- StopLocation
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- TripView
- メソッド
リソース: 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[] |
出力専用。このルートで、残りの Waypoint の最初の通過地点までの予想ルート。最初のウェイポイントは別のルートに属している可能性があります。 |
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 |
入力される Trip フィールドのサブセットと、それらの解釈方法。 |
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 |
[ルート] フィールドには、移動経路の共有ユースケースでデータが入力されます。このビューはサーバー間通信を目的としています。 |
メソッド |
|
---|---|
|
Fleet Engine でルートを作成し、新しいルートを返します。 |
|
特定のルートに関する情報を取得します。 |
|
特定の車両のすべてのルートを取得します。 |
|
ルートデータを更新します。 |