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 정류장에 도착했습니다. 차량이 다음 정류장으로 이동할 때 이전 정류장이 모두 완료되었다고 가정합니다.