शिपमेंट टास्क बनाना

इस दस्तावेज़ को माना जाता है कि आपने शुरुआती गाइड पढ़ ली है फ़्लीट इंजन के बारे में जानकारी सेक्शन में, शेड्यूल किए गए टास्क भी इस सेक्शन में, शेड्यूल किया गया टास्क क्या है? पर क्लिक करें.

शेड्यूल किए गए टास्क के लिए Fleet Engine, टास्क की अलग-अलग कैटगरी उपलब्ध कराता है:

  • शिपमेंट टास्क: इसका इस्तेमाल ड्राइविंग से जुड़े टास्क के लिए किया जाता है. जैसे, पिकअप और डिलीवरी शिपमेंट.
  • उपलब्ध न होने से जुड़े टास्क: जब ड्राइवर उपलब्ध न हों, तब इस टास्क का इस्तेमाल करें. जैसे तय समय के बाद विज्ञापन दिखाएं.
  • शेड्यूल किए गए स्टॉप टास्क: ड्रॉप बॉक्स या ग्राहक पर नॉन-ड्राइविंग टास्क के लिए इस्तेमाल करें जगहें, जैसे किसी इमारत के अंदर जाने या डिलीवरी की जगह का पता लगाने का समय.

इस दस्तावेज़ में अपने सर्वर पर शिपमेंट टास्क बनाने का तरीका बताया गया है. दूसरे टाइप के टास्क बनाने के लिए, दूसरे टाइप के टास्क बनाना लेख पढ़ें.

शिपमेंट टास्क फ़ील्ड

इस सेक्शन में, पिक अप और डिलीवरी, दोनों के लिए ज़रूरी टास्क फ़ील्ड मौजूद हैं टास्क.

ज़रूरी टास्क फ़ील्ड

Fleet Engine में बनाए जाने वाले हर टास्क के लिए, आपको इसे ज़रूरी जानकारी उपलब्ध करानी होगी फ़ील्ड भी शामिल कर सकते हैं और इनमें से कोई भी वैकल्पिक फ़ील्ड दे सकते हैं. फ़्लीट इंजन अन्य सभी फ़ील्ड को अनदेखा कर देता है और अगर टास्क बनाया जाता है, तो अपवाद दिखता है अनुरोध, असाइन किया गया deliveryVehicleId उपलब्ध कराता है. किसी वाहन को टास्क असाइन करने के लिए, UpdateDeliveryVehicleRequest का इस्तेमाल करें. ज़्यादा जानकारी के लिए, यह देखें टास्क अपडेट करें.

फ़ील्डमान
type

टास्क टाइप से मैच होने वाले टाइप पर सेट करें, जो इनमें से एक है:

  • PICKUP
  • DELIVERY
  • SCHEDULED_STOP
  • UNAVAILABLE
state State.OPEN
task_id यूनीक टास्क आईडी. यह शिपमेंट का ट्रैकिंग नंबर नहीं होना चाहिए. अगर आपको के पास आपके सिस्टम में टास्क आईडी नहीं हैं, तो आप हर उपयोगकर्ता के लिए आइडेंटिफ़ायर (यूयूआईडी). खास जानकारी के लिए, यह देखें टास्क आईडी.
tracking_id सिर्फ़ PICKUP या DELIVERY टास्क: वह संख्या या आइडेंटिफ़ायर जिसका इस्तेमाल किसी शिपमेंट को ट्रैक करने के लिए किया जा रहा है. शिपमेंट से जुड़े टास्क के लिए, यह फ़ील्ड न भरें.
plannedLocation PICKUP, DELIVERY या सिर्फ़ SCHEDULED_STOP टास्क: वह जगह जहां टास्क पूरा करना है. इसके लिए ज़रूरी नहीं है UNAVAILABLE टास्क.
taskDuration टास्क को पूरा करने में लगने वाला अनुमानित समय. उदाहरण के लिए, अगर पार्किंग के लिए या हैंडऑफ़ वाली जगह तक चलकर जाएं.

शिपमेंट के लिए वैकल्पिक टास्क फ़ील्ड

फ़ील्डमान
targetTimeWindow टास्क को पूरा करने के लिए तय की गई समयावधि. यह फ़ील्ड रूटिंग के व्यवहार पर कोई असर नहीं पड़ता.
task_tracking_view_config सिर्फ़ PICKUP या DELIVERY टास्क: टास्क ट्रैकिंग का कॉन्फ़िगरेशन, जो तय करता है कि कौनसे डेटा एलिमेंट असली उपयोगकर्ताओं को किन परिस्थितियों में देखा जा सकता है.
attributes कस्टम टास्क एट्रिब्यूट की सूची. हर एट्रिब्यूट की एक खास कुंजी होनी चाहिए.

