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 停車地に到着。車両が次の停車地に経路変更する場合、前の停車地はすべて完了していると想定します。