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 停車地に到着。車両が次の停留所に向かうときに、前の停留所がすべて完了していることを前提としています。