शिपमेंट को पिक अप करने का टास्क बनाना

यह देखने के लिए कि ड्राइवर किसी शिपमेंट को पिक अप करता है, फ़्लीट इंजन का इस्तेमाल करने के लिए, शिपमेंट पिक अप के लिए टास्क बनाते हैं. इसमें, टास्क टाइप एट्रिब्यूट को PICKUP. नीचे दिए गए उदाहरण में, इंडोनेशिया ईस्ट मॉल.

नीचे दिए गए उदाहरणों में, Java gRPC लाइब्रेरी या एचटीटीपी REST अनुरोध करने का तरीका CreateTask.

gRPC

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

  DeliveryServiceBlockingStub deliveryService =
    DeliveryServiceGrpc.newBlockingStub(channel);

  // Task settings
  String parent = "providers/" + PROJECT_ID;
  Task task = Task.newBuilder()
    .setType(Task.Type.PICKUP)
    .setState(Task.State.OPEN)
    .setTrackingId("my-tracking-id")
    .setPlannedLocation(               // Grand Indonesia East Mall
      LocationInfo.newBuilder().setPoint(
        LatLng.newBuilder().setLatitude(-6.195139).setLongitude(106.820826)))
    .setTaskDuration(
      Duration.newBuilder().setSeconds(2 * 60))
    .setTargetTimeWindow(
      TimeWindow.newBuilder()
        .setStartTime(Timestamp.newBuilder().setSeconds(1680123600))
        .setEndTime(Timestamp.newBuilder().setSeconds(1680130800)))
    .addAttributes(TaskAttribute.newBuilder().setKey("foo").setStringValue("value"))
    .addAttributes(TaskAttribute.newBuilder().setKey("bar").setNumberValue(10))
    .addAttributes(TaskAttribute.newBuilder().setKey("baz").setBoolValue(false))
    .build();

  // Task request
  CreateTaskRequest createTaskRequest =
    CreateTaskRequest.newBuilder()  // No need for the header
        .setParent(parent)          // Avoid using auto-incrementing IDs for the taskId
        .setTaskId("task-8241890")  // Task ID assigned by the Provider
        .setTask(task)              // Initial state
        .build();

  // Error handling
  // If Fleet Engine does not have a task with that ID and the credentials of the
  // requestor pass, the service creates the task successfully.

  try {
    Task createdTask = deliveryService.createTask(createTaskRequest);
  } catch (StatusRuntimeException e) {
    Status s = e.getStatus();
    switch (s.getCode()) {
       case ALREADY_EXISTS:
         break;
       case PERMISSION_DENIED:
         break;
    }
    return;
  }

आराम

किसी सर्वर एनवायरमेंट से शिपमेंट पिक अप करने का टास्क बनाने के लिए, एक एचटीटीपी REST बनाएं CreateTask को किया गया कॉल:

POST https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks?taskId=<id>

<id>, टास्क का यूनीक आइडेंटिफ़ायर है.

अनुरोध के हेडर में वैल्यू के साथ Authorization फ़ील्ड होना ज़रूरी है Bearer <token>, जहां <token> को सर्वर के ज़रिए जारी किया जाता है: सेवा खाते की भूमिकाओं और JSON वेब टोकन के बारे में ज़्यादा जानें.

अनुरोध के मुख्य हिस्से में, सही फ़ील्ड के साथ Task इकाई होनी चाहिए शिपमेंट टास्क फ़ील्ड में बताया गया है.

curl कमांड का उदाहरण:

 # Set $JWT, $PROJECT_ID, $TRACKING_ID, and $TASK_ID in the local
 # environment
 curl -X POST "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks?taskId=${TASK_ID}" \
   -H "Content-type: application/json" \
   -H "Authorization: Bearer ${JWT}" \
   --data-binary @- << EOM
 {
   "type": "PICKUP",
   "state": "OPEN",
   "trackingId": "${TRACKING_ID}",
   "plannedLocation": {
      "point": {
         "latitude": -6.195139,
         "longitude": 106.820826
      }
   },
   "taskDuration": "90s",
   "targetTimeWindow": {
     "startTime": "2023-03-29T21:00:00Z",
     "endTime": "2023-03-29T23:00:00Z"
   }
 }
 EOM

