इस दस्तावेज़ में यह माना गया है कि आपने Fleet Engine के बारे में जानकारी सेक्शन में, शेड्यूल किए गए टास्क के बारे में शुरुआती गाइड पढ़ ली है. साथ ही, इस सेक्शन में शेड्यूल किया गया टास्क क्या है? के बारे में भी पढ़ लिया है.
शेड्यूल किए गए टास्क के लिए Fleet Engine, टास्क की अलग-अलग कैटगरी उपलब्ध कराता है:
- शिपमेंट से जुड़े टास्क: ड्राइविंग से जुड़े टास्क के लिए इस्तेमाल करें. इनमें शिपमेंट को पिकअप और डिलीवर करना भी शामिल है.
- ड्राइवर के उपलब्ध न होने पर किए जाने वाले टास्क: इनका इस्तेमाल उन समय के लिए करें जब ड्राइवर उपलब्ध न हों. जैसे, ब्रेक के दौरान.
- शेड्यूल किए गए स्टॉप टास्क: ड्रॉप बॉक्स या ग्राहक की जगहों पर, ड्राइविंग से जुड़े कामों के लिए इस्तेमाल करें. जैसे, किसी बिल्डिंग में जाने या डिलीवरी पॉइंट ढूंढने में लगने वाला समय.
इस दस्तावेज़ में, अपने सर्वर पर शिपमेंट से जुड़े नहीं टास्क बनाने का तरीका बताया गया है. शिपमेंट के टास्क के टाइप के बारे में जानने के लिए, शिपमेंट के टास्क बनाना लेख पढ़ें.
ड्राइविंग से जुड़े टास्क के अलावा अन्य टास्क के लिए टास्क फ़ील्ड
इस सेक्शन में, टास्क के उन फ़ील्ड के बारे में बताया गया है जो उपलब्ध न होने और शेड्यूल किए गए टास्क, दोनों के लिए ज़रूरी हैं.
टास्क के लिए ज़रूरी फ़ील्ड
Fleet Engine में बनाए जाने वाले हर टास्क के लिए, आपको ज़रूरी फ़ील्ड की जानकारी देनी होगी. साथ ही, आपके पास वैकल्पिक फ़ील्ड की जानकारी देने का विकल्प भी होता है. Fleet Engine, बाकी सभी फ़ील्ड को अनदेखा करता है. साथ ही, अगर टास्क बनाने के अनुरोध में असाइन किया गया deliveryVehicleId
दिया जाता है, तो वह एक अपवाद दिखाता है. किसी वाहन को टास्क असाइन करने के लिए,
UpdateDeliveryVehicleRequest
का इस्तेमाल करें. ज़्यादा जानकारी के लिए, टास्क अपडेट करना लेख पढ़ें.
फ़ील्ड | मान |
---|---|
type |
टास्क टाइप से मैच करने वाले टाइप पर सेट करें. टास्क टाइप इनमें से कोई एक हो सकता है:
|
state |
State.OPEN |
task_id |
टास्क का यूनीक आईडी. यह शिपमेंट का ट्रैकिंग नंबर नहीं होना चाहिए. अगर आपके सिस्टम में टास्क आईडी नहीं हैं, तो यूनिवर्सल यूनीक आइडेंटिफ़ायर (यूयूआईडी) जनरेट किया जा सकता है. ज़्यादा जानकारी के लिए, टास्क आईडी देखें. |
tracking_id |
PICKUP या सिर्फ़ DELIVERY टास्क:
वह नंबर या आइडेंटिफ़ायर जिसका इस्तेमाल शिपमेंट को ट्रैक करने के लिए किया जा रहा है. शिपमेंट से जुड़े टास्क के लिए,
यह फ़ील्ड न भरें. |
plannedLocation |
सिर्फ़ PICKUP , DELIVERY या
SCHEDULED_STOP टास्क: वह जगह जहां टास्क पूरा करना है. UNAVAILABLE टास्क के लिए ज़रूरी नहीं है. |
taskDuration |
टास्क पूरा करने में लगने वाला अनुमानित समय. उदाहरण के लिए, पार्किंग की जगह ढूंढने या डिलीवरी की जगह तक पैदल जाने के लिए. |
शिपमेंट टास्क के लिए वैकल्पिक फ़ील्ड
फ़ील्ड | मान |
---|---|
targetTimeWindow |
वह समयसीमा जिसके दौरान टास्क पूरा किया जाना चाहिए. इस फ़ील्ड से, रूटिंग के तरीके पर कोई असर नहीं पड़ता. |
task_tracking_view_config |
PICKUP या DELIVERY सिर्फ़ टास्क:
यह टास्क ट्रैकिंग के लिए कॉन्फ़िगरेशन है. इससे यह तय होता है कि किन परिस्थितियों में असली उपयोगकर्ताओं को कौनसे डेटा एलिमेंट दिखेंगे. |
attributes |
कस्टम टास्क एट्रिब्यूट की सूची. हर एट्रिब्यूट की एक यूनीक कुंजी होनी चाहिए. |
'ऑनलाइन नहीं हैं' टास्क बनाना
आपके पास उपलब्ध न होने की जानकारी देने वाला टास्क बनाने का विकल्प है. उदाहरण के लिए, ड्राइवर के ब्रेक के लिए. उपलब्ध न होने का टास्क बनाने के लिए, इन दिशा-निर्देशों का पालन करें:
- टास्क का टाइप
UNAVAILABLE
पर सेट करें. - ट्रैकिंग आईडी शामिल न करें.
- हालांकि, आपको उपलब्ध न होने के दौरान किए जाने वाले टास्क के लिए जगह की जानकारी देने की ज़रूरत नहीं है, लेकिन ऐसा करने से पूरे दिन के लिए ईटीए का बेहतर हिसाब लगाया जा सकता है.
जब वाहन की जगह की जानकारी, UNAVAILABLE
के साथ यात्रा की जानकारी शेयर करने के लिए शेयर की जाती है, तो उस पर जगह की जानकारी दिखाने के खास नियम लागू होते हैं.
- शिपमेंट ट्रैकिंग लाइब्रेरी के साथ इंटिग्रेट किए गए उपभोक्ता ऐप्लिकेशन: जब वाहन उपलब्ध नहीं है, तब उपभोक्ता ऐप्लिकेशन के उपयोगकर्ताओं को वाहन की जगह की जानकारी नहीं दिखती. हालांकि, वे अब भी अपने शिपमेंट की स्थिति की जानकारी देख सकते हैं.
- फ़्लीट ट्रैकिंग लाइब्रेरी के साथ इंटिग्रेट किए गए फ़्लीट ट्रैकिंग ऐप्लिकेशन: जब वाहन, उपलब्ध न होने की स्थिति में किसी टास्क पर होगा, तो फ़्लीट ट्रैकिंग ऐप्लिकेशन का इस्तेमाल करने वाले फ़्लीट मैनेजर, उपलब्ध न होने की स्थिति में किसी टास्क के लिए वाहन की जगह की जानकारी देख पाएंगे.
नीचे दिए गए उदाहरणों में, Java gRPC लाइब्रेरी का इस्तेमाल करके, शेड्यूल किया गया 'उपलब्ध नहीं है' टास्क बनाने का तरीका बताया गया है. इसके अलावा, CreateTask
को एचटीटीपी REST अनुरोध करने का तरीका भी बताया गया है.
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.UNAVAILABLE)
.setState(Task.State.OPEN)
.setTaskDuration(
Duration.newBuilder().setSeconds(60 * 60)) // 1hr break
.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
पर एचटीटीपी REST कॉल करें:
POST https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks?taskId=<id>
<id>, टास्क का यूनीक आइडेंटिफ़ायर है.
अनुरोध हेडर में अनुमति फ़ील्ड होना चाहिए, जिसकी वैल्यू Bearer <token> हो. <token> को आपका सर्वर, सेवा खाते की भूमिकाओं और JSON वेब टोकन में बताए गए दिशा-निर्देशों के मुताबिक जारी करता है.
अनुरोध के मुख्य हिस्से में, ड्राइविंग से जुड़े टास्क के लिए टास्क फ़ील्ड में बताए गए सही फ़ील्ड के साथ Task
इकाई होनी चाहिए.
curl
निर्देश का उदाहरण:
# Set $JWT, $PROJECT_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": "UNAVAILABLE",
"state": "OPEN",
"plannedLocation": {
"point": {
"latitude": -6.195139,
"longitude": 106.820826
}
},
"taskDuration": "300s"
}
EOM
शेड्यूल किया गया 'रोकें' टास्क बनाना
शेड्यूल किए गए स्टॉप के लिए टास्क बनाया जा सकता है. उदाहरण के लिए, ग्राहक की जगहों पर ड्राइविंग से जुड़े टास्क के लिए, ईंधन भरने के लिए स्टॉप के लिए या जब ड्राइवर को फ़ीडर वाहन से शिपमेंट मिलता है, तब के लिए. शेड्यूल किया गया टास्क बनाते समय, इन दिशा-निर्देशों का पालन करें:
- टास्क का टाइप
- ट्रैकिंग आईडी शामिल न करें.
- आपके पास जगह की जानकारी देने का विकल्प है.
नीचे दिए गए उदाहरणों में, Java gRPC लाइब्रेरी का इस्तेमाल करके, शेड्यूल किया गया 'उपलब्ध नहीं है' टास्क बनाने का तरीका बताया गया है. इसके अलावा, CreateTask
को एचटीटीपी REST अनुरोध करने का तरीका भी बताया गया है.
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.SCHEDULED_STOP)
.setState(Task.State.OPEN)
.setPlannedLocation( // Grand Indonesia East Mall
LocationInfo.newBuilder().setPoint(
LatLng.newBuilder().setLatitude(-6.195139).setLongitude(106.820826)))
.setTaskDuration(
Duration.newBuilder().setSeconds(2 * 60))
.build();
// Task request
CreateTaskRequest createTaskRequest =
CreateTaskRequest.newBuilder() // No need for the header
.setParent(parent)
.setTaskId("task-8241890") // Task ID assigned by the Provider
.setTrip(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
पर एचटीटीपी REST कॉल करें:
POST https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks?taskId=<id>
<id>, टास्क का यूनीक आइडेंटिफ़ायर है.
अनुरोध हेडर में अनुमति फ़ील्ड होना चाहिए, जिसकी वैल्यू Bearer <token> हो. <token> को आपका सर्वर, सेवा खाते की भूमिकाओं और JSON वेब टोकन में बताए गए दिशा-निर्देशों के मुताबिक जारी करता है.
अनुरोध के मुख्य हिस्से में Task
इकाई शामिल होनी चाहिए:
curl
निर्देश का उदाहरण:
# Set $JWT, $PROJECT_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": "SCHEDULED_STOP",
"state": "OPEN",
"plannedLocation": {
"point": {
"latitude": -6.195139,
"longitude": 106.820826
}
},
"taskDuration": "600s"
}
EOM