Aktualizuj stan zatrzymania

W tym dokumencie zakładamy, że znasz te zagadnienia:

• Tworzenie zadań związanych z dostawą
• Wprowadzenie do zaplanowanych zadań, w którym omawiamy między zadaniami, przystankami i pojazdami.

Zgodnie z opisem w sekcji Zaplanowane zadania w Fleet Engine Essentials – możesz tworzyć zadania i wiązać je z pojazdem. jako sposób na modelowanie rzeczywistego powiązania między zadaniem a miejsce, w którym pojazd powinien się zatrzymać, aby umożliwić kierowcy danego zadania.

Możesz tam zarządzać postępami zadań w całym cyklu ich życia, bazując na wysyłanie aktualizacji do Fleet Engine, aby zapewnić jak najlepsze usługi w zakresie routingu i stanu aktualizacji w trakcie ścieżki zadań. Jednym ze sposobów jest zaktualizowanie zatrzymuje się, gdy pojazd zbliża się do przystanku, zbliża się do niego i z niego opuszcza. Umożliwia to raportowanie i analizę postępu zadań w przypadku Operatorzy floty i użytkownicy. Stan reklam:

• Droga: wyliczenie STATE dla VehicleStop wykorzystuje ENROUTE do wskazują, że przystanek jest kolejnym na liście planu podróży pojazdu. Z punktu widzenia zadania oznacza to każde zadanie związane z przystankiem jest następne na liście do uzupełnienia.
• Odebrano: wyliczenie STATE dla VehicleStop używa ARRIVED, aby wskazać że pojazd dotarł na postój. Z perspektywy projektu oznacza to, że każde zadanie związane z przerwą jest aktywnie wykonywane.
• Ukończono: przystanek oznaczasz jako ukończony, usuwając go z listy. dla pojazdu. Gdy to zrobisz, Fleet Engine automatycznie oznaczy znaczniki wszystkie powiązane zadania jako ZAMKNIĘTE. Więcej informacji o zamykaniu zadań znajdziesz w artykule Kończenie zadań.

W tym dokumencie opisujemy sposób zatrzymania aktualizacji po stronie serwera. Ty można to też zrobić w aplikacji kierowcy, jeśli umożliwisz kierowcy i zarządzać zadaniami na zaufanym urządzeniu. Używaj tylko jednej metody, aby uniknąć wyścigu warunki i utrzymanie jednego źródła danych.

Pojazd jest w drodze do zatrzymania

System powinien powiadomić Fleet Engine, gdy pojazd rozpocznie nawigację do następny przystanek. Poprawia to szacowany czas dotarcia na miejsce i obliczanie trasy.

Pola wymagane do aktualizacji przystanków

W przypadku powiadomienia Fleet Engine ignoruje wszystkie pozostałe pola w elemencie.

Pole	Wartość
remainingVehicleJourneySegments	Lista pozostałych przystanków dla pojazdów ze stanami oznaczonymi jako stan.NOWY.

Przykład trasy w drodze do zatrzymania

Poniższe przykłady pokazują, jak powiadamiać Fleet Engine, że pojazd w drodze do następnego przystanku przy użyciu biblioteki gRPC Java lub HTTP. Wywołanie REST do: UpdateDeliveryVehicle.Pozostałe przystanki są oznaczone jako nowe.

