फ़्लीट इंजन

Public class FleetEngine ऑब्जेक्ट का विस्तार करता है

Google के फ़्लीट इंजन का क्लाइंट.

इस क्लास की मदद से, कॉल करने वाले (कॉलर) को enable और disableLocationTracking() जगह की जानकारी ट्रैक करने की सुविधा बंद कर सकते हैं. अपडेट की फ़्रीक्वेंसी को setLocationReportingInterval(long, TimeUnit) से कंट्रोल किया जा सकता है.

इस क्लास में थ्रेड सुरक्षित नहीं है.

नेस्ट की गई क्लास की खास जानकारी

इंटरफ़ेस FleetEngine.AuthTokenFactory इस इंटरफ़ेस के इंस्टेंस में, अलग-अलग कार्रवाइयां करने के दौरान, ऑथराइज़ेशन टोकन देने के लिए कहा जाएगा. 
क्लास FleetEngine.ErrorListener Fleet Engine क्लाइंट, इस इंटरफ़ेस के इंस्टेंस का इस्तेमाल करके, डेवलपर को अहम अपवाद मिलने पर सूचना देगा. 
इंटरफ़ेस FleetEngine.FleetEngineConfig यह इंटरफ़ेस अब काम नहीं करता. लेगसी हुक
इंटरफ़ेस FleetEngine.StatusListener स्टेटस के अपडेट के लिए आइडेंटिफ़ायर. 
enum FleetEngine.VehicleState इससे पता चलता है कि कोई वाहन नई यात्रा स्वीकार कर रहा है या नहीं. 

सार्वजनिक तरीके से जुड़ी खास जानकारी

स्टैटिक शून्य
clearInstance()
मिटने से पहले, जगह की जानकारी ट्रैक करना बंद कर देता है, अंदरूनी स्थिति को साफ़ करता है, और FleetEngine सिंगलटन को शून्य पर रीसेट करता है.
स्टैटिक शून्य
createInstance(ऐप्लिकेशन ऐप्लिकेशन, स्ट्रिंग प्रोवाइडर आईडी, स्ट्रिंग वाहन आईडी, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.ErrorListener गड़बड़ीListener)
FleetEngine सिंगलटन बनाता है, जिसका इस्तेमाल Google फ़्लीट इंजन सेवा को ऐक्सेस करने के लिए किया जा सकता है.
स्टैटिक शून्य
createInstance(ऐप्लिकेशन ऐप्लिकेशन, स्ट्रिंग प्रोवाइडर आईडी, स्ट्रिंग वाहन आईडी, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.StatusListener statusListener, FleetEngine.ErrorListenerErrorListener)
FleetEngine सिंगलटन बनाता है, जिसका इस्तेमाल Google फ़्लीट इंजन सेवा को ऐक्सेस करने के लिए किया जा सकता है.
void
disableLocationTracking()
जगह की जानकारी ट्रैक करना बंद कर देता है.
void
enableLocationTracking()
Fleet Engine के बैकएंड में, जगह की जानकारी की रिपोर्ट अपलोड करना शुरू करें.
स्टैटिक FleetEngine
getInstance()
FleetEngine सिंगलटन दिखाता है.
लंबा
getLocationReportingIntervalMs()
मौजूदा जगह की रिपोर्टिंग के इंटरवल को मिलीसेकंड में दिखाता है.
boolean
isLocationTrackingEnabled()
यह फ़ंक्शन दिखाता है कि जगह की जानकारी ट्रैक करने की सुविधा चालू है या नहीं.
स्टैटिक शून्य
setFleetEngineConfig(FleetEngine.FleetEngineConfig कॉन्फ़िगरेशन)
void
setLocationReportingInterval(लंबा इंटरवल, TimeUnitReturnUnits)
यह नीति, कम से कम वह इंटरवल सेट करती है जिस पर जगह की रिपोर्ट, फ़्लीट इंजन के बैकएंड को भेजी जाएगी.
स्टैटिक शून्य
setNavigator(नेविगेटर नेविगेटर)
void
setVehicleState(FleetEngine.VehicleState राज्य)
VehicleState सेट करता है.

इनहेरिट किए गए तरीके की खास जानकारी

सार्वजनिक तरीके

सार्वजनिक स्टैटिक शून्य clearInstance ()

मिटने से पहले, जगह की जानकारी ट्रैक करना बंद कर देता है, अंदरूनी स्थिति को साफ़ करता है, और FleetEngine सिंगलटन को शून्य पर रीसेट करता है.

createInstanceFleetEngine.AuthTokenFactoryFleetEngine.ErrorListener

FleetEngine सिंगलटन बनाता है, जिसका इस्तेमाल Google फ़्लीट इंजन सेवा को ऐक्सेस करने के लिए किया जा सकता है. अंदरूनी तौर पर, यह तरीका getRoadSnappedLocationProvider(Application) का इस्तेमाल करके RoadSnappedLocationProvider हासिल करता है. इसलिए, इस तरीके को कॉल करने से पहले, Navigator को हासिल करना ज़रूरी है. ऐसा न करने पर, इसका नतीजा IllegalStateException मिलेगा. createइंस्टेंस() को दो बार कॉल करने से IllegalStateException मिलेगा.

