Teslimat aracı görevlerini güncelle

Bu dokümanda, aşağıdaki konular hakkında bilgi sahibi olduğunuz varsayılır:

Gerçek hayattaki bir teslimat senaryosunda işletmeler, teslimat gönderisi görevlerini sürücülere atar. Sürücüler de bir araç kullanarak bunları planlanan bir konumda (ör. konut veya bina kompleksindeki teslimat odası) alıcıya teslim eder. Fleet Engine'de bunu bir görev oluşturup teslimat aracı güncelleme isteği göndererek modellendirirsiniz. Bu istek, araç öğesini gidilecek durakların listesiyle günceller. Her durakta tamamlanması gereken görevlerin listesini her durağa atarsınız.

Araç görevlerini istediğiniz zaman güncelleyebilirsiniz ancak genellikle aşağıdaki amaçlarla yaparsınız:

  • Bir aracın tamamlaması için görevler planlayın. Bunu, araca yeni bir durak ekleyen bir güncelleme isteğiyle veya mevcut bir durağa yeni bir görev ekleyen bir güncelleme isteğiyle yapabilirsiniz.
  • Belirli bir araç durağıyla ilişkili mevcut görevlerin sırasını güncelleyin.
  • Görevin tamamlanma konumunu değiştirme Fleet Engine, varsayılan olarak görev tamamlama konumunu, görevle ilişkili araç durağıyla aynı konum olarak işaretler. İsterseniz belirli görevler için belirli konumlar belirtebilirsiniz. Örneğin, bir aracın büyük bir komplekste durup her biri belirli bir posta teslimat odasına atanmış birkaç paket teslim etmesi gerekebilir.
  • Güncellenen sıralamanın dışında bırakmak için önceden atanmış görevleri kapatın. Ayrıntılar için Görevleri tamamlama başlıklı makaleyi inceleyin.

Teslimat görevlerini planlama veya değiştirme

Bir sunucu ortamından veya sürücüye güvenilir bir cihaz kullanarak görevleri yönetme olanağı sağlarsanız Driver SDK'yı kullanarak bir araca atanan görevleri planlayabilir veya değiştirebilirsiniz. Yarışma durumlarını önlemek ve tek bir doğruluk kaynağına sahip olmak için yalnızca bir yöntem kullanın.

Bir gönderiyi bir araçtan diğerine taşımak için orijinal görevi kapatın ve farklı bir araca atamadan önce yeniden oluşturun. Bir teslimat aracını, farklı bir araca atanmış bir görevi içerecek şekilde güncellerseniz hata alırsınız.

Görevleri güncellemek için zorunlu alanlar

Bu bölümde, bir araçla ilgili görevi güncellerken ayarlanması gereken alanlar açıklanmaktadır. İsteğe bağlı alanlar sağlanmaz. Fleet Engine, güncelleme için varlıktaki diğer tüm alanları yoksayar.

Zorunlu alanDeğer
remainingVehicleJourneySegments Görevlerin yürütülmesi gereken sırayla yolculuk segmentlerinin listesi. Listedeki ilk görev önce yürütülür.
remainingVehicleJourneySegments[i].stop Listedeki i görevinin durdurulması.
remainingVehicleJourneySegments[i].stop.plannedLocation Durağın planlanan konumu.
remainingVehicleJourneySegments[i].stop.tasks Bu araç durağında gerçekleştirilecek görevlerin listesi.
remainingVehicleJourneySegments[i].stop.state State.NEW

Görev atama örneği

Aşağıdaki örneklerde, araç için iki yeni görev eklemek üzere Java gRPC kitaplığının ve UpdateDeliveryVehicle için bir HTTP REST çağrısının nasıl kullanılacağı gösterilmektedir.

gRPC

 static final String PROJECT_ID = "my-delivery-co-gcp-project";
 static final String VEHICLE_ID = "vehicle-8241890";
 static final String TASK1_ID = "task-756390";
 static final String TASK2_ID = "task-849263";

 DeliveryServiceBlockingStub deliveryService =
   DeliveryServiceGrpc.newBlockingStub(channel);

 // Vehicle settings
 String vehicleName = "providers/" + PROJECT_ID + "/deliveryVehicles/" + VEHICLE_ID;
 DeliveryVehicle deliveryVehicle = DeliveryVehicle.newBuilder()
     .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.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 updateDeliveryRequest =
   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>, filonuzdaki bir teslimat aracının benzersiz tanımlayıcısıdır. Bu tanımlayıcı, görev sıralamasını güncellemek istediğiniz araç için kullanılır. Aracı oluştururken belirttiğiniz tanımlayıcıdır.

  • İstek başlığında, Bearer <token> değerine sahip bir Authorization alanı bulunmalıdır. Burada <token>, Hizmet hesabı rolleri ve JSON Web jetonları bölümünde açıklanan yönergelere göre sunucunuz tarafından verilir.

  • İstek gövdesi bir DeliveryVehicle varlığı 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.7749,
              "longitude": -122.084061
            }
          },
          "tasks": [
            {
              "taskId": "${TASK1_ID}"
            }
          ]
        }
      },
      {
        "stop": {
          "state": "NEW",
          "plannedLocation": {
            "point": {
              "latitude": 37.3382,
              "longitude": 121.8863
            }
          },
          "tasks": [
            {
              "taskId": "${TASK2_ID}"
            }
          ]
        }
      }
    ]
  }
  EOM

Sırada ne var?