gRPC

 static final String PROJECT_ID = "my-delivery-co-gcp-project";
 static final String VEHICLE_ID = "vehicle-8241890";

 DeliveryServiceBlockingStub deliveryService =
   DeliveryServiceGrpc.newBlockingStub(channel);

 // Vehicle settings
 DeliveryVehicle deliveryVehicle = DeliveryVehicle.newBuilder()
     // Next stop marked as ENROUTE
     .addRemainingVehicleJourneySegments(VehicleJourneySegment.newBuilder()  // 1st stop
        .setStop(VehicleStop.newBuilder()
            .setPlannedLocation(LocationInfo.newBuilder()
                .setPoint(LatLng.newBuilder()
                    .setLatitude(37.7749)
                    .setLongitude(122.4194)))
            .addTasks(TaskInfo.newBuilder().setTaskId(TASK1_ID))
            .setState(VehicleStop.State.ENROUTE)))
     // All other stops marked as NEW
     .addRemainingVehicleJourneySegments(VehicleJourneySegment.newBuilder()  // 2nd stop
        .setStop(VehicleStop.newBuilder()
            .setPlannedLocation(LocationInfo.newBuilder()
                .setPoint(LatLng.newBuilder()
                    .setLatitude(37.3382)
                    .setLongitude(121.8863)))
            .addTasks(TaskInfo.newBuilder().setTaskId(TASK2_ID))
            .setState(VehicleStop.State.NEW)))
     .build();

 // DeliveryVehicle request
 UpdateDeliveryVehicleRequest updateDeliveryVehicleRequest =
   UpdateDeliveryVehicleRequest.newBuilder()  // No need for the header
       .setName(vehicleName)
       .setDeliveryVehicle(deliveryVehicle)
       .setUpdateMask(FieldMask.newBuilder().addPaths("remaining_vehicle_journey_segments"))
       .build();

 try {
   DeliveryVehicle updatedDeliveryVehicle =
       deliveryService.updateDeliveryVehicle(updateDeliveryVehicleRequest);
 } catch (StatusRuntimeException e) {
   Status s = e.getStatus();
   switch (s.getCode()) {
      case NOT_FOUND:
        break;
      case PERMISSION_DENIED:
        break;
   }
   return;
 }

REST

PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles/<id>?updateMask=remainingVehicleJourneySegments`

• <id> to unikalny identyfikator zadania.
• Nagłówek żądania musi zawierać pole Authorization z wartością Bearer <token>, gdzie <token> jest wydawany przez serwer zgodnie z wytycznymi opisanymi w artykule Role na koncie usługi oraz Tokeny internetowe JSON.
• Treść żądania musi zawierać element DeliveryVehicle:

Przykładowe polecenie curl:

Uwaga: to polecenie zastępuje wszystkie remainingVehicleJourneySegments jest już skonfigurowany na pojeździe dostarczanym.

 # Set JWT, PROJECT_ID, VEHICLE_ID, TASK1_ID, and TASK2_ID in the local
 # environment
 curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles/${VEHICLE_ID}?updateMask=remainingVehicleJourneySegments" \
   -H "Content-type: application/json" \
   -H "Authorization: Bearer ${JWT}" \
   --data-binary @- << EOM
 {
   "remainingVehicleJourneySegments": [
     {
       "stop": {
         "state": "ENROUTE",
         "plannedLocation": {
           "point": {
             "latitude": 37.7749,
             "longitude": -122.084061
           }
         },
         "tasks": [
           {
             "taskId": "${TASK1_ID}"
           }
         ]
       }
     },
     {
       "stop": {
         "state": "NEW",
         "plannedLocation": {
           "point": {
             "latitude": 37.3382,
             "longitude": 121.8863
           }
         },
         "tasks": [
           {
             "taskId": "${TASK2_ID}"
           }
         ]
       }
     }
   ]
 }
 EOM

Pojazd na przystanku

Musisz powiadamiać Fleet Engine, gdy pojazd znajdzie się na przystanku.

Pola wymagane do aktualizacji przystanków

W przypadku powiadomienia Fleet Engine ignoruje wszystkie pozostałe pola w elemencie.

Pole	Wartość
remainingVehicleJourneySegments	Lista pozostałych przystanków dla pojazdów ze stanami oznaczonymi jako stan.NOWY.

Przykładowy przystanek

Poniższe przykłady pokazują, jak powiadomić Fleet Engine o przybyciu pojazdu za pomocą biblioteki gRPC Java lub wywołania REST HTTP do UpdateDeliveryVehicle Wszystkie inne przystanki zostaną oznaczone jako nowe.

gRPC

  static final String PROJECT_ID = "my-delivery-co-gcp-project";
  static final String VEHICLE_ID = "vehicle-8241890";

  DeliveryServiceBlockingStub deliveryService =
    DeliveryServiceGrpc.newBlockingStub(channel);

  // Vehicle settings
  String vehicleName = "providers/" + PROJECT_ID + "/deliveryVehicles/" + VEHICLE_ID;
  DeliveryVehicle deliveryVehicle = DeliveryVehicle.newBuilder()
      // Marking the arrival at stop.
      .addRemainingVehicleJourneySegments(VehicleJourneySegment.newBuilder()
         .setStop(VehicleStop.newBuilder()
             .setPlannedLocation(LocationInfo.newBuilder()
                 .setPoint(LatLng.newBuilder()
                     .setLatitude(37.7749)
                     .setLongitude(122.4194)))
             .addTasks(TaskInfo.newBuilder().setTaskId(TASK1_ID))
             .setState(VehicleStop.State.ARRIVED)))
      // All other remaining stops marked as NEW.
      .addRemainingVehicleJourneySegments(VehicleJourneySegment.newBuilder()  // 2nd stop
         .setStop(VehicleStop.newBuilder()
             .setPlannedLocation(LocationInfo.newBuilder()
                 .setPoint(LatLng.newBuilder()
                     .setLatitude(37.3382)
                     .setLongitude(121.8863)))
             .addTasks(TaskInfo.newBuilder().setTaskId(TASK2_ID))
             .setState(VehicleStop.State.NEW))) // Remaining stops must be NEW.
      .build();

  // DeliveryVehicle request
  UpdateDeliveryVehicleRequest updateDeliveryVehicleRequest =
    UpdateDeliveryVehicleRequest.newBuilder()  // No need for the header
        .setName(vehicleName)
        .setDeliveryVehicle(deliveryVehicle)
        .setUpdateMask(FieldMask.newBuilder()
            .addPaths("remaining_vehicle_journey_segments"))
        .build();

  try {
    DeliveryVehicle updatedDeliveryVehicle =
        deliveryService.updateDeliveryVehicle(updateDeliveryVehicleRequest);
  } catch (StatusRuntimeException e) {
    Status s = e.getStatus();
    switch (s.getCode()) {
       case NOT_FOUND:
         break;
       case PERMISSION_DENIED:
         break;
    }
    return;
  }

REST

`PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles/<id>?updateMask=remainingVehicleJourneySegments`

• &lt;id&gt; to unikalny identyfikator zadania.
• Nagłówek żądania musi zawierać pole Authorization z wartością Bearer <token>, gdzie <token> jest wydawany przez serwer zgodnie z wytycznymi opisanymi w artykule Role na koncie usługi oraz Tokeny internetowe JSON.
• Treść żądania musi zawierać element DeliveryVehicle:

Przykładowe polecenie curl:

Uwaga: to polecenie powoduje zastąpienie wszystkich istniejących już operacji remainingVehicleJourneySegments na pojeździe dostarczanym.

  # Set JWT, PROJECT_ID, VEHICLE_ID, TASK1_ID, and TASK2_ID in the local
  # environment
  curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles/${VEHICLE_ID}?updateMask=remainingVehicleJourneySegments" \
    -H "Content-type: application/json" \
    -H "Authorization: Bearer ${JWT}" \
    --data-binary @- << EOM
  {
    "remainingVehicleJourneySegments": [
      {
        "stop": {
          "state": "ARRIVED",
          "plannedLocation": {
            "point": {
              "latitude": 37.7749,
              "longitude": -122.084061
            }
          },
          "tasks": [
            {
              "taskId": "${TASK1_ID}"
            }
          ]
        }
      },
      {
        "stop": {
          "state": "NEW",
          "plannedLocation": {
            "point": {
              "latitude": 37.3382,
              "longitude": 121.8863
            }
          },
          "tasks": [
            {
              "taskId": "${TASK2_ID}"
            }
          ]
        }
      }
    ]
  }
  EOM

Pojazd zatrzymuje się

Gdy pojazd się zatrzyma. To powoduje wszystkie zadania powiązane z przystankiem zostaną ustawione na ZAMKNIĘTE.

Pola wymagane do aktualizacji przystanków

W przypadku powiadomienia Fleet Engine ignoruje wszystkie pozostałe pola w elemencie.

Pole	Wartość
remainingVehicleJourneySegments	Lista pozostałych przystanków dla pojazdów ze stanami oznaczonymi jako stan.NOWY. Pierwszy przystanek na liście musi mieć stan State.ENROUTE.

Kończy przykład zatrzymania

Poniższe przykłady pokazują, jak powiadomić Fleet Engine o przybyciu pojazdu za pomocą biblioteki gRPC Java lub wywołania REST HTTP do UpdateDeliveryVehicle Wszystkie inne przystanki zostaną oznaczone jako nowe.

gRPC

  static final String PROJECT_ID = "my-delivery-co-gcp-project";
  static final String VEHICLE_ID = "vehicle-8241890";

  DeliveryServiceBlockingStub deliveryService =
    DeliveryServiceGrpc.newBlockingStub(channel);

  // Vehicle settings
  String vehicleName = "providers/" + PROJECT_ID + "/deliveryVehicles/" + VEHICLE_ID;
  DeliveryVehicle deliveryVehicle = DeliveryVehicle.newBuilder()
      // This stop has been completed and is commented out to indicate it
      // should be removed from the list of vehicle journey segments.
      // .addRemainingVehicleJourneySegments(VehicleJourneySegment.newBuilder()
      //    .setStop(VehicleStop.newBuilder()
      //        .setPlannedLocation(LocationInfo.newBuilder()
      //            .setPoint(LatLng.newBuilder()
      //                .setLatitude(37.7749)
      //                .setLongitude(122.4194)))
      //        .addTasks(TaskInfo.newBuilder().setTaskId(TASK1_ID))
      //        .setState(VehicleStop.State.ARRIVED)))
      // All other remaining stops marked as NEW.
      // The next stop could be marked as ENROUTE if the vehicle has begun
      // its journey to the next stop.
      .addRemainingVehicleJourneySegments(VehicleJourneySegment.newBuilder()  // Next stop
         .setStop(VehicleStop.newBuilder()
             .setPlannedLocation(LocationInfo.newBuilder()
                 .setPoint(LatLng.newBuilder()
                     .setLatitude(37.3382)
                     .setLongitude(121.8863)))
             .addTasks(TaskInfo.newBuilder().setTaskId(TASK2_ID))
             .setState(VehicleStop.State.NEW)))
      .build();

  // DeliveryVehicle request
  UpdateDeliveryVehicleRequest updateDeliveryVehicleRequest =
    UpdateDeliveryVehicleRequest.newBuilder()  // no need for the header
        .setName(vehicleName)
        .setDeliveryVehicle(deliveryVehicle)
        .setUpdateMask(FieldMask.newBuilder()
            .addPaths("remaining_vehicle_journey_segments"))
        .build();

  try {
    DeliveryVehicle updatedDeliveryVehicle =
        deliveryService.updateDeliveryVehicle(updateDeliveryVehicleRequest);
  } catch (StatusRuntimeException e) {
    Status s = e.getStatus();
    switch (s.getCode()) {
       case NOT_FOUND:
         break;
       case PERMISSION_DENIED:
         break;
    }
    return;
  }

REST

PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles/<id>?updateMask=remaining_vehicle_journey_segments`

