इस पेज का अनुवाद Cloud Translation API से किया गया है.

रनटाइम के दौरान जगह की जानकारी ऐक्सेस करने का अनुरोध करें

जब आपके ऐप्लिकेशन में किसी सुविधा को जगह की जानकारी का ऐक्सेस चाहिए, तो अनुमति का अनुरोध करने से पहले तब तक इंतज़ार करें, जब तक उपयोगकर्ता उस सुविधा से इंटरैक्ट न कर ले. इस वर्कफ़्लो में, कॉन्टेक्स्ट के हिसाब से रनटाइम अनुमतियां मांगने का सबसे सही तरीका अपनाया गया है. इसके बारे में, ऐप्लिकेशन की अनुमतियों का अनुरोध करने के तरीके के बारे में बताने वाली गाइड में बताया गया है.

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

उपयोगकर्ता के 'जगह की जानकारी शेयर करें' बटन को चुनने के बाद, सिस्टम की जगह की जानकारी की अनुमति वाला डायलॉग बॉक्स दिखता है — **पहली इमेज.** जगह की जानकारी शेयर करने की सुविधा के लिए, फ़ोरग्राउंड में जगह की जानकारी ऐक्सेस करना ज़रूरी है. अगर उपयोगकर्ता **सिर्फ़ ऐप्लिकेशन का इस्तेमाल करते समय अनुमति दें** विकल्प चुनता है,

उपयोगकर्ता सिर्फ़ अनुमानित जगह की जानकारी शेयर करने की अनुमति दे सकता है

Android 12 (एपीआई लेवल 31) या उसके बाद के वर्शन पर, उपयोगकर्ता यह अनुरोध कर सकते हैं कि आपका ऐप्लिकेशन सिर्फ़ अनुमानित जगह की जानकारी इकट्ठा करे. ऐसा तब भी किया जा सकता है, जब आपका ऐप्लिकेशन ACCESS_FINE_LOCATION रनटाइम अनुमति का अनुरोध करता है.

उपयोगकर्ता के इस संभावित व्यवहार को मैनेज करने के लिए, ACCESS_FINE_LOCATION अनुमति का अनुरोध न करें. इसके बजाय, एक ही रनटाइम अनुरोध में ACCESS_FINE_LOCATION अनुमति और ACCESS_COARSE_LOCATION अनुमति, दोनों का अनुरोध करें. अगर सिर्फ़ ACCESS_FINE_LOCATION का अनुरोध किया जाता है, तो Android 12 के कुछ वर्शन पर सिस्टम इस अनुरोध को अनदेखा कर देता है. अगर आपका ऐप्लिकेशन Android 12 या इसके बाद के वर्शन को टारगेट करता है, तो सिस्टम Logcat में यह गड़बड़ी वाला मैसेज लॉग करता है:

ACCESS_FINE_LOCATION must be requested with ACCESS_COARSE_LOCATION.

ध्यान दें: उपयोगकर्ताओं की निजता का बेहतर तरीके से ध्यान रखने के लिए, हमारा सुझाव है कि आप सिर्फ़ ACCESS_COARSE_LOCATION का अनुरोध करें. जगह की अनुमानित जानकारी का ऐक्सेस होने पर भी, ज़्यादातर इस्तेमाल के उदाहरण पूरे किए जा सकते हैं. दूसरी इमेज में, उपयोगकर्ता को दिखने वाला डायलॉग दिखाया गया है. यह तब दिखता है, जब आपका ऐप्लिकेशन Android 12 को टारगेट करता है और सिर्फ़ ACCESS_COARSE_LOCATION का अनुरोध करता है.

जब आपका ऐप्लिकेशन ACCESS_FINE_LOCATION और ACCESS_COARSE_LOCATION, दोनों के लिए अनुरोध करता है, तो सिस्टम की अनुमतियों वाले डायलॉग में उपयोगकर्ता के लिए ये विकल्प शामिल होते हैं:

सटीक: इससे ऐप्लिकेशन को जगह की सटीक जानकारी मिलती है.
अनुमानित: इससे ऐप्लिकेशन को सिर्फ़ जगह की अनुमानित जानकारी मिलती है.

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

