REST Resource: providers.tasks

{
  "name": string,
  "type": enum (Type),
  "state": enum (State),
  "taskOutcome": enum (TaskOutcome),
  "taskOutcomeTime": string,
  "taskOutcomeLocation": {
    object (LocationInfo)
  },
  "taskOutcomeLocationSource": enum (TaskOutcomeLocationSource),
  "trackingId": string,
  "deliveryVehicleId": string,
  "plannedLocation": {
    object (LocationInfo)
  },
  "taskDuration": string,
  "targetTimeWindow": {
    object (TimeWindow)
  },
  "journeySharingInfo": {
    object (JourneySharingInfo)
  },
  "taskTrackingViewConfig": {
    object (TaskTrackingViewConfig)
  },
  "attributes": [
    {
      object (TaskAttribute)
    }
  ]
}

string

providers/{provider}/tasks/{task} 형식이어야 합니다.

enum (Type)

필수 항목입니다. 변경할 수 없습니다. Task의 유형을 정의합니다. (예: 파손 또는 배송)

enum (State)

필수 항목입니다. 작업의 현재 실행 상태입니다.

enum (TaskOutcome)

태스크의 결과입니다.

string (Timestamp format)

제공자가 Task의 결과를 설정한 시점을 나타내는 타임스탬프입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

object (LocationInfo)

Task의 결과가 설정된 위치입니다. 이 값은 tasks.patch의 일부로 업데이트됩니다. 제공업체에서 이 값을 명시적으로 업데이트하지 않으면 Fleet Engine이 기본적으로 마지막으로 알려진 차량 위치 (원시 위치)로 값을 채웁니다.

enum (TaskOutcomeLocationSource)

taskOutcomeLocation 값의 출처를 나타냅니다.

string

변경할 수 없습니다. 이 필드는 ID 저장을 용이하게 하므로 복잡한 매핑 사용을 피할 수 있습니다. UNAVAILABLE 및 SCHEDULED_STOP 유형의 Tasks에는 trackingId를 설정할 수 없습니다. 이러한 ID에는 다음과 같은 제한사항이 적용됩니다.

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

string

출력 전용. 이 Task를 실행하는 차량의 ID입니다. 배송 차량 ID에는 다음과 같은 제한사항이 적용됩니다.

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

object (LocationInfo)

변경할 수 없습니다. 작업이 완료될 위치입니다. UNAVAILABLE Tasks의 경우에는 선택사항이지만 다른 모든 Tasks에는 필수입니다.

string (Duration format)

필수 항목입니다. 변경할 수 없습니다. 이 위치에서 작업을 실행하는 데 필요한 시간입니다.

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

object (TimeWindow)

작업이 완료되어야 하는 기간입니다.

object (JourneySharingInfo)

출력 전용. 여정 공유 관련 필드입니다. 상태가 CLOSED인 경우 채워지지 않습니다.

object (TaskTrackingViewConfig)

어떤 상황에서 최종 사용자에게 어떤 데이터 요소가 표시되는지 지정하는 작업 추적 구성입니다.

object (TaskAttribute)

커스텀 Task 속성 목록 각 속성에는 고유한 키가 있어야 합니다.

{
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegment)
    }
  ],
  "lastLocation": {
    object (DeliveryVehicleLocation)
  },
  "lastLocationSnappable": boolean
}

object (VehicleJourneySegment)

이 Task를 완료하기 전에 할당된 차량이 거치는 정류장에 대한 추적 정보입니다. 이 목록에는 다른 작업의 정류장이 포함될 수 있습니다.

첫 번째 구간인 Task.journey_sharing_info.remaining_vehicle_journey_segments[0] (gRPC) 또는 Task.journeySharingInfo.remainingVehicleJourneySegments[0] (REST)에는 운전자의 마지막으로 알려진 위치에서 다음 VehicleStop까지의 경로 정보가 포함됩니다. 현재 경로 정보는 일반적으로 드라이버 앱에서 가져옵니다. 단, DeliveryVehicle.current_route_segment 관련 문서에 명시된 일부 경우는 예외입니다. Task.journey_sharing_info.remaining_vehicle_journey_segments (gRPC) 또는 Task.journeySharingInfo.remainingVehicleJourneySegments (REST)의 다른 세그먼트는 Fleet Engine에 의해 채워집니다. 나머지 VehicleStops 간의 경로 정보를 제공합니다.

