यह आम तौर पर किसी GoogleMap ऑब्जेक्ट को जगह की जानकारी का डेटा उपलब्ध कराने के लिए इंटरफ़ेस तय करता है.
GoogleMap ऑब्जेक्ट में, 'मेरी-जगह की जानकारी' लेयर के लिए, जगह की जानकारी देने वाली पहले से मौजूद सुविधा होती है. हालांकि, यह
किसी ऐसे इंटरफ़ेस के साथ replaced हो सकता है जो
इस इंटरफ़ेस को लागू करता हो.
GoogleMap ऑब्जेक्ट, activate(OnLocationChangedListener) का इस्तेमाल करके, जगह की जानकारी देने वाली सेवा को चालू करता है. चालू रहने के दौरान (activate(OnLocationChangedListener) से deactivate() के बीच), जगह की जानकारी देने वाली कंपनी को समय-समय पर जगह से जुड़े अपडेट, activate(OnLocationChangedListener) में रजिस्टर किए गए लोगों को भेजने चाहिए. यह सेवा देने वाली कंपनी की ज़िम्मेदारी है कि वह मैप की लाइफ़साइकल स्थिति के मुताबिक,
जगह की जानकारी का इस्तेमाल सोच-समझकर करें. उदाहरण के लिए, इसे कभी-कभी बैटरी पर ज़्यादा खर्च करने वाली सेवाओं (जैसे कि जीपीएस) का इस्तेमाल करना चाहिए. इसके अलावा, सिर्फ़ तब इस्तेमाल करना चाहिए, जब कोई गतिविधि फ़ोरग्राउंड में हो.
नेस्ट की गई क्लास की खास जानकारी
| इंटरफ़ेस | LocationSource.OnLocationChangedListener | जगह की जानकारी के अपडेट को हैंडल करता है. | |
सार्वजनिक तरीके से जुड़ी खास जानकारी
| ऐब्स्ट्रैक्ट शून्य | |
| ऐब्स्ट्रैक्ट शून्य |
बंद करें()
सेवा देने वाली इस कंपनी को बंद करें.
|
सार्वजनिक तरीके
सार्वजनिक ऐब्स्ट्रैक्ट शून्य चालू करें (LocationSource.OnLocationChangedListener लिसनर)
यह सेवा देने वाली कंपनी चालू करती है. जब तक आप deactivate() को कॉल नहीं करते, तब तक यह कंपनी तय किए गए सुनने वालों को समय-समय पर सूचना देगी. सूचनाएं मुख्य थ्रेड पर ब्रॉडकास्ट होंगी.
पैरामीटर
| लिसनर | एक लिसनर जिसे कॉल किया जाता है. इसे तब कॉल किया जाता है, जब कोई नई जगह उपलब्ध होती है |
|---|
थ्रो
| IllegalStateException | अगर सेवा देने वाली यह कंपनी पहले से चालू है |
|---|---|
| IllegalArgumentException | अगर listener null हो
|
सार्वजनिक ऐब्स्ट्रैक्ट शून्य बंद करें ()
सेवा देने वाली इस कंपनी को बंद करें. पहले से रजिस्टर किए गए कॉलबैक को आगे किसी भी अपडेट की सूचना नहीं दी जाती है.
थ्रो
| IllegalStateException | अगर सेवा देने वाली यह कंपनी पहले से ही काम नहीं कर रही है |
|---|