- संसाधन: टास्क
- स्ट्रीम किस तरह की है
- TaskOutcomeLocationSource
- JourneySharingInfo
- TaskTrackingViewConfig
- VisibilityOption
- तरीके
संसाधन: टास्क
Delivery API में मौजूद टास्क से, सिर्फ़ एक कार्रवाई को ट्रैक किया जाता है. आम तौर पर, शिपमेंट से जुड़े Tasks और ब्रेक Tasks में अंतर होता है. किसी शिपमेंट में उससे जुड़े एक से ज़्यादा Tasks हो सकते हैं. उदाहरण के लिए, हो सकता है कि पिकअप के लिए एक टास्क और ड्रॉप-ऑफ़ या ट्रांसफ़र के लिए एक टास्क हो. साथ ही, किसी शिपमेंट को अलग-अलग गाड़ियों से मैनेज किया जा सकता है. उदाहरण के लिए, एक वाहन पिकअप को हैंडल कर सकता है और शिपमेंट को हब तक ले जा सकता है. वहीं, दूसरा वाहन उसी शिपमेंट को हब से वहां ले जाता है जहां से उसे ड्रॉप-ऑफ़ किया जाता है.
ध्यान दें: gRPC और REST API, फ़ील्ड का नाम रखने के अलग-अलग तरीकों का इस्तेमाल करते हैं. उदाहरण के लिए, gRPC एपीआई में Task.journey_sharing_info
फ़ील्ड और REST API में Task.journeySharingInfo
फ़ील्ड, एक ही फ़ील्ड को रेफ़र करते हैं.
जेएसओएन के काेड में दिखाना |
---|
{ "name": string, "type": enum ( |
फ़ील्ड | |
---|---|
name |
|
type |
ज़रूरी है. इम्यूटेबल. यह बताता है कि टास्क किस तरह का है. उदाहरण के लिए, ब्रेक या शिपमेंट. |
state |
ज़रूरी है. टास्क के चलने की मौजूदा स्थिति. |
taskOutcome |
टास्क का नतीजा. |
taskOutcomeTime |
वह टाइमस्टैंप जिससे पता चलता है कि सेवा देने वाली कंपनी ने RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड का रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक हो सकते हैं. उदाहरण: |
taskOutcomeLocation |
वह जगह जहां |
taskOutcomeLocationSource |
यह बताता है कि |
trackingId |
इम्यूटेबल. यह फ़ील्ड, आईडी को सेव करने में मदद करता है, ताकि आप मुश्किल मैपिंग का इस्तेमाल करने से बच सकें.
|
deliveryVehicleId |
सिर्फ़ आउटपुट के लिए. उस वाहन का आईडी जिससे टास्क को पूरा किया जा रहा है. डिलीवरी वाले वाहन के आईडी पर ये पाबंदियां लागू होती हैं:
|
plannedLocation |
इम्यूटेबल. वह जगह जहां टास्क पूरा किया जाएगा. |
taskDuration |
ज़रूरी है. इम्यूटेबल. इस जगह पर कोई टास्क चलाने में लगने वाला समय. सेकंड में दी गई अवधि, जिसमें नौ भिन्नांक हो सकते हैं. साथ ही, यह ' |
targetTimeWindow |
वह समय विंडो जिसके दौरान टास्क पूरा होना चाहिए. |
journeySharingInfo |
सिर्फ़ आउटपुट के लिए. गतिविधि की जानकारी शेयर करने से जुड़े खास फ़ील्ड. स्थिति |
taskTrackingViewConfig |
टास्क ट्रैकिंग का कॉन्फ़िगरेशन यह बताता है कि असली उपयोगकर्ताओं को कौनसे डेटा एलिमेंट किन स्थितियों में दिखते हैं. |
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
खास फ़ील्ड शेयर करने का सफ़र.
जेएसओएन के काेड में दिखाना |
---|
{ "remainingVehicleJourneySegments": [ { object ( |
फ़ील्ड | |
---|---|
remainingVehicleJourneySegments[] |
उन स्टॉप की जानकारी ट्रैक करना जिन्हें असाइन किया गया वाहन, टास्क पूरा करने से पहले बनाएगा. ध्यान दें कि इस सूची में, दूसरे टास्क के स्टॉप शामिल हो सकते हैं. पहले सेगमेंट, |
lastLocation |
इससे, यह पता चलता है कि असाइन किया गया वाहन पिछली बार किस जगह पर मौजूद था. |
lastLocationSnappable |
यह बताता है कि वाहन की आखिरी जगह को |
TaskTrackingViewConfig
कॉन्फ़िगरेशन मैसेज से पता चलता है कि टास्क का डेटा एलिमेंट, असली उपयोगकर्ताओं को कब दिखना चाहिए.
जेएसओएन के काेड में दिखाना |
---|
{ "routePolylinePointsVisibility": { object ( |
फ़ील्ड | |
---|---|
routePolylinePointsVisibility |
वह फ़ील्ड जिससे पता चलता है कि रास्ते के पॉलीलाइन पॉइंट कब दिख सकते हैं. अगर इस फ़ील्ड के बारे में जानकारी नहीं दी गई है, तो इस डेटा के लिए, प्रोजेक्ट लेवल पर 'किसको दिखे' का डिफ़ॉल्ट कॉन्फ़िगरेशन इस्तेमाल किया जाएगा. |
estimatedArrivalTimeVisibility |
वह फ़ील्ड जो बताता है कि पहुंचने का अनुमानित समय कब दिख सकता है. अगर इस फ़ील्ड के बारे में जानकारी नहीं दी गई है, तो इस डेटा के लिए, प्रोजेक्ट लेवल पर 'किसको दिखे' का डिफ़ॉल्ट कॉन्फ़िगरेशन इस्तेमाल किया जाएगा. |
estimatedTaskCompletionTimeVisibility |
वह फ़ील्ड जिससे पता चलता है कि टास्क पूरा होने में लगने वाला अनुमानित समय कब दिखेगा. अगर इस फ़ील्ड के बारे में जानकारी नहीं दी गई है, तो इस डेटा के लिए, प्रोजेक्ट लेवल पर 'किसको दिखे' का डिफ़ॉल्ट कॉन्फ़िगरेशन इस्तेमाल किया जाएगा. |
remainingDrivingDistanceVisibility |
वह फ़ील्ड जो बताता है कि ड्राइविंग से जुड़ी बाकी दूरी कब तक देखी जा सकती है. अगर इस फ़ील्ड के बारे में जानकारी नहीं दी गई है, तो इस डेटा के लिए, प्रोजेक्ट लेवल पर 'किसको दिखे' का डिफ़ॉल्ट कॉन्फ़िगरेशन इस्तेमाल किया जाएगा. |
remainingStopCountVisibility |
वह फ़ील्ड जिसके बारे में जानकारी दी जाती है कि स्टॉप की गिनती कब दिखेगी. अगर इस फ़ील्ड के बारे में जानकारी नहीं दी गई है, तो इस डेटा के लिए, प्रोजेक्ट लेवल पर 'किसको दिखे' का डिफ़ॉल्ट कॉन्फ़िगरेशन इस्तेमाल किया जाएगा. |
vehicleLocationVisibility |
वह फ़ील्ड जिससे पता चलता है कि वाहन की जगह की जानकारी कब दिख सकती है. अगर इस फ़ील्ड के बारे में जानकारी नहीं दी गई है, तो इस डेटा के लिए, प्रोजेक्ट लेवल पर 'किसको दिखे' का डिफ़ॉल्ट कॉन्फ़िगरेशन इस्तेमाल किया जाएगा. |
VisibilityOption
विकल्प मैसेज से तय होता है कि डेटा एलिमेंट, असली उपयोगकर्ताओं को कब दिखना चाहिए.
जेएसओएन के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड visibility_option . चुना गया 'किसको दिखे' विकल्प. visibility_option इनमें से सिर्फ़ एक हो सकती है: |
|
remainingStopCountThreshold |
यह डेटा एलिमेंट असली उपयोगकर्ताओं को तब ही दिखता है, जब बाकी बचे स्टॉप की संख्या <= ढूंढी गई स्टॉप काउंट थ्रेशोल्ड (कम) से ज़्यादा हो. |
durationUntilEstimatedArrivalTimeThreshold |
यह डेटा एलिमेंट, असली उपयोगकर्ताओं को तब दिखता है, जब ETA, स्टॉप <= durationExpirationTimeThreshold को पूरा नहीं होने पर दिखता है. सेकंड में दी गई अवधि, जिसमें नौ भिन्नांक हो सकते हैं. साथ ही, यह ' |
remainingDrivingDistanceMetersThreshold |
असली उपयोगकर्ताओं को यह डेटा एलिमेंट तब दिखेगा, जब ड्राइविंग दूरी मीटर से कम हो <= बची हुई ड्राइविंग की दूरी मीटर से कम हो. |
always |
अगर 'सही है' पर सेट किया जाता है, तो यह डेटा एलिमेंट असली उपयोगकर्ताओं को हमेशा बिना किसी थ्रेशोल्ड के दिखता है. इस फ़ील्ड को 'गलत' पर सेट नहीं किया जा सकता. |
never |
अगर इसे 'सही है' पर सेट किया जाता है, तो यह डेटा एलिमेंट असली उपयोगकर्ताओं के लिए हमेशा छिपा रहता है. साथ ही, इसमें कोई थ्रेशोल्ड नहीं होता. इस फ़ील्ड को 'गलत' पर सेट नहीं किया जा सकता. |
तरीके |
|
---|---|
|
नए Task ऑब्जेक्ट का बैच बनाता है और उसे दिखाता है. |
|
नया Task ऑब्जेक्ट बनाता है और उसे दिखाता है. |
|
Task के बारे में जानकारी मिलती है. |
|
फ़िल्टर करने की तय की गई शर्तों को पूरा करने वाले सभी Task पाएं. |
|
Task का डेटा अपडेट होता है. |