- Recurso: tarefa
- Tipo
- TaskOutcomeLocationSource
- JourneySharingInfo
- TaskTrackingViewConfig
- VisibilityOption
- Métodos
Recurso: Task
Uma tarefa na API Delivery representa uma única ação a ser monitorada. Em geral, há uma distinção entre tarefas relacionadas a remessa e tarefas de interrupção. Uma remessa pode ter várias tarefas associadas a ela. Por exemplo, pode haver uma Tarefa para a retirada e outra para a desembarque ou a baldeação. Além disso, diferentes Tarefas para uma determinada remessa podem ser processadas por veículos diferentes. Por exemplo, um veículo pode lidar com a retirada, conduzindo-a ao hub, enquanto outro conduz a mesma remessa do centro para o local de desembarque.
Observação: as APIs REST e gRPC usam convenções de nomenclatura de campo diferentes. Por exemplo, o campo Task.journey_sharing_info
na API gRPC e o campo Task.journeySharingInfo
na API REST se referem ao mesmo campo.
Representação JSON |
---|
{ "name": string, "type": enum ( |
Campos | |
---|---|
name |
Precisa estar no formato |
type |
Obrigatório. Imutável. Define o tipo da tarefa. Por exemplo, uma pausa ou envio. |
state |
Obrigatório. O estado de execução atual da tarefa. |
taskOutcome |
O resultado da tarefa. |
taskOutcomeTime |
O carimbo de data/hora que indica quando o resultado do Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
taskOutcomeLocation |
O local em que o resultado do |
taskOutcomeLocationSource |
Indica de onde veio o valor de |
trackingId |
Imutável. Esse campo facilita o armazenamento de um ID para que você possa evitar o uso de um mapeamento complicado. Não é possível definir
|
deliveryVehicleId |
Apenas saída. O ID do veículo que está executando esta Tarefa. Os IDs de veículos de entrega estão sujeitos às seguintes restrições:
|
plannedLocation |
Imutável. O local em que a Tarefa será concluída. Opcional para tarefas |
taskDuration |
Obrigatório. Imutável. O tempo necessário para executar uma Task no local. Uma duração em segundos com até nove dígitos fracionários, terminando em " |
targetTimeWindow |
A janela de tempo em que a tarefa deve ser concluída. |
journeySharingInfo |
Apenas saída. Campos específicos do compartilhamento de jornada. Não preenchido quando o estado é |
taskTrackingViewConfig |
A configuração do rastreamento de tarefas que especifica quais elementos de dados ficam visíveis para os usuários finais em quais circunstâncias. |
attributes[] |
Uma lista de atributos de tarefas personalizados. Cada atributo precisa ter uma chave exclusiva. |
Tipo
O tipo de Task.
Enums | |
---|---|
TYPE_UNSPECIFIED |
Padrão, o tipo de tarefa é desconhecido. |
PICKUP |
Uma tarefa de retirada é a ação realizada para retirar uma remessa de um cliente. As retiradas de veículos em depósito ou alimentador devem usar o tipo SCHEDULED_STOP . |
DELIVERY |
Uma tarefa de entrega é a ação realizada para entregar uma remessa a um cliente final. As entregas de veículos em depósitos ou alimentadores devem usar o tipo SCHEDULED_STOP . |
SCHEDULED_STOP |
Uma Tarefa de parada programada é usada para fins de planejamento. Por exemplo, pode representar a retirada ou entrega de remessas de veículos ou depósitos alimentadores. Ele não deve ser usado para remessas que são retiradas ou entregues de um cliente final. |
UNAVAILABLE |
Uma tarefa que significa que o Veículo não está disponível para manutenção. Por exemplo, isso pode acontecer quando o motorista faz uma pausa ou o veículo está sendo reabastecido. |
TaskOutcomeLocationSource
A identidade da origem que preencheu o taskOutcomeLocation
.
Enums | |
---|---|
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED |
O resultado da tarefa antes que seja definido. |
PROVIDER |
A taskOutcomeLocation especificada pelo provedor. |
LAST_VEHICLE_LOCATION |
Como o provedor não especificou o taskOutcomeLocation , o Fleet Engine usou a última localização conhecida do veículo. |
JourneySharingInfo
Jornada de compartilhamento de campos específicos.
Representação JSON |
---|
{ "remainingVehicleJourneySegments": [ { object ( |
Campos | |
---|---|
remainingVehicleJourneySegments[] |
Informações de rastreamento das paradas que o veículo atribuído vai fazer antes de concluir esta Tarefa. Essa lista pode conter paradas de outras tarefas. O primeiro segmento, |
lastLocation |
Indica o último local informado pelo veículo sobre o veículo atribuído. |
lastLocationSnappable |
Indica se o lastLocation do veículo pode ser ajustado ao |
TaskTrackingViewConfig
A mensagem de configuração que define quando um elemento de dados de uma tarefa deve ficar visível para os usuários finais.
Representação JSON |
---|
{ "routePolylinePointsVisibility": { object ( |
Campos | |
---|---|
routePolylinePointsVisibility |
O campo que especifica quando os pontos de polilinha do trajeto podem ser visíveis. Se este campo não for especificado, será usada a configuração de visibilidade padrão para envolvidos no projeto para esses dados. |
estimatedArrivalTimeVisibility |
O campo que especifica quando o horário de chegada estimado pode ser visível. Se este campo não for especificado, será usada a configuração de visibilidade padrão para envolvidos no projeto para esses dados. |
estimatedTaskCompletionTimeVisibility |
O campo que especifica quando o tempo estimado de conclusão da tarefa pode ficar visível. Se este campo não for especificado, será usada a configuração de visibilidade padrão para envolvidos no projeto para esses dados. |
remainingDrivingDistanceVisibility |
O campo que especifica quando a distância de carro restante pode ser visível. Se este campo não for especificado, será usada a configuração de visibilidade padrão para envolvidos no projeto para esses dados. |
remainingStopCountVisibility |
O campo que especifica quando a contagem de paradas restantes pode ser visível. Se este campo não for especificado, será usada a configuração de visibilidade padrão para envolvidos no projeto para esses dados. |
vehicleLocationVisibility |
O campo que especifica quando a localização do veículo pode estar visível. Se este campo não for especificado, será usada a configuração de visibilidade padrão para envolvidos no projeto para esses dados. |
VisibilityOption
A mensagem de opção que define quando um elemento de dados deve ficar visível para os usuários finais.
Representação JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de união visibility_option . A opção de visibilidade específica escolhida. visibility_option pode ser apenas de um dos tipos a seguir: |
|
remainingStopCountThreshold |
Esse elemento de dados ficará visível para os usuários finais se a contagem de paradas restante <= missingStopCountThreshold. |
durationUntilEstimatedArrivalTimeThreshold |
Esse elemento de dados é visível aos usuários finais se o HEC para a parada <= DurationUntilEstimatedArrivalTimeThreshold. Uma duração em segundos com até nove dígitos fracionários, terminando em " |
remainingDrivingDistanceMetersThreshold |
Esse elemento de dados ficará visível para os usuários finais se a distância de carro restante em metros <= missingDrivingDistanceMetersThreshold. |
always |
Se definido como verdadeiro, esse elemento de dados estará sempre visível para os usuários finais, sem limites. Este campo não pode ser definido como falso. |
never |
Se definido como verdadeiro, esse elemento de dados sempre ficará oculto para os usuários finais sem limites. Este campo não pode ser definido como falso. |
Métodos |
|
---|---|
|
Cria e retorna um lote de novos objetos Task . |
|
Cria e retorna um novo objeto Task . |
|
Recebe informações sobre um Task . |
|
Recebe todos os Task s que atendem aos critérios de filtragem especificados. |
|
Atualiza os dados de Task . |