VehicleJourneySegment

車両の移動セグメント(前の停車地から現在の停車地まで)を表します。これが最初の有効な停車地である場合は、車両の現在地からこの停車地までとなります。

JSON 表現
{
  "stop": {
    object (VehicleStop)
  },
  "drivingDistanceMeters": integer,
  "drivingDuration": string,
  "path": [
    {
      object (LatLng)
    }
  ]
}
フィールド
stop

object (VehicleStop)

停車地の場所と、停車地に関連付けられている Task を指定します。この経路セグメントが JourneySharingInfo の一部である場合、VehicleStop の一部のフィールドが存在しないことがあります。

drivingDistanceMeters

integer

出力専用。前の停車地からこの停車地までの移動距離。現在の停車地が行程セグメントのリストの最初の停車地である場合、出発地は、その停車地がリストに追加された時点で記録された車両の位置です。この経路のセグメントが JourneySharingInfo の一部である場合、このフィールドが存在しないことがあります。

drivingDuration

string (Duration format)

出力専用。前の停車地からこの停車地までの移動時間。現在の停車地が行程セグメントのリストの最初の停車地である場合、出発地は、この停車地がリストに追加された時点で記録された車両の位置です。

このフィールドが Task.remaining_vehicle_journey_segments[0].driving_duration(gRPC)または Task.remainingVehicleJourneySegments[0].drivingDuration(REST)のパスで定義されている場合は、DeliveryVehicle.remaining_duration(gRPC)または DeliveryVehicle.remainingDuration(REST)の値が入力されます。これにより、前回の停車地からの運転時間ではなく、ドライバー アプリが最後に認識した場所からの運転時間がわかります。

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

path[]

object (LatLng)

出力専用。前の停車地からこの停車地までの経路。現在の停車地が経路セグメントのリストで最初の停車地である場合は、車両の現在地から、停車地がリストに追加された時点のこの停車地までの経路となります。この経路のセグメントが JourneySharingInfo の一部である場合、このフィールドが存在しないことがあります。

このフィールドがパス Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path(gRPC)または Task.journeySharingInfo.remainingVehicleJourneySegments[0].path(REST)で定義されている場合、DeliveryVehicle.current_route_segment(gRPC)または DeliveryVehicle.currentRouteSegment(REST)からデコードされた LatLng を入力できます。これにより、前の停車地からの経路ではなく、ドライバー アプリの最新の既知の場所からの運転経路が提供されます。

VehicleStop

車両が 1 つ以上の Task を実行するために停止するポイントを記述します。

JSON 表現
{
  "plannedLocation": {
    object (LocationInfo)
  },
  "tasks": [
    {
      object (TaskInfo)
    }
  ],
  "state": enum (State)
}
フィールド
plannedLocation

object (LocationInfo)

必須。停車地の場所。Task のロケーションは、このロケーションと完全には一致しない場合がありますが、その近接範囲内です。このフィールドは、tasks.get 呼び出しのレスポンスでは入力されません。

tasks[]

object (TaskInfo)

この停車地で実行される Task のリスト。このフィールドは、tasks.get 呼び出しのレスポンスでは入力されません。

state

enum (State)

VehicleStop の状態。このフィールドは、tasks.get 呼び出しのレスポンスでは入力されません。

TaskInfo

この停車地で実行されたタスクに関する追加情報。

JSON 表現
{
  "taskId": string,
  "taskDuration": string,
  "targetTimeWindow": {
    object (TimeWindow)
  }
}
フィールド
taskId

string

タスク ID。このフィールドは、tasks.get 呼び出しのレスポンスでは入力されません。タスク ID には次の制限があります。

  • 有効な Unicode 文字列を指定する必要があります。
  • 最大文字数は 64 文字です。
  • Unicode 正規化フォーム C に従って正規化されます。
  • ASCII 文字「/」、「:」、「?」、「」、「#」を含めることはできません。
taskDuration

string (Duration format)

出力専用。タスクの実行に必要な時間。

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

targetTimeWindow

object (TimeWindow)

出力専用。タスクを完了する時間枠。これは、deliveryVehicles.get へのレスポンスでのみ設定されます。

VehicleStop の現在の状態。

列挙型
STATE_UNSPECIFIED 不明。
NEW 作成されたが、アクティブにはルーティングしていない。
ENROUTE 割り当て済みのアクティブ ルーティング。
ARRIVED 停車地に到着。車両が次の停車地に経路変更する場合、前の停車地はすべて完了していると想定します。