जगह की जानकारी के अपडेट का अनुरोध करें

जगह की जानकारी का सही इस्तेमाल करने से, आपके ऐप्लिकेशन के उपयोगकर्ताओं को फ़ायदा मिल सकता है. उदाहरण के लिए, अगर आपका ऐप्लिकेशन, पैदल या गाड़ी चलाते समय उपयोगकर्ता को रास्ता ढूंढने में मदद करता है या आपका ऐप्लिकेशन एसेट की जगह की जानकारी ट्रैक करता है, तो उसे समय-समय पर डिवाइस की जगह की जानकारी चाहिए. जगह की जानकारी (अक्षांश और देशांतर) के साथ-साथ, उपयोगकर्ता को और भी जानकारी दी जा सकती है. जैसे, डिवाइस की दिशा (यात्रा की हॉरिज़ॉन्टल दिशा), ऊंचाई या वेग. यह जानकारी और इससे जुड़ी अन्य जानकारी, Location ऑब्जेक्ट में उपलब्ध होती है. आपका ऐप्लिकेशन, कई तरह से जांची गई सही जगह की जानकारी देने वाले एपीआई से यह जानकारी हासिल कर सकता है. इसके जवाब में, एपीआई समय-समय पर आपके ऐप्लिकेशन को सबसे अच्छी जगह की जानकारी देता है. यह जानकारी, वाई-फ़ाई और जीपीएस (ग्लोबल पोज़िशनिंग सिस्टम) जैसी जगह की जानकारी देने वाली मौजूदा सेवाओं के आधार पर दी जाती है. जगह की जानकारी कितनी सटीक है, यह कई बातों पर निर्भर करता है. जैसे, जगह की जानकारी देने वाली सेवा देने वाली कंपनियां, जगह की जानकारी के लिए आपने जो अनुमतियां मांगी हैं, और जगह की जानकारी के अनुरोध में सेट किए गए विकल्प.

इस लेसन में, फ़्यूज़्ड लोकेशन प्रोवाइडर में requestLocationUpdates() तरीके का इस्तेमाल करके, किसी डिवाइस की जगह की जानकारी के बारे में नियमित अपडेट का अनुरोध करने का तरीका बताया गया है.

डिवाइस की आखिरी लोकेशन की जानकारी पाना

डिवाइस की पिछली जगह की जानकारी से, ऐप्लिकेशन को जगह की जानकारी के अपडेट भेजने की प्रोसेस शुरू करने में मदद मिलती है. इससे, ऐप्लिकेशन को समय-समय पर जगह की जानकारी के अपडेट भेजने से पहले, यह पक्का करने में मदद मिलती है कि उसके पास जगह की जानकारी मौजूद है. डिवाइस की आखिरी लोकेशन पाने के बारे में बताने वाले लेसन में, getLastLocation() को कॉल करके, डिवाइस की आखिरी लोकेशन पाने का तरीका बताया गया है. नीचे दिए गए सेक्शन में मौजूद स्निपेट, इस बात पर आधारित हैं कि आपके ऐप्लिकेशन ने पहले ही, आपकी आखिरी लोकेशन का पता लगा लिया है और उसे ग्लोबल वैरिएबल mCurrentLocation में Location ऑब्जेक्ट के तौर पर सेव कर लिया है.

जगह की जानकारी का अनुरोध करना

जगह की जानकारी के अपडेट का अनुरोध करने से पहले, आपके ऐप्लिकेशन को जगह की जानकारी से जुड़ी सेवाओं से कनेक्ट करना होगा और जगह की जानकारी का अनुरोध करना होगा. जगह की जानकारी की सेटिंग बदलना लेख में, ऐसा करने का तरीका बताया गया है. जगह की जानकारी का अनुरोध करने के बाद, requestLocationUpdates() को कॉल करके, जगह की जानकारी के नियमित अपडेट पाने की सुविधा शुरू की जा सकती है.

अनुरोध के फ़ॉर्म के आधार पर, फ़्यूज़ की गई जगह की जानकारी देने वाली सेवा देने वाली कंपनी, LocationCallback.onLocationResult() कॉलबैक तरीके को शुरू करती है और उसे Location ऑब्जेक्ट की सूची देती है. इसके अलावा, वह ऐसा भी कर सकती है कि वह PendingIntent को जारी करे, जिसमें एक्सटेंड किए गए डेटा में जगह की जानकारी शामिल हो. अपडेट की सटीकता और फ़्रीक्वेंसी पर, जगह की जानकारी की जिन अनुमतियों का आपने अनुरोध किया है उनका असर पड़ता है. साथ ही, जगह की जानकारी के अनुरोध ऑब्जेक्ट में सेट किए गए विकल्पों का भी असर पड़ता है.