पैरामीटर
ऐप्लिकेशन मौजूदा Application, null नहीं होनी चाहिए
providerId सेवा देने वाली कंपनी का आईडी
vehicleId उस वाहन का आईडी जिसे फ़्लीट इंजन से जोड़ा जाएगा
authTokenFactory वह factory जो फ़्लीट इंजन के ऑथराइज़ेशन टोकन की सप्लाई करता है
errorListener listener, जिसे फ़्लीट इंजन क्लाइंट से जुड़ी गड़बड़ियां होने पर सूचना दी जाएगी
थ्रो
IllegalStateException अगर AndroidManifest.xml में कंपनी का आईडी नहीं दिया गया है

createInstanceFleetEngine.AuthTokenFactoryFleetEngine.StatusListenerFleetEngine.ErrorListener

FleetEngine सिंगलटन बनाता है, जिसका इस्तेमाल Google फ़्लीट इंजन सेवा को ऐक्सेस करने के लिए किया जा सकता है. अंदरूनी तौर पर, यह तरीका getRoadSnappedLocationProvider(Application) का इस्तेमाल करके RoadSnappedLocationProvider हासिल करता है. इसलिए, इस तरीके को कॉल करने से पहले, Navigator को हासिल करना ज़रूरी है. ऐसा न करने पर, इसका नतीजा IllegalStateException मिलेगा. createइंस्टेंस() को दो बार कॉल करने से IllegalStateException मिलेगा.

पैरामीटर
ऐप्लिकेशन मौजूदा Application, null नहीं होनी चाहिए.
providerId सेवा देने वाली कंपनी का आईडी डालें.
vehicleId उस वाहन का आईडी जिसे फ़्लीट इंजन से जोड़ा जाएगा
authTokenFactory factory, जो फ़्लीट इंजन के ऑथराइज़ेशन टोकन की सप्लाई करता है.
statusListener लिसनर का इस्तेमाल करें.
errorListener listener, जिसे फ़्लीट इंजन क्लाइंट से जुड़ी गड़बड़ियां होने पर सूचना दी जाएगी.
थ्रो
IllegalStateException अगर AndroidManifest.xml में कंपनी आईडी की जानकारी नहीं दी गई है.

सार्वजनिक शून्य disableLocationTracking ()

जगह की जानकारी ट्रैक करना बंद कर देता है. पहले से चल रही किसी भी रिपोर्ट को रोकने की कोशिश नहीं की जाती है. हालांकि, रैंकिंग की कोई भी नई रिपोर्ट जनरेट या ट्रांसमिट नहीं की जाएगी.

enableLocationTracking() को फिर से कॉल करके, ट्रैकिंग को फिर से शुरू किया जा सकता है.

थ्रो
IllegalStateException अगर जगह की जानकारी की ट्रैकिंग पहले से ही बंद थी

सार्वजनिक शून्य enableLocationTracking ()

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

पोज़िशन की रिपोर्ट, बैकग्राउंड थ्रेड में बनाई जाती हैं. यह कॉल तुरंत जवाब देता है.

disableLocationTracking() पर कॉल करके, जगह की जानकारी ट्रैक करने की सुविधा बंद की जा सकती है.

रिपोर्टिंग इंटरवल को setLocationReportingInterval(long, TimeUnit) से बदला जा सकता है.

थ्रो
IllegalStateException अगर जगह की जानकारी की ट्रैकिंग पहले से चालू थी

सार्वजनिक स्टैटिक FleetEngine getInstance ()

FleetEngine सिंगलटन दिखाता है. createइंस्टेंस() को getइंस्टेंस() से पहले कॉल करना चाहिए, नहीं तो शून्य लौटाया जाएगा.

सार्वजनिक लंबी अवधि getLocationReportingIntervalMs ()

मौजूदा जगह की रिपोर्टिंग के इंटरवल को मिलीसेकंड में दिखाता है.

सार्वजनिक बूलियन isLocationTrackingEnabled ()

यह फ़ंक्शन दिखाता है कि जगह की जानकारी ट्रैक करने की सुविधा चालू है या नहीं.

Public स्टैटिक void setFleetEngineConfig (FleetEngine.FleetEngineConfig कॉन्फ़िगरेशन)

पैरामीटर
कॉन्फ़िगरेशन

Public अमान्य setLocationReportingInterval (लंबा इंटरवल, TimeUnitReturnUnits)

यह नीति, कम से कम वह इंटरवल सेट करती है जिस पर जगह की रिपोर्ट, फ़्लीट इंजन के बैकएंड को भेजी जाएगी. डिफ़ॉल्ट रिपोर्टिंग इंटरवल 10 सेकंड है. अपडेट का कम से कम अंतराल 5 सेकंड का है. ज़्यादा बार अपडेट करने पर, अनुरोध करने में ज़्यादा समय लग सकता है और गड़बड़ियां हो सकती हैं.

पैरामीटर
इंटरवल
intervalUnits

सार्वजनिक स्टैटिक शून्य setNavigator (नेविगेटर नेविगेटर)

पैरामीटर
रास्ता बताने वाला

सार्वजनिक शून्य setVehicleState (FleetEngine.VehicleState स्टेट)

VehicleState सेट करता है. अगर जगह की जानकारी को अपडेट करने की सुविधा चालू है, तो वैल्यू को जगह की जानकारी के अगले अपडेट के दौरान लागू किया जाएगा. अगर जगह की जानकारी के अपडेट की सुविधा बंद है, तो अपडेट तुरंत ट्रिगर हो जाता है.

VehicleState अपडेट, बैकग्राउंड थ्रेड में किया जाता है. यह कॉल तुरंत दिखता है.

पैरामीटर
state
थ्रो
IllegalStateException अगर जगह की जानकारी ट्रैक करने की सुविधा चालू न होने पर VehicleState को ऑनलाइन पर सेट किया गया हो.