शिपमेंट की डिलीवरी का टास्क बनाना

शिपमेंट डिलीवर करने वाले ड्राइवर की गतिविधि पर नज़र रखने के लिए फ़्लीट इंजन का इस्तेमाल करने के लिए, शिपिंग डिलीवरी टास्क बनाना. इसमें टास्क टाइप एट्रिब्यूट को सेट करना शामिल है DELIVERY तक. इस उदाहरण में, Grand Indonesia East Mall में शिपमेंट की डिलीवरी दिखाई गई है.

नीचे दिए गए उदाहरणों में, Java gRPC लाइब्रेरी या एचटीटीपी REST अनुरोध करने का तरीका CreateTask.

gRPC

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

  DeliveryServiceBlockingStub deliveryService =
    DeliveryServiceGrpc.newBlockingStub(channel);

  // Task settings
  String parent = "providers/" + PROJECT_ID;
  Task task = Task.newBuilder()
    .setType(Task.Type.DELIVERY)
    .setState(Task.State.OPEN)
    .setTrackingId("my-tracking-id")
    .setPlannedLocation(               // Grand Indonesia East Mall
      LocationInfo.newBuilder().setPoint(
        LatLng.newBuilder().setLatitude(-6.195139).setLongitude(106.820826)))
    .setTaskDuration(
      Duration.newBuilder().setSeconds(2 * 60))
    .setTargetTimeWindow(
      TimeWindow.newBuilder()
        .setStartTime(Timestamp.newBuilder().setSeconds(1680123600))
        .setEndTime(Timestamp.newBuilder().setSeconds(1680130800)))
    .addAttributes(TaskAttribute.newBuilder().setKey("foo").setStringValue("value"))
    .addAttributes(TaskAttribute.newBuilder().setKey("bar").setNumberValue(10))
    .addAttributes(TaskAttribute.newBuilder().setKey("baz").setBoolValue(false))
    .build();

  // Task request
  CreateTaskRequest createTaskRequest =
    CreateTaskRequest.newBuilder()  // No need for the header
        .setParent(parent)          // Avoid using auto-incrementing IDs for the taskId
        .setTaskId("task-8241890")  // Task ID assigned by the Provider
        .setTask(task)              // Initial state
        .build();

  // Error handling
  // If Fleet Engine does not have task with that ID and the credentials of the
  // requestor pass, the service creates the task successfully.

  try {
    Task createdTask = deliveryService.createTask(createTaskRequest);
  } catch (StatusRuntimeException e) {
    Status s = e.getStatus();
    switch (s.getCode()) {
       case ALREADY_EXISTS:
         break;
       case PERMISSION_DENIED:
         break;
    }
    return;
  }

आराम

किसी सर्वर एनवायरमेंट से शिपमेंट पिक अप करने का टास्क बनाने के लिए, एक एचटीटीपी REST बनाएं CreateTask को किया गया कॉल:

POST https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks?taskId=<id>

&lt;id&gt;, टास्क के लिए यूनीक आइडेंटिफ़ायर है.

अनुरोध के हेडर में वैल्यू के साथ Authorization फ़ील्ड होना ज़रूरी है Bearer <token>, जहां <token> को सर्वर के ज़रिए जारी किया जाता है: सेवा खाते की भूमिकाओं और JSON वेब टोकन के बारे में ज़्यादा जानें.

अनुरोध के मुख्य हिस्से में Task इकाई होनी चाहिए:

curl कमांड का उदाहरण:

 # Set $JWT, $PROJECT_ID, $TRACKING_ID, and $TASK_ID in the local
 # environment
 curl -X POST "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks?taskId=${TASK_ID}" \
   -H "Content-type: application/json" \
   -H "Authorization: Bearer ${JWT}" \
   --data-binary @- << EOM
 {
   "type": "DELIVERY",
   "state": "OPEN",
   "trackingId": "${TRACKING_ID}",
   "plannedLocation": {
      "point": {
         "latitude": -6.195139,
         "longitude": 106.820826
      }
   },
   "taskDuration": "90s",
   "targetTimeWindow": {
     "startTime": "2023-03-29T21:00:00Z",
     "endTime": "2023-03-29T23:00:00Z"
   }
 }
 EOM
 ```

आगे क्या करना है