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 오토바이, 모페드 또는 기타 2륜 차량
BICYCLE 사람이 직접 운전하는 이동 수단
PEDESTRIAN 보행자 통로를 따라 이동하며 걷거나 달리는 사람 수송자입니다.

메서드

create

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

get

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

list

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

patch

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