Android 12 और इसके बाद के वर्शन पर, उपयोगकर्ता सिस्टम सेटिंग में जाकर, किसी भी ऐप्लिकेशन के लिए जगह की जानकारी की सटीक सेटिंग सेट कर सकते हैं. भले ही, उस ऐप्लिकेशन का टारगेट SDK वर्शन कुछ भी हो. ऐसा तब भी होता है, जब आपका ऐप्लिकेशन Android 11 या इससे पहले के वर्शन वाले डिवाइस पर इंस्टॉल किया गया हो और बाद में उपयोगकर्ता, डिवाइस को Android 12 या इसके बाद के वर्शन पर अपग्रेड कर दे.

चेतावनी: अगर उपयोगकर्ता, अनुमति वाले डायलॉग बॉक्स या सिस्टम सेटिंग में जाकर, आपके ऐप्लिकेशन के लिए जगह की सटीक जानकारी को ऐक्सेस करने की अनुमति को अनुमानित जानकारी को ऐक्सेस करने की अनुमति में बदलता है, तो सिस्टम आपके ऐप्लिकेशन की प्रोसेस को फिर से शुरू करता है. इन वजहों से, यह बहुत ज़रूरी है कि रनटाइम अनुमतियां पाने का अनुरोध करने के लिए, सबसे सही तरीकों का पालन किया जाए.

डायलॉग में सिर्फ़ अनुमानित जगह की जानकारी दी गई है. इसमें एक के ऊपर एक तीन बटन दिए गए हैं — **दूसरी इमेज.** सिस्टम की अनुमतियों वाला डायलॉग बॉक्स, जो तब दिखता है, जब आपका ऐप्लिकेशन `ACCESS_COARSE_LOCATION` का अनुरोध करता है.

डायलॉग में विकल्पों के दो सेट हैं, जो एक-दूसरे के ऊपर हैं — **तीसरी इमेज.** सिस्टम की अनुमतियों वाला डायलॉग, जो तब दिखता है, जब आपका ऐप्लिकेशन रनटाइम के दौरान एक ही अनुरोध में `ACCESS_FINE_LOCATION` और `ACCESS_COARSE_LOCATION`, दोनों के लिए अनुरोध करता है.

उपयोगकर्ता की पसंद से अनुमतियां देने पर असर पड़ता है

इस टेबल में, उन अनुमतियों के बारे में बताया गया है जो सिस्टम, आपके ऐप्लिकेशन को देता है. ये अनुमतियां, उपयोगकर्ता के चुने गए उन विकल्पों पर आधारित होती हैं जो उसे अनुमतियों के रनटाइम डायलॉग में दिखते हैं:

	सटीक	आस-पास
ऐप्लिकेशन इस्तेमाल करते समय	`ACCESS_FINE_LOCATION` और `ACCESS_COARSE_LOCATION`	`ACCESS_COARSE_LOCATION`
सिर्फ़ इस बार अनुमति दें	`ACCESS_FINE_LOCATION` और `ACCESS_COARSE_LOCATION`	`ACCESS_COARSE_LOCATION`
Deny	जगह की जानकारी की अनुमतियां नहीं दी गई हैं	जगह की जानकारी की अनुमतियां नहीं दी गई हैं

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

Kotlin

@RequiresApi(Build.VERSION_CODES.N)
fun requestPermissions() {
    val locationPermissionRequest = registerForActivityResult(
        ActivityResultContracts.RequestMultiplePermissions()
    ) { permissions ->
        when {
            permissions.getOrDefault(Manifest.permission.ACCESS_FINE_LOCATION, false) -> {
                // Precise location access granted.
            }
            permissions.getOrDefault(Manifest.permission.ACCESS_COARSE_LOCATION, false) -> {
                // Only approximate location access granted.
            }
            else -> {
                // No location access granted.
            }
        }
    }

    // Before you perform the actual permission request, check whether your app
    // already has the permissions, and whether your app needs to show a permission
    // rationale dialog. For more details, see Request permissions:
    // https://developer.android.com/training/permissions/requesting#request-permission
    locationPermissionRequest.launch(
        arrayOf(
            Manifest.permission.ACCESS_FINE_LOCATION,
            Manifest.permission.ACCESS_COARSE_LOCATION
        )
    )
}LocationPermissionsActivity.kt

Java

