REST Resource: providers.deliveryVehicles

리소스: DeliveryVehicle

DeliveryVehicle 메시지 배송 차량은 창고에서 배송 위치로, 수령 위치에서 창고로 배송을 운송합니다. 경우에 따라 배송 차량이 수령 위치에서 배송 위치로 직접 배송품을 운송하기도 합니다.

참고: gRPC와 REST API는 서로 다른 필드 이름 지정 규칙을 사용합니다. 예를 들어 gRPC API의 DeliveryVehicle.current_route_segment 필드와 REST API의 DeliveryVehicle.currentRouteSegment 필드는 동일한 필드를 참조합니다.

JSON 표현 
{
  "name": string,
  "lastLocation": {
    object (DeliveryVehicleLocation)
  },
  "navigationStatus": enum (DeliveryVehicleNavigationStatus),
  "currentRouteSegment": string,
  "currentRouteSegmentEndPoint": {
    object (LatLng)
  },
  "remainingDistanceMeters": integer,
  "remainingDuration": string,
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegment)
    }
  ],
  "attributes": [
    {
      object (DeliveryVehicleAttribute)
    }
  ],
  "type": enum (DeliveryVehicleType)
}
필드
name

string

이 배송 차량의 고유한 이름입니다. 형식은 providers/{provider}/deliveryVehicles/{vehicle}입니다.
lastLocation

object (DeliveryVehicleLocation)

배송 차량의 마지막으로 보고된 위치입니다.
navigationStatus

enum (DeliveryVehicleNavigationStatus)

배송 차량의 탐색 상태입니다.
currentRouteSegment

string (bytes format)

다음 경유지로 이동하기 위해 탐색에서 권장하는 경로를 지정하는 인코딩된 폴리라인입니다. 정류장에 도달하거나 지나칠 때, 그리고 내비게이션 경로가 변경될 때 운전자 앱이 이를 업데이트합니다. 이러한 LatLng는 차량에 할당된 모든 활성 태스크에 대해 Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) 또는 Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST)로 반환됩니다.

Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) 또는 Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST)를 채우는 데 이 필드가 사용되지 않는 경우는 다음과 같습니다.

  • currentRouteSegment의 엔드포인트가 DeliveryVehicle.remaining_vehicle_journey_segments[0].stop (gRPC) 또는 DeliveryVehicle.remainingVehicleJourneySegments[0].stop (REST)과 일치하지 않습니다.

  • 드라이버 앱이 최근에 위치를 업데이트하지 않았으므로 이 필드의 마지막으로 업데이트된 값이 오래되었을 수 있습니다.

  • 운전자 앱이 최근에 위치를 업데이트했지만 currentRouteSegment가 오래되어 이전 차량 정류장을 가리킵니다.

이 경우 Fleet Engine은 가장 최근에 통과한 VehicleStop에서 다음 VehicleStop까지의 경로로 이 필드를 채웁니다.

base64 인코딩 문자열입니다.
currentRouteSegmentEndPoint

object (LatLng)

currentRouteSegment이 끝나는 위치입니다. 현재는 드라이버 앱에서 채워지지 않지만 deliveryVehicles.patch 호출 시 제공할 수 있습니다. 다음 차량 정류장의 LatLng 또는 currentRouteSegment의 마지막 LatLng입니다. 그러면 Fleet Engine이 최선을 다해 실제 VehicleStop에 보간합니다.

currentRouteSegment 필드가 비어 있으면 deliveryVehicles.patch 호출에서 이 필드가 무시됩니다.
remainingDistanceMeters

integer

currentRouteSegment의 남은 운전 거리입니다. 일반적으로 Driver 앱은 이 필드를 제공하지만, Fleet Engine이 앱에서 전송하는 값을 재정의하는 경우도 있습니다. 자세한 내용은 DeliveryVehicle.current_route_segment를 참고하세요. 이 필드는 배송 차량에 할당된 모든 활성 Task에 대해 Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) 또는 Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST)에서 반환됩니다.

currentRouteSegment 필드가 비어 있으면 Fleet Engine이 UpdateDeliveryVehicleRequest에서 이 필드를 무시합니다.
remainingDuration

