Konfigurowanie zadań

W tym dokumencie zakładamy, że wiesz, jak tworzyć zadania i z nich korzystać. Zawiera ona konkretne przykłady konfigurowania zadań związanych z dostawą w następujący sposób:

• Ustaw docelowy przedział czasu dla zadania związanego z dostawą: ustaw przedział czasu, w którym zadanie ma zostać wykonane.

• Dostosowywanie widoczności zadań: dostosuj widoczność działań związanych z zadaniem, aby wyświetlać je klientom lub operatorom floty.

Szczegółowe informacje o polach zadań związanych z wysyłką znajdziesz w artykule Tworzenie zadań związanych z wysyłką. Gdy aktualizujesz dodatkowe informacje o istniejących zadaniach, musisz podać odpowiedni identyfikator zadania oraz pola, które aktualizujesz.

Ustaw docelowe okno czasowe

Docelowe okno czasowe to TimeWindow, w którym należy wykonać zadanie. Jeśli na przykład informujesz odbiorców o przewidywanym czasie dostawy, możesz użyć docelowego przedziału czasu zadania, aby zarejestrować ten przedział i generować alerty. Możesz też użyć go do analizowania skuteczności poprzednich przejazdów.

Docelowy przedział czasu składa się z godziny rozpoczęcia i godziny zakończenia i można go ustawić dla dowolnego typu zadania. Docelowe okno czasowe nie ma wpływu na zachowanie routingu.

Poniższe przykłady pokazują, jak ustawić przedział czasu za pomocą biblioteki Java gRPC lub jak wysłać żądanie HTTP REST do UpdateTask. Możesz też ustawić to pole podczas tworzenia zadania.

  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;
  }

# 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

Dostosowywanie widoczności zadań

Domyślnie Fleet Engine zapewnia wgląd w aktywności związane z zadaniami, które można następnie wyświetlać zarówno klientom otrzymującym przesyłkę, jak i operatorom flot śledzącym przesyłki. Obejmuje to informacje takie jak liczba przystanków przed wysłaniem klientowi powiadomienia o stanie dostawy paczki. Możesz dostosować te informacje do poszczególnych zadań, aby lepiej dopasować je do swojego modelu biznesowego.

Ta sekcja opisuje reguły widoczności śledzonych obiektów na mapie. Te reguły dotyczą 2 kategorii obiektów:

• Widoczność znacznika lokalizacji
• Widoczność danych o zadaniach dla aktywnych zadań dotyczących pojazdów, takich jak linie łamane i szacowany czas przyjazdu

Reguły widoczności znacznika lokalizacji

Fleet Engine wyświetla znaczniki lokalizacji miejsca dostawy przesyłki widoczne na mapie niezależnie od stanu dostawy.

Reguły widoczności danych zadań

W tej sekcji opisujemy domyślne reguły widoczności, które mają zastosowanie do danych zadań. Możesz dostosowywać tylko aktywne zadania dotyczące pojazdu, co oznacza, że niestandardowe reguły widoczności mogą być stosowane tylko do zadań związanych z odbiorem i dostawą.

Nie można dostosowywać tych zadań:

• Zaplanowane przystanki
• Zadania dotyczące niedostępności
• Nieaktywne zadania dotyczące pojazdu

Reguły widoczności zadań dotyczących niedostępności

Domyślnie pojazd nie pojawia się na mapie, jeśli do śledzonego zadania jest przypisane co najmniej jedno zadanie niedostępności. Na przykład gdy kierowca robi przerwę lub pojazd jest tankowany na trasie do śledzonej przesyłki. Szacowany czas przybycia i szacowany czas ukończenia zadania są nadal dostępne. Pamiętaj, że nie możesz dostosować tej reguły.

Widoczność aktywnych zadań dotyczących pojazdów

Obiekt TaskTrackingInfo udostępnia szereg elementów danych, które możesz wyświetlać za pomocą biblioteki śledzenia przesyłek. Domyślnie te pola są widoczne, gdy zadanie jest przypisane do pojazdu i gdy pojazd znajduje się w odległości 5 przystanków od zadania. Widoczność kończy się po ukończeniu lub anulowaniu zadania.