private void requestPermissions() {

    ActivityResultLauncher<String[]> locationPermissionRequest =
            registerForActivityResult(new ActivityResultContracts
                            .RequestMultiplePermissions(), result -> {

                Boolean fineLocationGranted = null;
                Boolean coarseLocationGranted = null;

                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
                    fineLocationGranted = result.getOrDefault(
                            Manifest.permission.ACCESS_FINE_LOCATION, false);
                    coarseLocationGranted = result.getOrDefault(
                            Manifest.permission.ACCESS_COARSE_LOCATION,false);
                }

                if (fineLocationGranted != null && fineLocationGranted) {
                    // Precise location access granted.
                } else if (coarseLocationGranted != null && coarseLocationGranted) {
                    // Only approximate location access granted.
                } else {
                    // No location access granted.
                }
            }
        );

    // ...

    // Before you perform the actual permission request, check whether your app
    // already has the permissions, and whether your app needs to show a permission
    // rationale dialog. For more details, see Request permissions.
    locationPermissionRequest.launch(new String[] {
            Manifest.permission.ACCESS_FINE_LOCATION,
            Manifest.permission.ACCESS_COARSE_LOCATION
    });
}LocationPermissionsActivityJava.java

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

उपयोगकर्ता से, ऐप्लिकेशन के लिए जगह की अनुमानित जानकारी के ऐक्सेस को सटीक जानकारी के ऐक्सेस में अपग्रेड करने के लिए कहा जा सकता है. हालांकि, उपयोगकर्ता से अपने ऐप्लिकेशन के लिए सटीक जगह की जानकारी ऐक्सेस करने की अनुमति मांगने से पहले, यह देख लें कि क्या आपके ऐप्लिकेशन के इस्तेमाल के लिए, सटीक जगह की जानकारी की वाकई ज़रूरत है. अगर आपके ऐप्लिकेशन को ब्लूटूथ या वाई-फ़ाई के ज़रिए, आस-पास मौजूद डिवाइसों से किसी डिवाइस को पेयर करने की ज़रूरत है, तो ACCESS_FINE_LOCATION अनुमति का अनुरोध करने के बजाय, साथी डिवाइस को पेयर करने की सुविधा या ब्लूटूथ की अनुमतियों का इस्तेमाल करें.

उपयोगकर्ता से, ऐप्लिकेशन के लिए जगह की अनुमानित जानकारी के ऐक्सेस को सटीक जानकारी के ऐक्सेस में अपग्रेड करने का अनुरोध करने के लिए, यह तरीका अपनाएं:

ज़रूरत पड़ने पर, बताएं कि आपके ऐप्लिकेशन को अनुमति की ज़रूरत क्यों है.
ACCESS_FINE_LOCATION और ACCESS_COARSE_LOCATION की अनुमतियों के लिए एक साथ फिर से अनुरोध करें. उपयोगकर्ता ने सिस्टम को पहले ही यह अनुमति दे दी है कि वह आपके ऐप्लिकेशन को जगह की अनुमानित जानकारी दे. इसलिए, इस बार सिस्टम डायलॉग अलग है. इसे इमेज 4 और इमेज 5 में दिखाया गया है:

डायलॉग बॉक्स में, 'सटीक जगह की जानकारी पर स्विच करें', 'सिर्फ़ इस बार', और 'अस्वीकार करें' विकल्प मौजूद हैं. — **चौथी इमेज.** उपयोगकर्ता ने पहले **अनुमानित** और **ऐप्लिकेशन इस्तेमाल करते समय** चुना था (तीसरी इमेज में मौजूद डायलॉग में).

डायलॉग में, 'सिर्फ़ इस बार' और 'अस्वीकार करें' विकल्प मौजूद हैं. — **पांचवीं इमेज.** उपयोगकर्ता ने पहले **अनुमानित** और **सिर्फ़ इस बार** चुना था (तीसरी इमेज के डायलॉग में).

शुरुआत में, सिर्फ़ फ़ोरग्राउंड में जगह की जानकारी ऐक्सेस करने का अनुरोध करें

अगर आपके ऐप्लिकेशन में कई ऐसी सुविधाएं हैं जिनके लिए जगह की जानकारी ऐक्सेस करने की ज़रूरत होती है, तो हो सकता है कि उनमें से कुछ के लिए ही बैकग्राउंड में जगह की जानकारी ऐक्सेस करने की ज़रूरत हो. इसलिए, हमारा सुझाव है कि आपका ऐप्लिकेशन, जगह की जानकारी ऐक्सेस करने की अनुमतियों के लिए इंक्रीमेंटल अनुरोध करे. इसके तहत, पहले फ़ोरग्राउंड में जगह की जानकारी ऐक्सेस करने की अनुमति मांगी जाए और फिर बैकग्राउंड में जगह की जानकारी ऐक्सेस करने की अनुमति मांगी जाए. ज़्यादा अनुमति मांगने की सुविधा का इस्तेमाल करने से, उपयोगकर्ताओं को ज़्यादा कंट्रोल और पारदर्शिता मिलती है. ऐसा इसलिए, क्योंकि वे बेहतर तरीके से यह समझ पाते हैं कि आपके ऐप्लिकेशन की किन सुविधाओं को बैकग्राउंड में जगह की जानकारी ऐक्सेस करने की ज़रूरत है.

