प्रॉडक्ट के बारे में जानकारी: वाहन बनाना

Fleet Engine में वाहनों के काम करने के तरीके के बारे में सामान्य जानकारी पाने के लिए, Fleet Engine की ज़रूरी जानकारी वाले सेक्शन में ये गाइड देखें:

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

वाहन का रिसॉर्स बनाने के लिए, gRPC या REST का इस्तेमाल करके, 'बनाएं' तरीके का इस्तेमाल किया जाता है. इस गाइड में, फ़ील्ड के नामों के लिए gRPC नोटेशन का इस्तेमाल किया गया है, ताकि इन्हें आसानी से समझा जा सके.

मांग के हिसाब से उपलब्ध कराई जाने वाली यात्राएं

शेड्यूल किए गए टास्क

वाहन के अनुरोध

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

  1. पैरंट: यह आपके Google Cloud प्रोजेक्ट आईडी से जुड़ा एक स्ट्रिंग होता है. इसका इस्तेमाल, वाहन के इंस्टेंस के नाम वाले फ़ील्ड में जानकारी भरने के लिए किया जाता है.

  2. वाहन का आईडी: यह एक यूनीक स्ट्रिंग होता है. इसका इस्तेमाल, वाहन के name फ़ील्ड में जानकारी भरने के लिए किया जाता है.

  3. वाहन का इंस्टेंस , जिसमें ज़रूरी फ़ील्ड शामिल हों. ये फ़ील्ड, Fleet Engine की उस सुविधा पर निर्भर करते हैं जिसका इस्तेमाल किया जा रहा है.

अनुरोध के मुख्य हिस्से में मौजूद जानकारी, अनुरोध के टाइप के हिसाब से अलग-अलग होती है. इनके बारे में ज़्यादा जानकारी पाने के लिए, इनसे जुड़ी गाइड देखें.

पुष्टि करने और अनुमति देने वाले टोकन

Fleet Engine को भेजे जाने वाले अनुरोधों में, ऐक्सेस के सही क्रेडेंशियल भी देने ज़रूरी हैं. इस गाइड में दिए गए उदाहरणों के लिए, ये शर्तें लागू होती हैं:

ज़्यादा जानकारी के लिए, Fleet Engine को सेट अप करने से जुड़ी गाइड देखें.

वाहन के रिसॉर्स के फ़ील्ड

वाहन के रिसॉर्स में, ये फ़ील्ड टाइप होते हैं:

  • सिर्फ़ आउटपुट वाले फ़ील्ड. ये ऐसे फ़ील्ड होते हैं जिन्हें सेवा, किसी दूसरे तरीके के आउटपुट के तौर पर सेट करती है. इन्हें सीधे तौर पर सेट नहीं किया जा सकता. name फ़ील्ड, इस टाइप का एक अहम फ़ील्ड है. उपयोगकर्ता के तय किए गए आईडी के लिए, Google AIP के निर्देशों के मुताबिक, Fleet Engine, वाहन के name फ़ील्ड के लिए दी गई किसी भी वैल्यू को अनदेखा करता है. अगर इन फ़ील्ड के लिए वैल्यू दी जाती हैं, तो Fleet Engine गड़बड़ी दिखाता है.
  • ज़रूरी फ़ील्ड. मांग के हिसाब से उपलब्ध कराई जाने वाली यात्रा की सेवा में बनाए गए वाहनों के लिए, बनाते समय कुछ फ़ील्ड सेट करना ज़रूरी है. शेड्यूल किए गए टास्क की सेवा में बनाए गए वाहनों के लिए, वाहन के रिसॉर्स के ज़रूरी फ़ील्ड नहीं होते.
  • ऐसे फ़ील्ड जो ज़रूरी नहीं हैं. दोनों सेवाओं में ऐसे फ़ील्ड होते हैं जिन्हें बनाते समय या बाद में सेट किया जा सकता है. इन्हें, इस्तेमाल की जा रही सेवा के रेफ़रंस के लिए बनी गाइड में देखा जा सकता है.

वाहन का नाम (सिर्फ़ आउटपुट के लिए)

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

  • पैरंट: यह आपके Google Cloud प्रोजेक्ट आईडी से जुड़ा एक स्ट्रिंग होता है. इसका फ़ॉर्मैट providers/{provider} होता है. इसमें {provider} आपके Cloud प्रोजेक्ट का आईडी होता है. किसी दिए गए प्रोजेक्ट के लिए बनाए गए हर वाहन का पैरंट पाथ एक ही होगा.

    यहां जिस Cloud प्रोजेक्ट का रेफ़रंस दिया गया है उसमें, इस्तेमाल की जा रही सेवा के लिए Fleet Engine के सेवा खाते की भूमिकाएं भी शामिल होनी चाहिए. इन सेवा खातों की सूची देखने के लिए, सेवा खाते देखें. Fleet Engine, एक से ज़्यादा Google Cloud प्रोजेक्ट से ऐक्सेस की सुविधा नहीं देता.

  • वाहन का आईडी. यह आपके बेड़े में मौजूद सभी वाहनों के लिए यूनीक होना चाहिए. साथ ही, यह मान्य यूनिकोड स्ट्रिंग होना चाहिए. यह वाहन के लिए रिसॉर्स आईडी होता है. मांग के हिसाब से उपलब्ध कराई जाने वाली यात्राओं और शेड्यूल किए गए स्टॉप, दोनों के लिए इसका इस्तेमाल किया जाता है, ताकि यात्रा या टास्क को पूरा करने वाले वाहन से जोड़ा जा सके.

Google Cloud पर आधारित सेवाओं में, सभी एपीआई को स्ट्रिंग के तौर पर रिसॉर्स के तौर पर दिखाना ज़रूरी है. ज़्यादा जानकारी के लिए, Fleet Engine में रिसॉर्स के नामकरण के बारे में जानकारी देखें.

इकाइयों के यूनीक आइडेंटिफ़ायर

रिसॉर्स कॉल में इस्तेमाल किए गए, इकाइयों के यूनीक आइडेंटिफ़ायर का फ़ॉर्मैट और वैल्यू, Fleet Engine के लिए ओपेक होती हैं. पक्का करें कि आइडेंटिफ़ायर में, व्यक्तिगत पहचान से जुड़ी कोई जानकारी (पीआईआई) न हो. जैसे, ड्राइवर का फ़ोन नंबर.

वाहन का दोबारा इस्तेमाल करना

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

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

ध्यान दें: Vehicle इकाई में मौजूद कुछ फ़ील्ड, जैसे कि device_settings सिर्फ़ डीबग करने की जानकारी होती है. इसे Fleet Engine सेव नहीं करता. इन्हें अपडेट करने से, Vehicle इकाई की लाइफ़ नहीं बढ़ती.

सिस्टम के बेहतर आंकड़ों के लिए, ड्राइवर-वाहन आईडी की एक ही जोड़ी का रोज़ाना दोबारा इस्तेमाल करना सबसे अच्छा है. ऐसा करने के लिए, पिछले शेड्यूल किए गए स्टॉप या मांग के हिसाब से उपलब्ध कराई जाने वाली यात्राओं के लिए, ड्राइवर से जुड़े वाहन के उसी आईडी का इस्तेमाल करें.

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