REST Resource: providers.deliveryVehicles

{
  "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)
}

string

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

object (DeliveryVehicleLocation)

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

enum (DeliveryVehicleNavigationStatus)

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

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 인코딩 문자열입니다.

object (LatLng)

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

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

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에서 이 필드를 무시합니다.

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"입니다.

object (VehicleJourneySegment)

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

object (DeliveryVehicleAttribute)

맞춤 전송 수단 속성 목록입니다. 배송 차량에는 최대 100개의 속성이 있을 수 있으며 각 속성에는 고유한 키가 있어야 합니다.

enum (DeliveryVehicleType)

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

{
  "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.
}

string

속성의 키입니다.

string

속성의 값입니다.

string

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

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

boolean

불리언 유형의 속성 값입니다.

number

이중 유형 속성 값