O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Configurar tarefas

Este documento pressupõe que você entende como criar e usar tarefas. Ele fornece exemplos específicos de como configurar tarefas de remessa das seguintes maneiras:

Definir a janela de tempo desejada para uma tarefa de envio: defina a janela de tempo para que a tarefa seja concluída.
Personalizar a visibilidade das tarefas: personalize a visibilidade das atividades de tarefas para exibição aos clientes ou operadores de frota.

Consulte Criar tarefas de transporte para ver detalhes sobre os campos dessas tarefas. Ao atualizar informações adicionais sobre tarefas atuais, você também precisa incluir o identificador relevante da tarefa, além dos campos que você atualiza para as tarefas.

Definir a janela de tempo desejada

A janela de tempo de destino é o TimeWindow em que a tarefa precisa ser concluída. Por exemplo, se você informar um período de entrega aos destinatários, poderá usar o período de destino da tarefa para capturar esse período e gerar alertas ou analisar o desempenho de viagens anteriores.

A janela de tempo de destino consiste em um horário de início e um horário de término e pode ser definida em qualquer tipo de tarefa. A janela de tempo de destino não afeta o comportamento de roteamento.

Os exemplos a seguir mostram como definir a janela de tempo usando a biblioteca gRPC do Java ou como fazer uma solicitação HTTP REST para UpdateTask. Também é possível definir esse campo no momento da criação da tarefa.

gRPC

  static final String PROJECT_ID = "my-delivery-co-gcp-project";
  static final String TASK_ID = "task-8241890";

  DeliveryServiceBlockingStub deliveryService =
    DeliveryServiceGrpc.newBlockingStub(channel);

  // Task settings
  String taskName = "providers/" + PROJECT_ID + "/tasks/" + TASK_ID;
  Task task = Task.newBuilder()
    .setName(taskName)
    .setTargetTimeWindow(
      TimeWindow.newBuilder()
        .setStartTime(Timestamp.newBuilder().setSeconds(1680123600))
        .setEndTime(Timestamp.newBuilder().setSeconds(1680130800)))
    .build();

  // Task request
  UpdateTaskRequest updateTaskRequest =
    UpdateTaskRequest.newBuilder()  // No need for the header
        .setTask(task)
        .setUpdateMask(FieldMask.newBuilder().addPaths("targetTimeWindow"))
        .build();

  try {
    Task updatedTask = deliveryService.updateTask(updateTaskRequest);
  } catch (StatusRuntimeException e) {
    Status s = e.getStatus();
    switch (s.getCode()) {
       case NOT_FOUND:
         break;
       case PERMISSION_DENIED:
         break;
    }
    return;
  }

REST

Para definir uma janela de tempo de tarefa usando HTTP, chame PATCH e use updateMask para atualizar o parâmetro targetTimeWindow:

PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks/<id>?updateMask=targetTimeWindow

Aqui, <id> é um identificador exclusivo da tarefa. O cabeçalho da solicitação precisa conter um campo Authorization com o valor Bearer <token>, em que <token> é emitido pelo servidor de acordo com as diretrizes descritas em Papéis da conta de serviço e JSON Web Tokens.

# Set JWT, PROJECT_ID, and TASK_ID in the local environment
  curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks/${TASK_ID}?updateMask=targetTimeWindow" \
    -H "Content-type: application/json" \
    -H "Authorization: Bearer ${JWT}" \
    --data-binary @- << EOM
  {
    "targetTimeWindow": {
      "startTime": "2023-03-29T21:00:00Z",
      "endTime": "2023-03-29T23:00:00Z"
    }
  }
  EOM

Personalizar a visibilidade das tarefas

Por padrão, o Fleet Engine oferece visibilidade das atividades de tarefas que podem ser mostradas aos clientes que recebem uma remessa e aos operadores de frota que rastreiam remessas. Isso inclui informações como o número de paradas antes de enviar ao cliente uma notificação sobre o status de entrega do pacote. É possível personalizar essas informações por tarefa para se adequar melhor ao seu modelo de negócios.

Nesta seção, descrevemos as regras de visibilidade para objetos rastreados no mapa. Essas regras se aplicam a duas categorias de objetos:

