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)의 값으로 채워질 수 있습니다. 이렇게 하면 이전 정류장부터의 운전 시간이 아닌 운전자 앱의 마지막으로 알려진 위치에서의 남은 운전 시간을 제공합니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "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

차량이 정차하여 하나 이상의 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에는 다음과 같은 제한사항이 적용됩니다.

  • 유효한 유니코드 문자열이어야 합니다.
  • 최대 길이는 64자(영문 기준)로 제한됩니다.
  • 유니코드 정규화 양식 C에 따라 정규화됩니다.
  • '/', ':', '?', ',', '#'과 같은 ASCII 문자는 포함할 수 없습니다.
taskDuration

string (Duration format)

출력 전용입니다. 작업을 실행하는 데 필요한 시간입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

targetTimeWindow

object (TimeWindow)

출력 전용입니다. 작업을 완료해야 하는 기간입니다. 이는 deliveryVehicles.get에 대한 응답에서만 설정됩니다.

VehicleStop의 현재 상태입니다.

열거형
STATE_UNSPECIFIED 알 수 없음
NEW 생성되었지만 현재 라우팅되지 않음
ENROUTE 할당되었으며 라우팅이 활성 상태입니다.
ARRIVED 정류장에 도착했습니다. 차량이 다음 정류장으로 경로를 변경할 때 이전의 모든 정류장이 완료되었다고 가정합니다.