फ़्लीट इंजन में वाहन कैसे काम करते हैं, इस बारे में सामान्य जानकारी के लिए फ़्लीट इंजन के लिए ज़रूरी सेक्शन में ये गाइड पढ़ें:
इस सेक्शन में मौजूद दस्तावेज़ में, वाहनों को बनाने और मैनेज करने का तरीका बताया गया है फ़्लीट इंजन. फ़्लीट इंजन के सर्वर एनवायरमेंट में गाड़ियां बनाई जाती हैं, ताकि असल दुनिया में असल वाहनों की स्क्रीन शेयर करें. आपका फ़्लीट इंजन वाहन भी आपके बैकएंड सिस्टम में इस्तेमाल किए गए वाहनों से मेल खाने चाहिए इसे वाहन के असाइनमेंट और रूटिंग के लिए इस्तेमाल किया जाता है.
gRPC या REST का इस्तेमाल करके, वाहन के संसाधन बनाने के लिए बनाने के तरीके का इस्तेमाल किया जाता है. इस गाइड में मौजूद फ़ील्ड के नाम, आसानी से काम करने के लिए gRPC नोटेशन का इस्तेमाल करते हैं.
मांग पर यात्राएं
CreateVehicleRequest(जीआरपीसी)providers.vehicle.create(REST)Vehicleसंसाधन (REST, gRPC)
शेड्यूल किए गए टास्क
CreateDeliveryVehicleRequest(जीआरपीसी)providers.deliveryVehicles.create(REST)DeliveryVehicle(REST, gRPC)
वाहन के लिए अनुरोध
मांग पर उपलब्ध और शेड्यूल किए गए, दोनों तरह के टास्क के लिए, वाहन का इस्तेमाल करके, फ़ील्ड के साथ अनुरोध वाला मैसेज जारी किया है. इस मैसेज की खास जानकारी इस तरह दी गई है:
- पैरंट: आपके Google Cloud प्रोजेक्ट आईडी से जुड़ी स्ट्रिंग, जिसका इस्तेमाल किया जाता है का इस्तेमाल करें.
वाहन का आईडी: एक यूनीक स्ट्रिंग, जिसका इस्तेमाल
nameको पॉप्युलेट करने के लिए किया जाता है फ़ील्ड में.वाहन इंस्टेंस, जिसमें ज़रूरी फ़ील्ड मौजूद हों. ये फ़ील्ड फ़्लीट इंजन की आपकी क्षमता.
अनुरोध के मुख्य हिस्से में दी गई जानकारी, अनुरोध के टाइप के हिसाब से अलग-अलग होती है. यहां जाएं: की जानकारी मिलेगी.
पुष्टि करने और अनुमति देने वाले टोकन
फ़्लीट इंजन को किए जाने वाले अनुरोधों में, सही ऐक्सेस क्रेडेंशियल भी देने चाहिए. इस गाइड के उदाहरणों में ये अनुमान शामिल हैं:
- gRPC के उदाहरणों में यह माना जाता है कि Java के लिए, अनुमति वाली लाइब्रेरी का इस्तेमाल किया जा सकता है.
- REST के उदाहरण में एचटीटीपी अनुरोध का हेडर दिखाया गया है, जिसमें
Bearer <token>की वैल्यू के साथAuthorizationफ़ील्ड, जहां<token>एक है आपको मिले JSON वेब टोकन से जुड़ी समस्या.
ज़्यादा जानकारी के लिए, फ़्लीट इंजन सेट अप करने से जुड़ी गाइड देखें.
वाहन के संसाधन फ़ील्ड
वाहन के संसाधन में ये फ़ील्ड होते हैं:
- सिर्फ़ आउटपुट वाले फ़ील्ड. सेवा की ओर से सेट किए गए फ़ील्ड, जिनके आउटपुट के तौर पर
और सीधे सेट नहीं किया जा सकता. इसके लिए एक ज़रूरी फ़ील्ड
nameफ़ील्ड टाइप है. फ़्लीट इंजन उपयोगकर्ता के लिए तय किए गए दिशा-निर्देशों के मुताबिक वाहन काnameफ़ील्ड आईडी. अगर इन फ़ील्ड के लिए वैल्यू दी जाती हैं, तो Fleet Engine कोई गड़बड़ी दिखाता है. - ज़रूरी फ़ील्ड. मांग पर यात्रा की सेवा के लिए बनाए गए वाहनों के लिए, यह ज़रूरी है कुछ फ़ील्ड बनाए जाने पर सेट किए जा सकते हैं. शेड्यूल किए गए समय में बनाए गए वाहन टास्क सेवा के लिए, वाहन के संसाधन फ़ील्ड की कोई ज़रूरत नहीं है.
- ऐसे फ़ील्ड जो ज़रूरी नहीं हैं. दोनों सेवाओं में फ़ील्ड होते हैं. इन्हें बनाते समय सेट किया जा सकता है या बाद में ऐसा करते हैं. इन्हें संबंधित संदर्भ गाइड में देखा जा सकता है: का उपयोग करते हैं.
वाहन का नाम (सिर्फ़ आउटपुट के लिए)
मांग पर उपलब्ध यात्राओं और शेड्यूल किए गए टास्क के लिए, name फ़ील्ड एक जैसा ही होता है
सेवाओं. जब आप वाहन बनाते हैं, तो फ़्लीट इंजन फ़ील्ड तय करता है. ये नियम इन चीज़ों के आधार पर तय किए जाते हैं
वाहन बनाते समय, ये दो फ़ील्ड सेट किए जाते हैं:
पैरंट: यह एक स्ट्रिंग होती है, जो फ़ॉर्म
providers/{provider}, जहां{provider}आपके क्लाउड का आईडी है प्रोजेक्ट. किसी प्रोजेक्ट के लिए बनाया गया हर वाहन एक ही होगा पैरंट पाथ.आप जिस क्लाउड प्रोजेक्ट का रेफ़रंस यहां दे रहे हैं उसमें फ़्लीट इंजन भी शामिल होना चाहिए इस्तेमाल की जा रही सेवा के लिए, सेवा खाते की भूमिकाएं. इनके लिए सेवा खाते देखें उन सेवा खातों की सूची बनाओ. फ़्लीट इंजन इनसे ऐक्सेस नहीं करता एक से ज़्यादा Google Cloud प्रोजेक्ट शामिल हैं.
वाहन का आईडी, जो आपके सभी वाहनों के लिए अलग-अलग होना चाहिए फ़्लीट में मौजूद होना चाहिए और एक मान्य यूनिकोड स्ट्रिंग होना चाहिए. यह संसाधन आईडी है. वाहन. मांग पर यात्रा और शेड्यूल किए गए स्टॉप, दोनों इसका इस्तेमाल यात्रा या वाहन के साथ किसी टास्क को पूरा किया जा सकता है.
Google Cloud की सेवाओं में, सभी एपीआई को संसाधनों को स्ट्रिंग के तौर पर दिखाना चाहिए. ज़्यादा जानकारी के लिए, फ़्लीट इंजन में संसाधनों का नाम देखें.
यूनीक इकाई आइडेंटिफ़ायर
रिसॉर्स कॉल में इस्तेमाल किए जाने वाले यूनीक एंटिटी आइडेंटिफ़ायर का फ़ॉर्मैट और वैल्यू: फ़्लीट इंजन के लिए ओपेक. पक्का करें कि आइडेंटिफ़ायर में ड्राइवर का फ़ोन नंबर जैसी व्यक्तिगत पहचान से जुड़ी जानकारी.
गाड़ी का दोबारा इस्तेमाल
वाहन किसी दी गई यात्रा की योजना के सभी स्टॉप पूरे कर लेने के बाद भी आपके पास मौजूद रहता है फ़्लीट इंजन में सात दिनों तक फिर से इस्तेमाल करने के लिए, इसका मतलब है कि वाहन को इस पर फिर से इस्तेमाल किया जा सकता है: सदस्यता के लिए, ऑफ़र देने की ज़रूरत नहीं होती. हर बार जब तब भी, फ़्लीट इंजन अपनी उपलब्धता को रीसेट करता है, जब सात दिनों का काउंटडाउन फिर से शुरू हो गया है.
हमारा सुझाव है कि फ़्लीट इंजन में किसी वाहन को उपलब्ध रखने के लिए, यह तरीका अपनाएं
समय-समय पर इसकी जगह की जानकारी अपडेट करते रहें. इसके ज़्यादातर अन्य फ़ील्ड में किए गए अपडेट
Vehicle इकाई अपनी लाइफ़ भी बढ़ा सकती है, बशर्ते नए फ़ील्ड की वैल्यू
यह मौजूदा ऐसेट से अलग है.
ध्यान दें: device_settings जैसी Vehicle इकाई के कुछ फ़ील्ड पूरी तरह से डीबग होते हैं
ऐसी जानकारी जो फ़्लीट इंजन में सेव नहीं होती है. उन्हें अपडेट करने से
Vehicle इकाई के जीवन की अवधि को बढ़ाया जा सकता है.
सिस्टम के बेहतर आंकड़े पाने के लिए, बेहतर होगा कि आप उसी ड्राइवर-वाहन आईडी का फिर से इस्तेमाल करें साथ ही, उन्हें हर दिन के हिसाब से दिखाया जा रहा है. ऐसा करने के लिए, उसी वाहन आईडी का इस्तेमाल करें जो पिछले शेड्यूल किए गए स्टॉप या मांग पर की जाने वाली यात्राओं के लिए ड्राइवर.