अहम जानकारी: अगर आपका ऐप्लिकेशन, Android 11 (एपीआई लेवल 30) या इसके बाद के वर्शन को टारगेट करता है, तो सिस्टम इस सबसे सही तरीके को लागू करता है. अगर आपने फ़ोरग्राउंड में जगह की जानकारी ऐक्सेस करने की अनुमति और बैकग्राउंड में जगह की जानकारी ऐक्सेस करने की अनुमति के लिए एक साथ अनुरोध किया है, तो सिस्टम इस अनुरोध को अनदेखा कर देगा. साथ ही, आपके ऐप्लिकेशन को इनमें से कोई भी अनुमति नहीं मिलेगी.

छठी इमेज में, ऐसे ऐप्लिकेशन का उदाहरण दिखाया गया है जिसे इंक्रीमेंटल अनुरोधों को मैनेज करने के लिए डिज़ाइन किया गया है. "मौजूदा जगह दिखाएं" और "आस-पास की जगहों के सुझाव दें" सुविधाओं के लिए, फ़ोरग्राउंड में जगह की जानकारी ऐक्सेस करने की अनुमति ज़रूरी है. हालांकि, सिर्फ़ "आस-पास की जगहों के सुझाव" सुविधा के लिए, बैकग्राउंड में जगह की जानकारी ऐक्सेस करने की ज़रूरत होती है.

फ़ोरग्राउंड में जगह की जानकारी ऐक्सेस करने की सुविधा चालू करने वाला बटन, बैकग्राउंड में जगह की जानकारी ऐक्सेस करने की सुविधा चालू करने वाले बटन से आधी स्क्रीन की दूरी पर मौजूद है — **छठी इमेज.** दोनों सुविधाओं के लिए, जगह की जानकारी ऐक्सेस करने की अनुमति ज़रूरी है. हालांकि, "आस-पास की सुविधाओं के बारे में सुझाव दें" सुविधा के लिए ही, बैकग्राउंड में जगह की जानकारी ऐक्सेस करने की अनुमति ज़रूरी है.

इंक्रीमेंटल अनुरोध करने का तरीका यहां दिया गया है:

सबसे पहले, आपके ऐप्लिकेशन को लोगों को उन सुविधाओं के बारे में बताना चाहिए जिनके लिए फ़ोरग्राउंड में जगह की जानकारी ऐक्सेस करना ज़रूरी है. जैसे, पहली इमेज में "जगह की जानकारी शेयर करें" सुविधा या दूसरी इमेज में "मौजूदा जगह की जानकारी दिखाएं" सुविधा.

हमारा सुझाव है कि जब तक आपके ऐप्लिकेशन को फ़ोरग्राउंड में जगह की जानकारी ऐक्सेस करने की अनुमति नहीं मिल जाती, तब तक उन सुविधाओं के लिए उपयोगकर्ता का ऐक्सेस बंद कर दें जिनके लिए बैकग्राउंड में जगह की जानकारी ऐक्सेस करने की अनुमति ज़रूरी है.
बाद में, जब उपयोगकर्ता उन सुविधाओं को एक्सप्लोर करता है जिनके लिए बैकग्राउंड में जगह की जानकारी के ऐक्सेस की ज़रूरत होती है, तब बैकग्राउंड में जगह की जानकारी के ऐक्सेस का अनुरोध किया जा सकता है.

अन्य संसाधन

Android में जगह की जानकारी की अनुमतियों के बारे में ज़्यादा जानने के लिए, यहां दिया गया कॉन्टेंट देखें:

कोडलैब

निजता बनाए रखने के सबसे सही तरीके

वीडियो

बैकग्राउंड में जगह की जानकारी ऐक्सेस करने वाली सुविधा के इस्तेमाल का पता कैसे लगाएं

सैंपल

जगह की जानकारी की अनुमतियों के इस्तेमाल को दिखाने के लिए, सैंपल ऐप्लिकेशन.