इस लेसन में, LocationCallback कॉलबैक वाले तरीके का इस्तेमाल करके अपडेट पाने का तरीका बताया गया है. requestLocationUpdates() को कॉल करें. इसके लिए, LocationRequest ऑब्जेक्ट का अपना इंस्टेंस और LocationCallback पास करें. startLocationUpdates() का तरीका तय करें, जैसा कि नीचे दिए गए कोड सैंपल में दिखाया गया है:

override fun onResume() {
    super.onResume()
    if (requestingLocationUpdates) startLocationUpdates()
}

private fun startLocationUpdates() {
    fusedLocationClient.requestLocationUpdates(locationRequest,
            locationCallback,
            Looper.getMainLooper())
}

@Override
protected void onResume() {
    super.onResume();
    if (requestingLocationUpdates) {
        startLocationUpdates();
    }
}

private void startLocationUpdates() {
    fusedLocationClient.requestLocationUpdates(locationRequest,
            locationCallback,
            Looper.getMainLooper());
}

ध्यान दें कि ऊपर दिया गया कोड स्निपेट, requestingLocationUpdates नाम के बूलियन फ़्लैग का रेफ़रंस देता है. इसका इस्तेमाल यह ट्रैक करने के लिए किया जाता है कि उपयोगकर्ता ने जगह की जानकारी के अपडेट चालू किए हैं या बंद किए हैं. अगर उपयोगकर्ताओं ने जगह की जानकारी के अपडेट बंद किए हैं, तो उन्हें अपने ऐप्लिकेशन के लिए जगह की जानकारी की ज़रूरत के बारे में बताया जा सकता है. गतिविधि के सभी इंस्टेंस में बूलियन फ़्लैग की वैल्यू बनाए रखने के बारे में ज़्यादा जानने के लिए, गतिविधि की स्थिति सेव करना लेख पढ़ें.

जगह की जानकारी अपडेट करने के लिए कॉलबैक तय करना

कई तरह से जांची गई सही जगह की जानकारी देने वाला एपीआई, LocationCallback.onLocationResult() कॉलबैक तरीके को लागू करता है. इनकमिंग आर्ग्युमेंट में एक सूची Location ऑब्जेक्ट होता है, जिसमें जगह का अक्षांश और देशांतर होता है. नीचे दिए गए स्निपेट में, LocationCallback इंटरफ़ेस को लागू करने और तरीका तय करने का तरीका बताया गया है. साथ ही, इसमें जगह की जानकारी अपडेट होने का टाइमस्टैंप पाने और अपने ऐप्लिकेशन के यूज़र इंटरफ़ेस पर अक्षांश, देशांतर, और टाइमस्टैंप दिखाने का तरीका भी बताया गया है:

private lateinit var locationCallback: LocationCallback

// ...

override fun onCreate(savedInstanceState: Bundle?) {
    // ...

    locationCallback = object : LocationCallback() {
        override fun onLocationResult(locationResult: LocationResult?) {
            locationResult ?: return
            for (location in locationResult.locations){
                // Update UI with location data
                // ...
            }
        }
    }
}

private LocationCallback locationCallback;

// ...

@Override
protected void onCreate(Bundle savedInstanceState) {
    // ...

    locationCallback = new LocationCallback() {
        @Override
        public void onLocationResult(LocationResult locationResult) {
            if (locationResult == null) {
                return;
            }
            for (Location location : locationResult.getLocations()) {
                // Update UI with location data
                // ...
            }
        }
    };
}

जगह की जानकारी के अपडेट रोकना

यह तय करें कि जब गतिविधि पर फ़ोकस न हो, तब जगह की जानकारी के अपडेट रोकने हैं या नहीं. जैसे, जब उपयोगकर्ता किसी दूसरे ऐप्लिकेशन पर स्विच करता है या उसी ऐप्लिकेशन में किसी दूसरी गतिविधि पर स्विच करता है. इससे बैटरी खर्च कम हो सकता है. हालांकि, इसके लिए ज़रूरी है कि ऐप्लिकेशन को बैकग्राउंड में चलने के दौरान भी जानकारी इकट्ठा न करनी पड़े. इस सेक्शन में बताया गया है कि गतिविधि के onPause() तरीके में, अपडेट को कैसे रोका जा सकता है.

जगह की जानकारी के अपडेट रोकने के लिए, removeLocationUpdates() को कॉल करें. साथ ही, उसमें LocationCallback को पास करें. जैसा कि यहां दिए गए कोड सैंपल में दिखाया गया है:

override fun onPause() {
    super.onPause()
    stopLocationUpdates()
}

private fun stopLocationUpdates() {
    fusedLocationClient.removeLocationUpdates(locationCallback)
}