• &lt;id&gt; to unikalny identyfikator zadania.
• Nagłówek żądania musi zawierać pole Authorization z wartością Bearer <token>, gdzie <token> jest wydawany przez serwer zgodnie z wytycznymi opisanymi w artykule Role na koncie usługi oraz Tokeny internetowe JSON.
• Treść żądania musi zawierać element DeliveryVehicle:

Przykładowe polecenie curl:

Uwaga: to polecenie powoduje zastąpienie wszystkich istniejących już operacji remainingVehicleJourneySegments na pojeździe dostarczanym.

 # Set JWT, PROJECT_ID, VEHICLE_ID, TASK1_ID, and TASK2_ID in the local
 # environment
 curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles/${VEHICLE_ID}?updateMask=remainingVehicleJourneySegments" \
   -H "Content-type: application/json" \
   -H "Authorization: Bearer ${JWT}" \
   --data-binary @- << EOM
 {
   "remainingVehicleJourneySegments": [
     {
       "stop": {
         "state": "NEW",
         "plannedLocation": {
           "point": {
             "latitude": 37.3382,
             "longitude": 121.8863
           }
         },
         "tasks": [
           {
             "taskId": "${TASK2_ID}"
           }
         ]
       }
     }
   ]
 }
 EOM

Co dalej?

• Kończenie zadań