- Recurso: Tarea
- Tipo
- TaskOutcomeLocationSource
- JourneySharingInfo
- TaskTrackingViewConfig
- VisibilityOption
- Métodos
Recurso: Tarea
En la API de Delivery, una tarea representa una sola acción a la que le puedes hacer un seguimiento. En general, hay una distinción entre las tareas relacionadas con el envío y las tareas de desglose. Un envío puede tener varias tareas asociadas. Por ejemplo, podría haber una tarea para el punto de partida y otra para el destino o el transbordo. Además, vehículos diferentes pueden manejar las distintas Tasks para un envío determinado. Por ejemplo, un vehículo podría encargarse del retiro y conducir el envío al centro, mientras que otro vehículo realiza el mismo envío desde el centro hasta la ubicación de llegada.
Nota: Las APIs de REST y gRPC usan diferentes convenciones de nombres de campos. Por ejemplo, el campo Task.journey_sharing_info
en la API de gRPC y el campo Task.journeySharingInfo
en la API de REST hacen referencia al mismo campo.
Representación JSON |
---|
{ "name": string, "type": enum ( |
Campos | |
---|---|
name |
Debe tener el formato |
type |
Obligatorio. Inmutable. Define el tipo de Task. Por ejemplo, una pausa o un envío. |
state |
Obligatorio. El estado actual de la ejecución de la Task. |
taskOutcome |
El resultado de la Task. |
taskOutcomeTime |
Es la marca de tiempo que indica cuándo el proveedor configuró el resultado de Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
taskOutcomeLocation |
La ubicación en la que se estableció el resultado de |
taskOutcomeLocationSource |
Indica de dónde provino el valor de |
trackingId |
Inmutable. Este campo facilita el almacenamiento de un ID para que no tengas que usar una asignación complicada. No puedes configurar
|
deliveryVehicleId |
Solo salida. El ID del vehículo que ejecuta esta tarea. Los IDs de vehículos de entrega están sujetos a las siguientes restricciones:
|
plannedLocation |
Inmutable. Es la ubicación en la que se completará la tarea. Opcional para las tareas de |
taskDuration |
Obligatorio. Inmutable. El tiempo necesario para ejecutar una Task en esta ubicación. Una duración en segundos con hasta nueve dígitos decimales que terminen en " |
targetTimeWindow |
Es el período durante el cual se debe completar la tarea. |
journeySharingInfo |
Solo salida. Campos específicos del recorrido compartido. No se propaga cuando el estado es |
taskTrackingViewConfig |
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[] |
Una lista de atributos personalizados de Tasks. Cada atributo debe tener una clave única. |
Tipo
Es el tipo de Task.
Enumeradores | |
---|---|
TYPE_UNSPECIFIED |
De forma predeterminada, se desconoce el tipo de tarea. |
PICKUP |
Una tarea de retiro es la acción que se realiza para recoger un envío de un cliente. Las recogidas de vehículos desde plataformas o alimentadores deben usar el tipo SCHEDULED_STOP . |
DELIVERY |
Una tarea de entrega es la acción que se realiza para entregar un envío a un cliente final. Los destinos de vehículos todoterreno o depósito deben usar el tipo SCHEDULED_STOP . |
SCHEDULED_STOP |
Una Task de parada programada se utiliza con fines de planificación. Por ejemplo, podría representar la recogida o devolución de envíos de vehículos o depósitos de alimentación. No debe usarse para envíos que recoge o deja un cliente final. |
UNAVAILABLE |
Una Tarea que significa que el Vehículo no está disponible para su mantenimiento. Por ejemplo, esto puede ocurrir cuando el conductor se toma un descanso o cuando se está recargando el combustible del vehículo. |
TaskOutcomeLocationSource
La identidad de la fuente que propagó el taskOutcomeLocation
.
Enumeradores | |
---|---|
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED |
El resultado de la tarea antes de que se establezca. |
PROVIDER |
El proveedor especificó el taskOutcomeLocation . |
LAST_VEHICLE_LOCATION |
El proveedor no especificó el taskOutcomeLocation , por lo que Fleet Engine usó la ubicación más reciente del vehículo. |
JourneySharingInfo
Recorrido que comparte campos específicos
Representación JSON |
---|
{ "remainingVehicleJourneySegments": [ { object ( |
Campos | |
---|---|
remainingVehicleJourneySegments[] |
Información de seguimiento para las paradas que realizará el vehículo asignado antes de completar esta Tarea. Ten en cuenta que esta lista puede contener paradas de otras tareas. El primer segmento, |
lastLocation |
Indica la ubicación más reciente que se informó del vehículo asignado. |
lastLocationSnappable |
Indica si la última ubicación del vehículo se puede ajustar a |
TaskTrackingViewConfig
Es el mensaje de configuración que define cuándo debe ser visible un elemento de datos de una tarea para los usuarios finales.
Representación JSON |
---|
{ "routePolylinePointsVisibility": { object ( |
Campos | |
---|---|
routePolylinePointsVisibility |
Es el campo que especifica cuándo se pueden ver los puntos de polilínea de la ruta. Si no se especifica este campo, se usará la configuración de visibilidad predeterminada a nivel de proyecto para estos datos. |
estimatedArrivalTimeVisibility |
El campo que especifica cuándo puede mostrarse la hora de llegada estimada. Si no se especifica este campo, se usará la configuración de visibilidad predeterminada a nivel de proyecto para estos datos. |
estimatedTaskCompletionTimeVisibility |
Campo que especifica cuándo se puede visualizar 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 de proyecto para estos datos. |
remainingDrivingDistanceVisibility |
Puede verse el campo que especifica el momento en que se puede recorrer el área restante en automóvil. Si no se especifica este campo, se usará la configuración de visibilidad predeterminada a nivel de proyecto para estos datos. |
remainingStopCountVisibility |
El campo que especifica cuándo puede estar visible el recuento de paradas restante. Si no se especifica este campo, se usará la configuración de visibilidad predeterminada a nivel de proyecto para estos datos. |
vehicleLocationVisibility |
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 de proyecto para estos datos. |
VisibilityOption
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 |
Campos | |
---|---|
Campo de unión visibility_option . La opción de visibilidad específica elegida. Las direcciones (visibility_option ) solo pueden ser una de las siguientes opciones: |
|
remainingStopCountThreshold |
Este elemento de datos es visible para los usuarios finales si el recuento de paradas restante es igual a <= distribucionesStopCountThreshold. |
durationUntilEstimatedArrivalTimeThreshold |
Este elemento de datos es visible para los usuarios finales si la hora de llegada estimada a la parada es <= durationUntilEstimatedArrivalTimeThreshold. Una duración en segundos con hasta nueve dígitos decimales que terminen en " |
remainingDrivingDistanceMetersThreshold |
Este elemento de datos es visible para los usuarios finales si la distancia de conducción restante en metros es inferior o igual a la cantidad de metros que recibimos. |
always |
Si se configura como true, este elemento de datos siempre es visible para los usuarios finales sin umbrales. Este campo no se puede establecer como falso. |
never |
Si se configura como true, este elemento de datos siempre está oculto para los usuarios finales sin umbrales. Este campo no se puede establecer como falso. |
Métodos |
|
---|---|
|
Crea y muestra un lote de objetos Task nuevos. |
|
Crea y muestra un objeto Task nuevo. |
|
Obtiene información sobre un Task . |
|
Obtiene todos los Task que cumplen con los criterios de filtrado especificados. |
|
Actualiza los datos de Task . |