@Override
protected void onPause() {
    super.onPause();
    stopLocationUpdates();
}

private void stopLocationUpdates() {
    fusedLocationClient.removeLocationUpdates(locationCallback);
}

जगह की जानकारी के अपडेट फ़िलहाल चालू हैं या नहीं, यह ट्रैक करने के लिए बूलियन, requestingLocationUpdates का इस्तेमाल करें. गतिविधि के onResume() तरीके में, देखें कि जगह की जानकारी के अपडेट फ़िलहाल चालू हैं या नहीं. अगर नहीं हैं, तो उन्हें चालू करें:

override fun onResume() {
    super.onResume()
    if (requestingLocationUpdates) startLocationUpdates()
}

@Override
protected void onResume() {
    super.onResume();
    if (requestingLocationUpdates) {
        startLocationUpdates();
    }
}

गतिविधि की स्थिति सेव करना

डिवाइस के कॉन्फ़िगरेशन में बदलाव करने पर, मौजूदा गतिविधि मिट सकती है. जैसे, स्क्रीन के ओरिएंटेशन या भाषा में बदलाव करना. इसलिए, आपके ऐप्लिकेशन को गतिविधि को फिर से शुरू करने के लिए, ज़रूरी जानकारी सेव करनी होगी. ऐसा करने का एक तरीका, Bundle ऑब्जेक्ट में सेव किए गए इंस्टेंस स्टेट के ज़रिए है.

यहां दिए गए कोड सैंपल में, इंस्टेंस की स्थिति सेव करने के लिए गतिविधि के onSaveInstanceState() कॉलबैक का इस्तेमाल करने का तरीका बताया गया है:

override fun onSaveInstanceState(outState: Bundle?) {
    outState?.putBoolean(REQUESTING_LOCATION_UPDATES_KEY, requestingLocationUpdates)
    super.onSaveInstanceState(outState)
}

@Override
protected void onSaveInstanceState(Bundle outState) {
    outState.putBoolean(REQUESTING_LOCATION_UPDATES_KEY,
            requestingLocationUpdates);
    // ...
    super.onSaveInstanceState(outState);
}

अगर गतिविधि के पिछले इंस्टेंस में सेव की गई वैल्यू उपलब्ध हैं, तो उन्हें वापस लाने के लिए updateValuesFromBundle() तरीका तय करें. गतिविधि के onCreate() तरीके से, तरीके को कॉल करें, जैसा कि नीचे दिए गए कोड सैंपल में दिखाया गया है:

override fun onCreate(savedInstanceState: Bundle?) {
    // ...
    updateValuesFromBundle(savedInstanceState)
}

private fun updateValuesFromBundle(savedInstanceState: Bundle?) {
    savedInstanceState ?: return

    // Update the value of requestingLocationUpdates from the Bundle.
    if (savedInstanceState.keySet().contains(REQUESTING_LOCATION_UPDATES_KEY)) {
        requestingLocationUpdates = savedInstanceState.getBoolean(
                REQUESTING_LOCATION_UPDATES_KEY)
    }

    // ...

    // Update UI to match restored state
    updateUI()
}

@Override
public void onCreate(Bundle savedInstanceState) {
    // ...
    updateValuesFromBundle(savedInstanceState);
}

private void updateValuesFromBundle(Bundle savedInstanceState) {
    if (savedInstanceState == null) {
        return;
    }

    // Update the value of requestingLocationUpdates from the Bundle.
    if (savedInstanceState.keySet().contains(REQUESTING_LOCATION_UPDATES_KEY)) {
        requestingLocationUpdates = savedInstanceState.getBoolean(
                REQUESTING_LOCATION_UPDATES_KEY);
    }

    // ...

    // Update UI to match restored state
    updateUI();
}

इंस्टेंस की स्थिति सेव करने के बारे में ज़्यादा जानने के लिए, Android गतिविधि क्लास का रेफ़रंस देखें.

ध्यान दें: उपयोगकर्ता की प्राथमिकताओं को ज़्यादा समय तक सेव रखने के लिए, आपके पास अपने ऐप्लिकेशन के SharedPreferences में उन्हें सेव करने का विकल्प है. अपनी गतिविधि के onPause() तरीके में, शेयर की गई सेटिंग सेट करें और onResume() में सेटिंग को वापस पाएं. प्राथमिकताओं को सेव करने के बारे में ज़्यादा जानने के लिए, कुंजी-वैल्यू सेट को सेव करना लेख पढ़ें.

अन्य संसाधन

ज़्यादा जानने के लिए, इन संसाधनों का इस्तेमाल करें:

सैंपल

• Android में जगह की जानकारी के अपडेट पाने का तरीका दिखाने वाला सैंपल ऐप्लिकेशन.