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 |
इनहेरिट किए गए तरीके की खास जानकारी
सार्वजनिक तरीके
सार्वजनिक स्टैटिक शून्य 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 |
सार्वजनिक शून्य setVehicleState (FleetEngine.VehicleState स्टेट)
VehicleState सेट करता है. अगर जगह की जानकारी को अपडेट करने की सुविधा चालू है, तो वैल्यू को जगह की जानकारी के अगले अपडेट के दौरान लागू किया जाएगा. अगर जगह की जानकारी के अपडेट की सुविधा बंद है, तो अपडेट तुरंत ट्रिगर हो जाता है.
VehicleState अपडेट, बैकग्राउंड थ्रेड में किया जाता है. यह कॉल तुरंत दिखता है.
पैरामीटर
state |
---|
थ्रो
IllegalStateException | अगर जगह की जानकारी ट्रैक करने की सुविधा चालू न होने पर VehicleState को ऑनलाइन पर सेट किया गया हो. |
---|