Görevleri tamamlama

Bu belgede, görev oluşturma ve kullanma hakkında bilgi sahibi olduğunuz varsayılır. Aşağıda, gönderim görevlerinin nasıl tamamlanacağıyla ilgili spesifik örnekler verilmiştir:

  • Görevi kapatma: Bir kargo görevini kapattığınızda görevin durumu CLOSED olarak değişir ve bu görevin artık etkin olmadığı belirtilir.

  • Görevin sonucunu ayarlama: Bir görev kapatıldıktan sonra sonucunu SUCCEEDED veya FAILED olarak ayarlayarak görevi tamamlayabilirsiniz. Bu, teslimat sonucunu yolculuk paylaşımında göstermek ve Fleet Engine hizmeti için doğru faturalandırma sağlamak amacıyla bir görevi tamamlamanın önemli bir parçasıdır.

Görevi kapatma

Bir görevi aşağıdaki şekillerde kapatabilirsiniz:

  • Aracın durdurma durumunu güncelleyin. Aracın durdurulmasını kaldırdığınızda durdurmayla ilişkili tüm görevler kapatılır. Ayrıntılar için Güncellemeyi durdurma durumuna bakın.
  • Görevi araç durakları listesinden kaldırın. Bu işlem, durakla ilgili görev listesini güncelleme ancak listede artık kapalı görev bulunmama durumunu içerir. Görevleri güncelleme bölümündeki "Görev sırasını güncelleme" başlıklı makaleyi inceleyin.
  • Görev durumunu CLOSED olarak ayarlayın. Bu işlem yalnızca araçlara atanmamış görevlerde yapılabilir. Bu bölümde bu yaklaşım gösterilmektedir.

Kapattığınız görevleri yeniden açamazsınız.

Bir görevin kapatılması, görevin başarılı veya başarısız olduğunu göstermez. Bu, görevin artık devam ediyor olarak kabul edilmediğini gösterir. Bir görevin gerçek sonucunu belirtmek ve bu sonucun filo takibi ile yolculuk paylaşımı amacıyla gösterilmesini sağlamak için görevin gerçek sonucunu belirtmeniz gerekir. Aşağıdaki Görev sonucunu ayarlama bölümünü inceleyin.

Görevleri kapatmak için görev alanları

Bu bölümde, bir görevi kapatırken ayarlanması gereken zorunlu alanlar açıklanmaktadır. Filo motoru, güncelleme için öğedeki diğer tüm alanları yoksayar.

Zorunlu alan Değer
state State.CLOSED

Görevi doğrudan kapatma

Aşağıdaki örneklerde, atanmamış bir görevin gRPC'de veya UpdateTask için HTTP REST istek çağrısı kullanılarak nasıl kapalı duruma ayarlanacağı gösterilmektedir.

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)
   .setState(Task.State.CLOSED) // You can only directly CLOSE a
   .build();                    // task that is NOT assigned to a vehicle.

 // Task request
 UpdateTaskRequest updateTaskRequest =
   UpdateTaskRequest.newBuilder()  // No need for the header
       .setTask(task)
       .setUpdateMask(FieldMask.newBuilder().addPaths("state"))
       .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

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

  • <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 metnine bir Task öğesi eklemeniz gerekir.

Örnek curl komutu:

 # 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=state,taskOutcome,taskOutcomeTime" \
   -H "Content-type: application/json" \
   -H "Authorization: Bearer ${JWT}" \
   --data-binary @- << EOM
 {
   "state": "CLOSED",
   "taskOutcome": "SUCCEEDED",
   "taskOutcomeTime": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
 }
 EOM

Görevin sonucunu ayarlama

Bir görevin gerçek sonucunu belirtmek için kapalı görevlerin sonucunu SUCCEEDED veya FAILED olarak ayarlarsınız. Bir görevin sonucunu belirlemeden önce görevi kapatmanız gerekir. Fleet Engine yalnızca SUCCEEDED durumundaki teslimat görevleri için ücret alır.

Görev sonucu ayrıntıları

Görevler, görev sonucu hakkında ek ayrıntılar da sağlar. Bunları doğrudan ayarlayabilirsiniz ve Fleet Engine ayarlarınıza uyar:

  • Görev sonucu konumu: Fleet Engine, görev sonucu konumunu bilinen son araç konumuyla otomatik olarak doldurur. Dilerseniz bunun yerine bu bilgiyi sağlayabilirsiniz.
  • Görev sonucu zamanı: Fleet Engine bu alanı doldurmaz ancak sizin ayarlamanız için kullanılabilir.

task_outcome_location ve task_outcome_time değerlerini ayarlamak için aşağıdaki yaklaşımlardan herhangi birini kullanabilirsiniz:

  • Bunları, görev sonucunu belirleyen aynı istekte güncelleyin.
  • Görev sonucunu belirledikten sonra bunları daha sonra güncelleyebilirsiniz.
  • Ayarlar belirlendikten sonra tekrar değiştirilebilir.

Filo Motoru, görev sonuçlarıyla ilgili aşağıdaki güncellemeleri engeller:

  • Bir görev sonucu SUCCEEDED veya FAILED olarak ayarlandıktan sonra değiştirilemez.
  • Sonucu belirlenmemiş görevler için görev sonucu konumu veya sonucu zamanı ayarlayamazsınız.

Sonucu ayarlamak için kullanılan görev alanları

Bu bölümde, görev sonucu ayarlanırken belirlenmesi gereken zorunlu ve isteğe bağlı alanlar açıklanmaktadır. Fleet Engine, güncelleme için öğedeki diğer alanları yoksayar.

Zorunlu alan Değer
taskOutcome Outcome.SUCCEEDED veya Outcome.FAILED

İsteğe bağlı alanDeğer
taskOutcomeLocation Görevin tamamlandığı konum. Ayarlanmazsa Fleet Engine, bunu varsayılan olarak son araç konumuna ayarlar.
taskOutcomeTime Görevin tamamlandığı zaman damgası.

Görev sonucu örnekleri

Aşağıdaki örnekte, Java gRPC kitaplığı ve bir HTTP REST çağrısı kullanılarak UpdateTask'da bir görev sonucunun SUCCEEDED olarak nasıl ayarlanacağı ve görevin tamamlandığı konumun nasıl belirleneceği gösterilmektedir.

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)
   .setTaskOutcome(TaskOutcome.SUCCEEDED)
   .setTaskOutcomeTime(now())
   .setTaskOutcomeLocation(               // Grand Indonesia East Mall
     LocationInfo.newBuilder().setPoint(
       LatLng.newBuilder().setLatitude(-6.195139).setLongitude(106.820826)))
   .build();

 // Task request
 UpdateTaskRequest updateTaskRequest =
   UpdateTaskRequest.newBuilder()  // No need for the header
       .setTask(task)
       .setUpdateMask(FieldMask.newBuilder().addPaths("task_outcome", "task_outcome_time", "task_outcome_location"))
       .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

PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks/<id>?updateMask=taskOutcome,taskOutcomeTime,taskOutcomeLocation

  • <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 Task öğesi içermelidir.
 # 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=taskOutcome,taskOutcomeTime,taskOutcomeLocation" \
   -H "Content-type: application/json" \
   -H "Authorization: Bearer ${JWT}" \
   --data-binary @- << EOM
 {
   "taskOutcome": "SUCCEEDED",
   "taskOutcomeTime": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")",
   "taskOutcomeLocation": {
     "point": {
       "latitude": -6.195139,
       "longitude": 106.820826
     }
   }
 }
 EOM

Sırada ne var?