string (Duration format)

currentRouteSegment의 남은 운전 시간입니다. 일반적으로 Driver 앱은 이 필드를 제공하지만, Fleet Engine이 앱에서 전송하는 값을 재정의하는 경우도 있습니다. 자세한 내용은 DeliveryVehicle.current_route_segment를 참고하세요. 이 필드는 배송 차량에 할당된 모든 활성 태스크에 대해 Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) 또는 Task.remainingVehicleJourneySegments[0].drivingDuration (REST)에서 반환됩니다.

currentRouteSegment 필드가 비어 있으면 Fleet Engine이 UpdateDeliveryVehicleRequest에서 이 필드를 무시합니다.

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

object (VehicleJourneySegment)

이 배송 차량에 할당된 여정 세그먼트로, 차량의 가장 최근에 보고된 위치에서 시작합니다. 이 필드는 deliveryVehicles.list의 응답에서 채워지지 않습니다.
attributes[]

object (DeliveryVehicleAttribute)

커스텀 배송 차량 속성 목록입니다. 배달 차량에는 최대 100개의 속성이 있을 수 있으며 각 속성에는 고유한 키가 있어야 합니다.
type

enum (DeliveryVehicleType)

이 배송 차량의 유형입니다. 설정하지 않으면 기본값은 AUTO입니다.

DeliveryVehicleNavigationStatus

차량의 내비게이션 상태입니다.

열거형
UNKNOWN_NAVIGATION_STATUS 탐색 상태가 지정되지 않았습니다.
NO_GUIDANCE 드라이버 앱의 탐색이 FREE_NAV 모드에 있습니다.
ENROUTE_TO_DESTINATION 세부 경로 안내 내비게이션을 사용할 수 있으며 운전자 앱 내비게이션이 GUIDED_NAV 모드로 전환되었습니다.
OFF_ROUTE 차량이 추천 경로를 벗어났습니다.
ARRIVED_AT_DESTINATION 차량이 목적지에서 약 50m 이내에 있습니다.

DeliveryVehicleAttribute

차량 속성을 키-값 쌍으로 설명합니다. 'key:value' 문자열 길이는 256자(영문 기준) 이하여야 합니다.

JSON 표현 
{
  "key": string,
  "value": string,

  // Union field delivery_vehicle_attribute_value can be only one of the
  // following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field
  // delivery_vehicle_attribute_value.
}
필드
key

string

속성의 키입니다.
value

string

속성의 값입니다.
통합 필드 delivery_vehicle_attribute_value. 속성의 값은 문자열, 부울 또는 double 형식일 수 있습니다. delivery_vehicle_attribute_value은 다음 중 하나여야 합니다.
stringValue

string

문자열 유형의 속성 값입니다.

참고: 이는 최종적으로 지원 중단될 value 필드와 동일합니다. create 또는 update 메서드의 경우 두 필드 중 하나를 사용할 수 있지만 stringValue를 사용하는 것이 좋습니다. stringValue와 value가 모두 설정된 경우 동일해야 하며, 그렇지 않으면 오류가 발생합니다. 두 필드 모두 응답으로 채워집니다.
boolValue

boolean

부울 유형의 속성 값입니다.
numberValue

number

이중 유형의 속성 값입니다.

DeliveryVehicleType

배송 수단의 유형입니다.

열거형
DELIVERY_VEHICLE_TYPE_UNSPECIFIED 값이 사용되지 않습니다.
AUTO 자동차입니다.
TWO_WHEELER 오토바이, 모페드 또는 기타 오토바이
BICYCLE 인간 기반 운송
PEDESTRIAN 보행자 통로를 따라 이동하며 걷거나 달리는 사람 수송자입니다.

메서드

create

 새 DeliveryVehicle를 만들고 반환합니다.

get

 지정된 DeliveryVehicle 인스턴스를 반환합니다.

list

 지정된 필터링 기준을 충족하는 모든 DeliveryVehicle를 가져옵니다.

patch

 업데이트된 DeliveryVehicle 데이터를 Fleet Engine에 쓰고 DeliveryVehicle에 Tasks를 할당합니다.