Możesz dostosować konfigurację widoczności dla poszczególnych zadań, ustawiając TaskTrackingViewConfig w przypadku zadania podczas jego tworzenia lub aktualizowania w Fleet Engine. Spowoduje to utworzenie reguł udostępniania poszczególnych elementów danych.

W tabeli poniżej znajdziesz pola, do których możesz zastosować reguły widoczności.

W tej tabeli znajdziesz opcje widoczności dostępne w przypadku pól wymienionych powyżej.

Linie łamane trasy i reguły widoczności lokalizacji pojazdu

W przypadku śledzonej trasy widoczność linii łamanych trasy zależy od widoczności pojazdu. Jeśli na aktywnej trasie widoczna jest linia łamana trasy, a pojazd nie jest widoczny, lokalizację pojazdu można nadal określić na podstawie końca widocznej linii łamanej. Dlatego widoczność linii łamanej trasy musi być tak samo lub bardziej restrykcyjna niż widoczność pojazdu.

Aby podać prawidłową kombinację widoczności linii łamanych trasy i lokalizacji pojazdu, postępuj zgodnie z tymi zasadami.

Linie łamane trasy i lokalizacja pojazdu mają te same opcje widoczności.

W tym scenariuszu zarówno linia łamana, jak i lokalizacja pojazdu ustawiają te same opcje, które obejmują:

• liczba pozostałych przystanków,
• czas do szacowanego czasu dotarcia,
• pozostała odległość do przejechania,

Aby zachować zgodność z zasadami, wartość widoczności polilinii trasy musi być mniejsza lub równa wartości ustawionej dla widoczności pojazdu. W tym przykładzie próg pozostałych przystanków na wielolinii jest ustawiony na 3, czyli mniej niż wartość 5 określona dla pojazdu. Oznacza to, że gdy śledzona podróż będzie 5 przystanków od miejsca docelowego, pojawi się pojazd, ale trasa tego pojazdu nie będzie widoczna, dopóki podróż nie będzie 3 przystanki od miejsca docelowego.

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

Linie trasy i lokalizacja pojazdu określają różne opcje widoczności.

Jeśli polilinie trasy i lokalizacja pojazdu mają różne opcje widoczności, lokalizacja pojazdu jest widoczna tylko wtedy, gdy spełnione są obie opcje widoczności. Widoczność linii łamanej podlega regułom widoczności pojazdu:

• Zawsze widoczna: linia łamana trasy musi używać opcji widoczności zawsze widoczna, jeśli lokalizacja pojazdu również udostępnia tę samą opcję widoczności zawsze widoczna.
• Nigdy nie widoczna: linia łamana trasy musi używać opcji widoczności nigdy nie widoczna, gdy lokalizacja pojazdu używa opcji widoczności nigdy nie widoczna.

Przykład:

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

W tym przykładzie lokalizacja pojazdu jest widoczna tylko wtedy, gdy liczba pozostałych przystanków jest co najmniej równa 3 I pozostała odległość do przejechania wynosi co najmniej 3000 metrów.

Przykład dostosowywania widoczności zadań

Poniższe przykłady pokazują, jak ustawić zadanie z tymi regułami widoczności:

• Wyświetlanie linii łamanych trasy, jeśli pojazd znajduje się w odległości 3 przystanków.
• Wyświetl szacowany czas przyjazdu, jeśli pozostała odległość do przejechania jest mniejsza niż 5000 metrów.
• Nigdy nie pokazuj pozostałej liczby przystanków.
• Pozostałe pola zachowują domyślną widoczność, czyli są wyświetlane, gdy pojazd znajduje się w odległości 5 przystanków od miejsca wykonania zadania.

Więcej informacji o gRPC i REST znajdziesz w sekcji TaskTrackingViewConfig.

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;
}

# 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

Co dalej?

• Usuń zadanie