Visibilidade do marcador de local
Visibilidade dos dados de tarefas ativas do veículo, como polilinhas e HEC

Regras de visibilidade do marcador de local

O Fleet Engine mostra marcadores para o local de entrega da remessa no mapa, independentemente do estado da entrega.

Regras de visibilidade de dados de tarefas

Nesta seção, descrevemos as regras de visibilidade padrão que se aplicam aos dados de tarefas. Só é possível personalizar tarefas de veículos ativas, o que significa que apenas as tarefas de retirada e entrega podem aplicar regras de visibilidade personalizadas.

As seguintes tarefas não podem ser personalizadas:

Paradas programadas
Tarefas de indisponibilidade
Tarefas de veículos inativos

Regras de visibilidade de tarefas de indisponibilidade

Por padrão, o veículo não aparece no mapa se pelo menos uma tarefa de indisponibilidade for atribuída à tarefa que está sendo rastreada. Por exemplo, se o motorista estiver fazendo uma pausa ou o veículo estiver sendo abastecido no trajeto até a remessa rastreada. O horário estimado de chegada e o tempo estimado de conclusão da tarefa ainda estão disponíveis. Não é possível personalizar essa regra.

Visibilidade das tarefas ativas do veículo

O objeto TaskTrackingInfo fornece vários elementos de dados que podem ser disponibilizados usando a biblioteca de rastreamento de remessas. Por padrão, esses campos ficam visíveis quando a tarefa é atribuída ao veículo e quando ele está a cinco paradas da tarefa. A visibilidade termina quando a tarefa é concluída ou cancelada.

É possível personalizar a configuração de visibilidade por tarefa definindo o TaskTrackingViewConfig em uma tarefa ao criá-la ou atualizá-la no Fleet Engine. Isso cria regras para que elementos de dados individuais fiquem disponíveis.

A tabela a seguir mostra os campos em que é possível aplicar regras de visibilidade.

Campos de tarefas do veículo para regras de visibilidade
Polilinhas de trajeto Horário previsto de chegada Tempo estimado para concluir a tarefa Distância restante até a tarefa Número de paradas restantes Localização do veículo

Esta tabela mostra as opções de visibilidade disponíveis para os campos listados acima.

Opções de visibilidade
Número de paradas restantes Tempo até o horário previsto de chegada Distância restante Sempre visível Nunca visível

Polilinhas de trajeto e regras de visibilidade da localização do veículo

Para um trajeto monitorado, a visibilidade das polilinhas está sujeita à visibilidade do veículo. Se uma polilinha de trajeto estiver visível em um trajeto ativo em que o veículo não está visível, a localização do veículo ainda poderá ser inferida pelo final da polilinha visível. Portanto, a visibilidade da polilinha do trajeto precisa ser tão ou mais restritiva do que a do veículo.

Siga estas regras para fornecer uma combinação válida de polilinhas de trajeto e visibilidade da localização do veículo.

As polilinhas de trajeto e a localização do veículo especificam as mesmas opções de visibilidade.

Nesse cenário, tanto a polilinha quanto a localização do veículo definem as mesmas opções, que incluem:

número de paradas restantes
tempo até o horário previsto de chegada
distância restante

Para obedecer às regras, o valor da visibilidade das polilinhas de trajeto precisa ser menor ou igual ao valor definido para a visibilidade do veículo. Neste exemplo, o limite de paradas restantes para a polilinha é definido como 3, que é menor que o valor de 5 especificado para o veículo. Isso significa que, quando o trajeto rastreado estiver a cinco paradas do local da tarefa, o veículo vai aparecer, mas o trajeto dele só vai aparecer quando o trajeto estiver a três paradas.

```js
"taskTrackingViewConfig": {
  "routePolylinePointsVisibility": {
    "remainingStopCountThreshold": 3
  },
  "vehicleLocationVisibility": {
    "remainingStopCountThreshold": 5
  },
}
```

As polilinhas de trajeto e a localização do veículo especificam as diferentes opções de visibilidade

Quando as polilinhas de trajeto e a localização do veículo têm opções de visibilidade diferentes, a localização do veículo só fica visível quando ambas as opções de visibilidade são atendidas. Novamente, a visibilidade da polilinha está sujeita às regras de visibilidade do veículo:

Sempre visível: uma polilinha de trajeto precisa usar a opção de visibilidade sempre visível quando o local do veículo também oferece essa mesma opção de visibilidade sempre visível.
Nunca visível: uma polilinha de trajeto precisa usar uma opção de visibilidade nunca visível quando o local do veículo usa uma opção de visibilidade nunca visível.

Segue um exemplo:

  "taskTrackingViewConfig": {
    "routePolylinePointsVisibility": {
      "remainingStopCountThreshold": 3
    },
    "vehicleLocationVisibility": {
      "remainingDrivingDistanceMetersThreshold": 3000
    },
  }

Neste exemplo, a localização do veículo só fica visível se o número de paradas restantes for de pelo menos 3 E a distância restante for de pelo menos 3.000 metros.

Exemplo de personalização da visibilidade de tarefas

Os exemplos a seguir mostram como definir uma tarefa com as seguintes regras de visibilidade:

Mostre as polilinhas do trajeto se o veículo estiver a até três paradas de distância.
Mostre o HEC se a distância restante do trajeto for menor que 5.000 metros.
Nunca mostrar o número de paradas restantes.
Os outros campos mantêm a visibilidade padrão de serem mostrados quando o veículo está a até cinco paradas da tarefa.

Consulte TaskTrackingViewConfig para gRPC ou REST.

gRPC

static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String TASK_ID = "task-8241890";

DeliveryServiceBlockingStub deliveryService =
  DeliveryServiceGrpc.newBlockingStub(channel);

// Task settings
String taskName = "providers/" + PROJECT_ID + "/tasks/" + TASK_ID;
Task task = Task.newBuilder()
  .setName(taskName)
  .setTaskTrackingViewConfig(
    TaskTrackingViewConfig.newBuilder()
      .setRoutePolylinePointsVisibility(
        VisibilityOption.newBuilder().setRemainingStopCountThreshold(3))
      .setEstimatedArrivalTimeVisibility(
        VisibilityOption.newBuilder().remainingDrivingDistanceMetersThreshold(5000))
      .setRemainingStopCountVisibility(
        VisibilityOption.newBuilder().setNever(true)))
  .build();

// Task request
UpdateTaskRequest updateTaskRequest =
  UpdateTaskRequest.newBuilder()  // No need for the header
      .setTask(task)
      .setUpdateMask(FieldMask.newBuilder().addPaths("taskTrackingViewConfig"))
      .build();

try {
  Task updatedTask = deliveryService.updateTask(updateTaskRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
      case NOT_FOUND:
        break;
      case PERMISSION_DENIED:
        break;
  }
  return;
}

REST

Para definir a janela de configuração da visualização de planilha de controle de tarefas usando HTTP, chame PATCH e use updateMask para atualizar o parâmetro taskTrackingViewConfig:

PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks/<id>?updateMask=taskTrackingViewConfig

Exemplo:

# Set JWT, PROJECT_ID, and TASK_ID in the local environment
curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks/${TASK_ID}?updateMask=taskTrackingViewConfig" \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer ${JWT}" \
  --data-binary @- << EOM
{
  "taskTrackingViewConfig": {
    "routePolylinePointsVisibility": {
      "remainingStopCountThreshold": 3
    },
    "estimatedArrivalTimeVisibility": {
      "remainingDrivingDistanceMetersThreshold": 5000
    },
    "remainingStopCountVisibility": {
      "never": true
    }
  }
}
EOM

A seguir

Excluir tarefa

Configurar tarefas Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Definir a janela de tempo desejada

gRPC

REST

Personalizar a visibilidade das tarefas

Regras de visibilidade do marcador de local

Regras de visibilidade de dados de tarefas

Regras de visibilidade de tarefas de indisponibilidade

Visibilidade das tarefas ativas do veículo

Polilinhas de trajeto e regras de visibilidade da localização do veículo

As polilinhas de trajeto e a localização do veículo especificam as mesmas opções de visibilidade.

As polilinhas de trajeto e a localização do veículo especificam as diferentes opções de visibilidade

Exemplo de personalização da visibilidade de tarefas

gRPC

REST

A seguir

Configurar tarefas