object (DeliveryVehicleLocation)

할당된 차량에 대해 차량이 마지막으로 보고된 위치를 나타냅니다.

boolean

차량의 lastLocation을 currentRouteSegment에 스냅할 수 있는지 여부를 나타냅니다. lastLocation 또는 currentRouteSegment가 없으면 이 값은 False입니다. 이 값은 Fleet Engine에서 계산합니다. 클라이언트의 업데이트는 무시됩니다.

{
  "routePolylinePointsVisibility": {
    object (VisibilityOption)
  },
  "estimatedArrivalTimeVisibility": {
    object (VisibilityOption)
  },
  "estimatedTaskCompletionTimeVisibility": {
    object (VisibilityOption)
  },
  "remainingDrivingDistanceVisibility": {
    object (VisibilityOption)
  },
  "remainingStopCountVisibility": {
    object (VisibilityOption)
  },
  "vehicleLocationVisibility": {
    object (VisibilityOption)
  }
}

object (VisibilityOption)

경로 다중선 점을 표시할 수 있는 시기를 지정하는 필드입니다. 이 필드를 지정하지 않으면 이 데이터에 대한 프로젝트 수준의 기본 공개 상태 구성이 사용됩니다.

object (VisibilityOption)

예상 도착 시간을 표시할 수 있는 시간을 지정하는 입력란입니다. 이 필드를 지정하지 않으면 이 데이터에 대한 프로젝트 수준의 기본 공개 상태 구성이 사용됩니다.

object (VisibilityOption)

예상 작업 완료 시간을 표시할 수 있는 시기를 지정하는 필드입니다. 이 필드를 지정하지 않으면 이 데이터에 대한 프로젝트 수준의 기본 공개 상태 구성이 사용됩니다.

object (VisibilityOption)

남은 운전 거리를 지정하는 필드를 표시할 수 있습니다. 이 필드를 지정하지 않으면 이 데이터에 대한 프로젝트 수준의 기본 공개 상태 구성이 사용됩니다.

object (VisibilityOption)

남은 정류장 수를 표시하는 시점을 지정하는 필드를 표시할 수 있습니다. 이 필드를 지정하지 않으면 이 데이터에 대한 프로젝트 수준의 기본 공개 상태 구성이 사용됩니다.

object (VisibilityOption)

차량 위치를 표시할 수 있는 시기를 지정하는 필드입니다. 이 필드를 지정하지 않으면 이 데이터에 대한 프로젝트 수준의 기본 공개 상태 구성이 사용됩니다.

{

  // Union field visibility_option can be only one of the following:
  "remainingStopCountThreshold": integer,
  "durationUntilEstimatedArrivalTimeThreshold": string,
  "remainingDrivingDistanceMetersThreshold": integer,
  "always": boolean,
  "never": boolean
  // End of list of possible types for union field visibility_option.
}

integer

이 데이터 요소는 남은 정류장 수가 남은 정류장 수가 <= leftStopCountThreshold이면 최종 사용자에게 표시됩니다.

string (Duration format)

이 데이터 요소는 정류장 예상 도착 시간이 <= durationUntilEstimatedArrivalTimeThreshold인 경우 최종 사용자에게 표시됩니다.

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

integer

이 데이터 요소는 남은 운전 거리(미터)가 <= leftDrivingDistanceMetersThreshold인 경우 최종 사용자에게 표시됩니다.

boolean

true로 설정하면 이 데이터 요소가 기준점이 없는 최종 사용자에게 항상 표시됩니다. 이 필드는 false로 설정할 수 없습니다.

boolean

true로 설정하면 이 데이터 요소가 기준점이 없는 최종 사용자에게 항상 숨겨집니다. 이 필드는 false로 설정할 수 없습니다.