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.search 호출의 응답에서는 채워지지 않습니다.

tasks[]

object (TaskInfo)

이 정류장에서 실행할 Task 목록입니다. 이 필드는 tasks.get 또는 tasks.search 호출의 응답에서는 채워지지 않습니다.

state

enum (State)

VehicleStop의 상태입니다. 이 필드는 tasks.get 또는 tasks.search 호출의 응답에서는 채워지지 않습니다.

TaskInfo

이 정류장에서 수행된 작업에 대한 추가 정보입니다.

JSON 표현
{
  "taskId": string,
  "taskDuration": string,
  "targetTimeWindow": {
    object (TimeWindow)
  }
}
필드
taskId

string

작업 ID 이 필드는 tasks.get 또는 tasks.search 호출의 응답에서는 채워지지 않습니다. 작업 ID에는 다음과 같은 제한사항이 적용됩니다.

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

string (Duration format)

출력 전용. 태스크를 수행하는 데 필요한 시간입니다.

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

targetTimeWindow

object (TimeWindow)

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

상태

VehicleStop의 현재 상태입니다.

열거형
STATE_UNSPECIFIED 알 수 없는 작업입니다.
NEW 생성되었지만 현재 라우팅하지는 않습니다.
ENROUTE 할당되고 현재 라우팅 중입니다.
ARRIVED 정류장에 도착했습니다. 차량이 다음 정류장으로 라우팅될 때 이전 정류장이 모두 완료되었다고 가정합니다.