- संसाधन: टास्क
- स्ट्रीम किस तरह की है
- TaskOutcomeLocationSource
- JourneySharingInfo
- TaskTrackingViewConfig
- VisibilityOption
- तरीके
संसाधन: टास्क
डिलीवरी एपीआई में मौजूद टास्क, ट्रैक करने के लिए एक कार्रवाई को दिखाता है. आम तौर पर, शिपमेंट से जुड़े टास्क और ब्रेक टास्क में अंतर होता है. किसी शिपमेंट से जुड़े कई टास्क हो सकते हैं. उदाहरण के लिए, पिकअप के लिए एक टास्क और डिलीवरी या ट्रांसफ़र के लिए एक टास्क हो सकता है. साथ ही, किसी शिपमेंट के लिए अलग-अलग टास्क, अलग-अलग वाहनों से मैनेज किए जा सकते हैं. उदाहरण के लिए, एक वाहन शिपमेंट को पिकअप करके हब तक ले जा सकता है, जबकि दूसरा वाहन उसी शिपमेंट को हब से डिलीवरी की जगह तक ले जा सकता है.
ध्यान दें: gRPC और REST API, फ़ील्ड के नाम रखने के अलग-अलग तरीकों का इस्तेमाल करते हैं. उदाहरण के लिए, gRPC API में Task.journey_sharing_info
फ़ील्ड और REST API में Task.journeySharingInfo
फ़ील्ड, एक ही फ़ील्ड को रेफ़र करते हैं.
JSON के काेड में दिखाना |
---|
{ "name": string, "type": enum ( |
फ़ील्ड | |
---|---|
name |
यह |
type |
ज़रूरी है. इनमें बदलाव नहीं किया जा सकता. टास्क का टाइप तय करता है. उदाहरण के लिए, ब्रेक या शिपमेंट. |
state |
ज़रूरी है. टास्क को लागू करने की मौजूदा स्थिति. |
task |
टास्क का नतीजा. |
task |
टाइमस्टैंप, जो बताता है कि सेवा देने वाली कंपनी ने आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होता है और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाते हैं. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
task |
वह जगह जहां |
task |
इससे पता चलता है कि |
tracking |
इनमें बदलाव नहीं किया जा सकता. इस फ़ील्ड की मदद से, आईडी को सेव किया जा सकता है, ताकि आपको जटिल मैपिंग का इस्तेमाल न करना पड़े.
|
delivery |
सिर्फ़ आउटपुट के लिए. इस टास्क को पूरा करने वाले वाहन का आईडी. डिलीवरी वाहन के आईडी पर ये पाबंदियां लागू होती हैं:
|
planned |
इनमें बदलाव नहीं किया जा सकता. वह जगह जहां टास्क पूरा किया जाएगा. |
task |
ज़रूरी है. इनमें बदलाव नहीं किया जा सकता. इस जगह पर टास्क पूरा करने में लगने वाला समय. सेकंड में कुल अवधि, जिसमें दशमलव के बाद नौ अंक हो सकते हैं. यह अवधि ' |
target |
वह समयसीमा जिसके दौरान टास्क पूरा किया जाना चाहिए. |
journey |
सिर्फ़ आउटपुट के लिए. यात्रा की जानकारी शेयर करने से जुड़े फ़ील्ड. स्टेटस |
task |
टास्क ट्रैकिंग के लिए कॉन्फ़िगरेशन, जो यह तय करता है कि किन परिस्थितियों में असली उपयोगकर्ताओं को कौनसे डेटा एलिमेंट दिखेंगे. |
attributes[] |
टास्क के कस्टम एट्रिब्यूट की सूची. हर एट्रिब्यूट की एक यूनीक कुंजी होनी चाहिए. |
टाइप
टास्क का टाइप.
Enums | |
---|---|
TYPE_UNSPECIFIED |
डिफ़ॉल्ट रूप से, टास्क टाइप की जानकारी नहीं होती. |
PICKUP |
पिकअप टास्क, किसी खरीदार से शिपमेंट लेने के लिए की गई कार्रवाई है. डिपो या फ़ीडिंग वाहन के पिकअप के लिए, SCHEDULED_STOP टाइप का इस्तेमाल किया जाना चाहिए. |
DELIVERY |
डिलीवरी टास्क, किसी शिपमेंट को असली ग्राहक तक पहुंचाने के लिए की गई कार्रवाई है. डिपो या फ़ीडर वाहन के ड्रॉपऑफ़ के लिए, SCHEDULED_STOP टाइप का इस्तेमाल किया जाना चाहिए. |
SCHEDULED_STOP |
शेड्यूल किए गए स्टॉप टास्क का इस्तेमाल, प्लानिंग के लिए किया जाता है. उदाहरण के लिए, इससे फ़ीडिंग वाहनों या डिपो से शिपमेंट लेने या छोड़ने की जानकारी मिल सकती है. इसका इस्तेमाल उन शिपमेंट के लिए नहीं किया जाना चाहिए जिन्हें असली ग्राहक से पिक अप या डिलीवर किया जाता है. |
UNAVAILABLE |
ऐसा टास्क जिसका मतलब है कि वाहन, सेवा के लिए उपलब्ध नहीं है. उदाहरण के लिए, ऐसा तब हो सकता है, जब ड्राइवर ब्रेक लेता है या गाड़ी में ईंधन भरा जा रहा हो. |
TaskOutcomeLocationSource
taskOutcomeLocation
को पॉप्युलेट करने वाले सोर्स की पहचान.
Enums | |
---|---|
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED |
टास्क सेट होने से पहले उसका आउटपुट. |
PROVIDER |
सेवा देने वाली कंपनी ने taskOutcomeLocation की जानकारी दी है. |
LAST_VEHICLE_LOCATION |
सेवा देने वाली कंपनी ने taskOutcomeLocation की जानकारी नहीं दी है. इसलिए, Fleet Engine ने वाहन की पिछली लोकेशन का इस्तेमाल किया है. |
JourneySharingInfo
खास फ़ील्ड शेयर करने वाली प्रोसेस.
JSON के काेड में दिखाना |
---|
{ "remainingVehicleJourneySegments": [ { object ( |
फ़ील्ड | |
---|---|
remaining |
इस टास्क को पूरा करने से पहले, असाइन किए गए वाहन के रुकने की जगहों की जानकारी ट्रैक करना. ध्यान दें कि इस सूची में, अन्य टास्क के स्टॉप भी शामिल हो सकते हैं. पहले सेगमेंट, |
last |
यह असाइन किए गए वाहन की आखिरी जगह की जानकारी दिखाता है. |
last |
यह बताता है कि वाहन की lastLocation को |
TaskTrackingViewConfig
कॉन्फ़िगरेशन मैसेज, जो यह तय करता है कि टास्क का डेटा एलिमेंट, असली उपयोगकर्ताओं को कब दिखना चाहिए.
JSON के काेड में दिखाना |
---|
{ "routePolylinePointsVisibility": { object ( |
फ़ील्ड | |
---|---|
route |
यह फ़ील्ड बताता है कि रास्ते के पॉलीलाइन पॉइंट कब दिख सकते हैं. अगर इस फ़ील्ड की वैल्यू नहीं दी गई है, तो इस डेटा के लिए, प्रोजेक्ट लेवल पर डिफ़ॉल्ट रूप से दिखने की सेटिंग का इस्तेमाल किया जाएगा. |
estimated |
यह फ़ील्ड बताता है कि पहुंचने का अनुमानित समय कब दिख सकता है. अगर इस फ़ील्ड की वैल्यू नहीं दी गई है, तो इस डेटा के लिए, प्रोजेक्ट लेवल पर डिफ़ॉल्ट रूप से दिखने की सेटिंग का इस्तेमाल किया जाएगा. |
estimated |
यह फ़ील्ड बताता है कि टास्क पूरा होने का अनुमानित समय कब दिख सकता है. अगर इस फ़ील्ड की वैल्यू नहीं दी गई है, तो इस डेटा के लिए, प्रोजेक्ट लेवल पर डिफ़ॉल्ट रूप से दिखने की सेटिंग का इस्तेमाल किया जाएगा. |
remaining |
यह फ़ील्ड बताता है कि ड्राइविंग की बाकी दूरी कब दिख सकती है. अगर इस फ़ील्ड की वैल्यू नहीं दी गई है, तो इस डेटा के लिए, प्रोजेक्ट लेवल पर डिफ़ॉल्ट रूप से दिखने की सेटिंग का इस्तेमाल किया जाएगा. |
remaining |
यह फ़ील्ड बताता है कि बाकी बचे स्टॉप की संख्या कब दिख सकती है. अगर इस फ़ील्ड की वैल्यू नहीं दी गई है, तो इस डेटा के लिए, प्रोजेक्ट लेवल पर डिफ़ॉल्ट रूप से दिखने की सेटिंग का इस्तेमाल किया जाएगा. |
vehicle |
यह फ़ील्ड बताता है कि वाहन की जगह की जानकारी कब दिख सकती है. अगर इस फ़ील्ड की वैल्यू नहीं दी गई है, तो इस डेटा के लिए, प्रोजेक्ट लेवल पर डिफ़ॉल्ट रूप से दिखने की सेटिंग का इस्तेमाल किया जाएगा. |
VisibilityOption
विकल्प मैसेज, जो यह तय करता है कि असली उपयोगकर्ताओं को डेटा एलिमेंट कब दिखना चाहिए.
JSON के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड visibility_option . 'किसको दिखे' सेटिंग के लिए चुना गया विकल्प. visibility_option इनमें से कोई एक हो सकता है: |
|
remaining |
यह डेटा एलिमेंट, असली उपयोगकर्ताओं को तब दिखता है, जब बचे हुए स्टॉप की संख्या <= remainingStopCountThreshold हो. |
duration |
यह डेटा एलिमेंट, असली उपयोगकर्ताओं को तब दिखता है, जब बस स्टॉप पर पहुंचने का अनुमानित समय <= अनुमानित पहुंचने के समय की सीमा तक की अवधि हो. सेकंड में कुल अवधि, जिसमें दशमलव के बाद नौ अंक हो सकते हैं. यह अवधि ' |
remaining |
यह डेटा एलिमेंट, असली उपयोगकर्ताओं को तब दिखता है, जब ड्राइविंग की बाकी दूरी मीटर में <= remainingDrivingDistanceMetersThreshold हो. |
always |
अगर इसे 'सही' पर सेट किया जाता है, तो यह डेटा एलिमेंट, असली उपयोगकर्ताओं को हमेशा दिखता है. इसके लिए, थ्रेशोल्ड की ज़रूरत नहीं होती. इस फ़ील्ड को 'गलत' पर सेट नहीं किया जा सकता. |
never |
अगर इस विकल्प को 'सही है' पर सेट किया जाता है, तो यह डेटा एलिमेंट, असली उपयोगकर्ताओं से हमेशा छिपा रहता है. इसके लिए, थ्रेशोल्ड की ज़रूरत नहीं होती. इस फ़ील्ड को 'गलत' पर सेट नहीं किया जा सकता. |
तरीके |
|
---|---|
|
नए Task ऑब्जेक्ट का एक बैच बनाता है और उसे दिखाता है. |
|
नया Task ऑब्जेक्ट बनाता है और उसे दिखाता है. |
|
किसी Task के बारे में जानकारी मिलती है. |
|
फ़िल्टर करने के लिए तय की गई शर्तों को पूरा करने वाले सभी Task को दिखाता है. |
|
Task का डेटा अपडेट करता है. |