TaskLog

Es el registro de un recurso de Task en la API de Deliveries.

Representación JSON
{
  "name": string,
  "type": enum (TaskTypeLog),
  "state": enum (TaskStateLog),
  "taskOutcome": enum (TaskOutcomeLog),
  "taskOutcomeTime": string,
  "taskOutcomeLocation": {
    object (LocationInfoLog)
  },
  "taskOutcomeLocationSource": enum (TaskOutcomeLocationSourceLog),
  "trackingId": string,
  "deliveryVehicleId": string,
  "plannedLocation": {
    object (LocationInfoLog)
  },
  "taskDuration": string,
  "targetTimeWindow": {
    object (TimeWindowLog)
  },
  "journeySharingInfo": {
    object (JourneySharingInfoLog)
  },
  "taskTrackingViewConfig": {
    object (TaskTrackingViewConfigLog)
  },
  "attributes": [
    {
      object (TaskAttributeLog)
    }
  ]
}
Campos
name

string

El nombre del recurso de la tarea en el formato providers/{providerId}/tasks/{taskId}.

type

enum (TaskTypeLog)

Es el tipo de tarea.

state

enum (TaskStateLog)

Es el estado de una tarea que indica su progreso.

taskOutcome

enum (TaskOutcomeLog)

El resultado de intentar ejecutar una tarea Cuando se cierra TaskState, se indica si se completó correctamente.

taskOutcomeTime

string (Timestamp format)

Es la marca de tiempo del momento en que se estableció el resultado de la tarea (del proveedor).

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

taskOutcomeLocation

object (LocationInfoLog)

Es la ubicación en la que se estableció el resultado de la tarea.

taskOutcomeLocationSource

enum (TaskOutcomeLocationSourceLog)

Indica de dónde proviene el valor de taskOutcomeLocation.

trackingId

string

Este campo facilita el almacenamiento de un ID para el cliente para evitar asignaciones innecesarias o complicadas.

deliveryVehicleId

string

Es el ID del vehículo que realiza esta tarea.

plannedLocation

object (LocationInfoLog)

Es la ubicación donde se completa la tarea.

taskDuration

string (Duration format)

Es el tiempo adicional para realizar una acción en esta ubicación.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

targetTimeWindow

object (TimeWindowLog)

Es el período durante el cual se debe completar la tarea.

journeySharingInfo

object (JourneySharingInfoLog)

Campos específicos para compartir viajes

taskTrackingViewConfig

object (TaskTrackingViewConfigLog)

Es la configuración del seguimiento de tareas que especifica qué elementos de datos son visibles para los usuarios finales y en qué circunstancias.

attributes[]

object (TaskAttributeLog)

Es una lista de atributos de tareas personalizados. Cada atributo debe tener una clave única.

JourneySharingInfoLog

Campos específicos para compartir viajes

Representación JSON
{
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegmentLog)
    }
  ],
  "lastLocation": {
    object (DeliveryVehicleLocationLog)
  },
  "lastLocationSnappable": boolean
}
Campos
remainingVehicleJourneySegments[]

object (VehicleJourneySegmentLog)

Información de seguimiento de cada parada a la que viajará el vehículo asignado antes de completar esta tarea Esta lista puede contener paradas de otras tareas.

lastLocation

object (DeliveryVehicleLocationLog)

Es la última ubicación informada del vehículo.

lastLocationSnappable

boolean

Indica si el lastLocation del vehículo se puede ajustar a la currentRouteSegment. False si lastLocation o currentRouteSegment no existen.

TaskTrackingViewConfigLog

Es el mensaje de configuración que define cuándo los usuarios finales deben ver un elemento de datos de una tarea.

Representación JSON
{
  "routePolylinePointsVisibility": {
    object (VisibilityOptionLog)
  },
  "estimatedArrivalTimeVisibility": {
    object (VisibilityOptionLog)
  },
  "estimatedTaskCompletionTimeVisibility": {
    object (VisibilityOptionLog)
  },
  "remainingDrivingDistanceVisibility": {
    object (VisibilityOptionLog)
  },
  "remainingStopCountVisibility": {
    object (VisibilityOptionLog)
  },
  "vehicleLocationVisibility": {
    object (VisibilityOptionLog)
  }
}
Campos
routePolylinePointsVisibility

object (VisibilityOptionLog)

Es el campo que especifica cuándo pueden ser visibles los puntos de la polilínea de la ruta. Si no se especifica este campo, se usará la configuración de visibilidad predeterminada a nivel del proyecto para estos datos.

estimatedArrivalTimeVisibility

object (VisibilityOptionLog)

Es el campo que especifica cuándo se puede ver la hora de llegada estimada. Si no se especifica este campo, se usará la configuración de visibilidad predeterminada a nivel del proyecto para estos datos.

estimatedTaskCompletionTimeVisibility

object (VisibilityOptionLog)

Es el campo que especifica cuándo se puede ver el tiempo estimado de finalización de la tarea. Si no se especifica este campo, se usará la configuración de visibilidad predeterminada a nivel del proyecto para estos datos.

remainingDrivingDistanceVisibility

object (VisibilityOptionLog)

Es el campo que especifica cuándo se puede ver la distancia de conducción restante. Si no se especifica este campo, se usará la configuración de visibilidad predeterminada a nivel del proyecto para estos datos.

remainingStopCountVisibility

object (VisibilityOptionLog)

Es el campo que especifica cuándo se puede ver el recuento de paradas restantes. Si no se especifica este campo, se usará la configuración de visibilidad predeterminada a nivel del proyecto para estos datos.

vehicleLocationVisibility

object (VisibilityOptionLog)

Es el campo que especifica cuándo puede ser visible la ubicación del vehículo. Si no se especifica este campo, se usará la configuración de visibilidad predeterminada a nivel del proyecto para estos datos.

VisibilityOptionLog

Es el mensaje de opción que define cuándo un elemento de datos debe ser visible para los usuarios finales.

Representación JSON
{

  // 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.
}
Campos

Campo de unión visibility_option.

visibility_option puede ser una de las siguientes opciones:

remainingStopCountThreshold

integer

Los usuarios finales pueden ver este elemento de datos si el recuento de paradas restantes <= remainingStopCountThreshold.

durationUntilEstimatedArrivalTimeThreshold

string (Duration format)

Los usuarios finales pueden ver este elemento de datos si la hora de llegada estimada a la parada es <= durationUntilEstimatedArrivalTimeThreshold.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

remainingDrivingDistanceMetersThreshold

integer

Los usuarios finales pueden ver este elemento de datos si la distancia de conducción restante en metros <= remainingDrivingDistanceMetersThreshold.

always

boolean

Si se establece como verdadero, los usuarios finales siempre pueden ver este elemento de datos sin umbrales.

never

boolean

Si se establece como verdadero, este elemento de datos siempre se oculta a los usuarios finales sin umbrales.

TaskAttributeLog

Describe un atributo de tarea como un par clave-valor. La longitud de la cadena "clave:valor" no puede superar los 256 caracteres.

Representación JSON
{
  "key": string,

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

string

Es la clave del atributo. Las claves no pueden contener el carácter dos puntos (:).

Campo de unión task_attribute_value. El valor del atributo puede ser de tipo cadena, booleano o doble. Si no se establece ninguno, el valor de cadena de TaskAttribute se almacenará como la cadena vacía "". task_attribute_value puede ser solo uno de los siguientes:
stringValue

string

Valor del atributo escrito como cadena.

boolValue

boolean

Valor de atributo escrito en formato booleano.

numberValue

number

Valor de atributo escrito dos veces.