Durma durumunu güncelle

Bu belgede, aşağıdakiler hakkında bilgi sahibi olduğunuz varsayılır:

Fleet Engine Essentials'daki Planlanmış görevler bölümünde belirtildiği gibi, görevler oluşturup bunları bir araç durağıyla ilişkilendirerek görev ile aracın durması beklenen konum arasındaki gerçek dünya ilişkisini modellendirirsiniz. Böylece sürücü görevi tamamlayabilir.

Buradan, görevlerin yaşam döngüsü boyunca ilerlemesini yönetmek için Fleet Engine'e güncellemeler gönderirsiniz. Böylece Fleet Engine, görev yolculuğu boyunca en iyi şekilde rota oluşturma ve durum güncellemeleri yapabilir. Bunu yapmanın önemli bir yolu, araç durağa yaklaştığında, durağa vardığında ve duraktan ayrıldığında araç durağını güncellemektir. Bu sayede hem filo operatörleri hem de son kullanıcılar için görev ilerleme durumu hakkında raporlama ve analiz yapılabilir. Bu durum güncellemeleri şunlardır:

  • Yolda: STATE numaralandırması, VehicleStop için ENROUTE kullanarak durağın, araç güzergahı listesinde bir sonraki durak olduğunu belirtir. Görev açısından bu, durakla ilişkili herhangi bir görevin listede tamamlanacak bir sonraki görev olduğu anlamına gelir.
  • Ulaştı: VehicleStop için STATE enum'u, aracın durağa ulaştığını belirtmek için ARRIVED kullanır. Görev açısından bakıldığında, durakla ilişkili tüm görevler üzerinde aktif olarak çalışılmasının durdurulduğu anlamına gelir.
  • Tamamlandı: Bir durağı, aracın durak listesinden kaldırarak tamamlandı olarak işaretleyebilirsiniz. Bu işlemi yaptığınızda Fleet Engine, ilişkili tüm görevleri otomatik olarak KAPALI olarak işaretler. Görevleri kapatma hakkında daha fazla bilgi için Görevleri sonlandırma başlıklı makaleyi inceleyin.

Bu belgede, sunucu tarafı yaklaşımlarını kullanarak güncelleme durdurma durumunun nasıl güncelleneceği açıklanmaktadır. Sürücüye, görevleri güvenilir bir cihaz kullanarak yönetme olanağı sağlarsanız bunu sürücü uygulamanızdan da yapabilirsiniz. Yarışma koşullarından kaçınmak ve tek bir doğru kaynak kullanmak için yalnızca bir yöntem kullanın.

Araç durağa doğru gidiyor

Sisteminiz, araç bir sonraki durağa gitmek için navigasyona başladığında Fleet Engine'e bildirim göndermelidir. Bu, tahmini varış zamanını ve rota hesaplamalarını iyileştirir.

Güncellemeleri durdurmak için zorunlu alanlar

Fleet Engine, bildirim için varlıktaki diğer tüm alanları yoksayar.

AlanDeğer
remainingVehicleJourneySegments Durumları State.NEW olarak işaretlenmiş kalan araç duraklarının listesi.

Durağa giderken örnek

Aşağıdaki örneklerde, Java gRPC kitaplığı veya UpdateDeliveryVehicle için bir HTTP REST çağrısı kullanarak Fleet Engine'e bir aracın bir sonraki durağına doğru yolda olduğunu nasıl bildireceğiniz gösterilmektedir.Diğer tüm duraklar yeni olarak işaretlenir.

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>, görevin benzersiz tanımlayıcısıdır.
  • İstek başlığında, Authorization alanı ve Bearer <token> değeri bulunmalıdır. Burada <token>, Hizmet hesabı rolleri ve JSON Web jetonları'nda açıklanan yönergelere göre sunucunuz tarafından verilir.
  • İstek metni bir DeliveryVehicle öğesi içermelidir:

Örnek curl komutu:

 # 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

Aracın durağa varışı

Bir araç durağa ulaştığında Fleet Engine'e bildirim gönderilmelidir.

Güncellemeleri durdurmak için zorunlu alanlar

Fleet Engine, bildirim için varlıktaki diğer tüm alanları yoksayar.

AlanDeğer
remainingVehicleJourneySegments Durumları State.NEW olarak işaretlenmiş kalan araç duraklarının listesi.

Durağa varma örneği

Aşağıdaki örneklerde, Java gRPC kitaplığı veya UpdateDeliveryVehicle için bir HTTP REST çağrısı kullanarak bir aracın durağa ulaştığını Fleet Engine'e nasıl bildireceğiniz gösterilmektedir. Diğer tüm duraklar yeni olarak işaretlenir.

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`
  • <id>, görevin benzersiz tanımlayıcısıdır.
  • İstek başlığında, Authorization alanı ve Bearer <token> değeri bulunmalıdır. Burada <token>, Hizmet hesabı rolleri ve JSON Web jetonları'nda açıklanan yönergelere göre sunucunuz tarafından verilir.
  • İstek metni bir DeliveryVehicle öğesi içermelidir:

Örnek curl komutu:

  # 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

Araç bir durağı tamamlıyor

Bir araç duraklamayı tamamladığında Fleet Engine'e bildirim gönderilmelidir. Bu durumda, durakla ilişkili tüm görevler KAPALI durumuna ayarlanır.

Güncellemeleri durdurmak için zorunlu alanlar

Fleet Engine, bildirim için varlıktaki diğer tüm alanları yoksayar.

AlanDeğer
remainingVehicleJourneySegments Durumları State.NEW olarak işaretlenmiş kalan araç duraklarının listesi. Listedeki ilk durağın durumu State.ENROUTE olarak işaretlenmelidir.

Durdurma örneğini tamamlama

Aşağıdaki örneklerde, Java gRPC kitaplığı veya UpdateDeliveryVehicle için bir HTTP REST çağrısı kullanarak bir aracın durağa ulaştığını Fleet Engine'e nasıl bildireceğiniz gösterilmektedir. Diğer tüm duraklar yeni olarak işaretlenir.

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`
  • <id>, görevin benzersiz tanımlayıcısıdır.
  • İstek başlığında, Authorization alanı ve Bearer <token> değeri bulunmalıdır. Burada <token>, Hizmet hesabı rolleri ve JSON Web jetonları'nda açıklanan yönergelere göre sunucunuz tarafından verilir.
  • İstek metni bir DeliveryVehicle öğesi içermelidir:

Örnek curl komutu:

 # 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

Sırada ne var?