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 정류장에 도착했습니다. 차량이 다음 정류장으로 이동하는 중일 때 이전의 모든 정류장이 완료된 것으로 가정합니다.