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를 참고하세요. 이 필드는 Delivery Vehicle에 할당된 모든 활성 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를 참고하세요. 이 필드는 Delivery Vehicle에 할당된 모든 활성 태스크의 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. 이 속성의 값은 문자열, 부울 또는 이중 유형일 수 있습니다. delivery_vehicle_attribute_value은 다음 중 하나여야 합니다.
stringValue

string

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

참고: 이는 향후 지원 중단될 value 필드와 동일합니다. 생성 또는 업데이트 메서드의 경우 두 필드 중 하나를 사용할 수 있지만 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에 쓰고 Tasks을 DeliveryVehicle에 할당합니다.