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

जगह की जानकारी की अनुमतियों का अनुरोध करें

उपयोगकर्ता की निजता की सुरक्षा के लिए, जगह की जानकारी का इस्तेमाल करने वाले ऐप्लिकेशन को जगह की जानकारी की अनुमतियों का अनुरोध करना होगा.

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

इस पेज पर, जगह की जानकारी से जुड़ी अलग-अलग ज़रूरी शर्तों के बारे में बताया गया है. साथ ही, हर मामले में जगह की जानकारी की अनुमतियों का अनुरोध करने का तरीका भी बताया गया है.

जगह की जानकारी के ऐक्सेस के टाइप

हर अनुमति में, इन विशेषताओं का कॉम्बिनेशन होता है:

कैटगरी: फ़ोरग्राउंड में जगह की जानकारी या बैकग्राउंड में जगह की जानकारी.
जगह की जानकारी कितनी सटीक है: जगह की सटीक जानकारी या अनुमानित जानकारी.

फ़ोरग्राउंड में जगह की जानकारी

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

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

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

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

इसके अलावा, हमारा सुझाव है कि आप location के लिए फ़ोरग्राउंड सेवा का टाइप बताएं, जैसा कि नीचे दिए गए कोड स्निपेट में दिखाया गया है. Android 10 (एपीआई लेवल 29) और उसके बाद के वर्शन पर, आपको फ़ोरग्राउंड सेवा के इस टाइप के बारे में एलान करना होगा.
```


<service
    android:name="MyNavigationService"
    android:foregroundServiceType="location" ... >
    
</service>
```

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

<manifest ... >
  <!-- Always include this permission -->
  <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

  <!-- Include only if your app benefits from precise location access. -->
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
</manifest>

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

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

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

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

Android 10 (एपीआई लेवल 29) और उसके बाद के वर्शन पर, रनटाइम के दौरान बैकग्राउंड में जगह की जानकारी ऐक्सेस करने का अनुरोध करने के लिए, आपको अपने ऐप्लिकेशन के मेनिफ़ेस्ट में ACCESS_BACKGROUND_LOCATION की अनुमति का एलान करना होगा. Android के पुराने वर्शन में, जब आपके ऐप्लिकेशन को फ़ोरग्राउंड में जगह की जानकारी का ऐक्सेस मिलता है, तो उसे बैकग्राउंड में भी जगह की जानकारी का ऐक्सेस अपने-आप मिल जाता है.

<manifest ... >
  <!-- Required only when requesting background location access on
       Android 10 (API level 29) and higher. -->
  <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
</manifest>

सटीक जानकारी

Android पर, जगह की जानकारी के इन लेवल का इस्तेमाल किया जा सकता है:

आस-पास: डिवाइस की जगह की जानकारी का अनुमान लगाता है. अगर जगह की जानकारी का अनुमान LocationManagerService या FusedLocationProvider से मिला है, तो यह अनुमान तीन वर्ग किलोमीटर (करीब 1.2 वर्ग मील) तक सटीक होता है. अगर आपने ACCESS_COARSE_LOCATION अनुमति का एलान किया है, लेकिन ACCESS_FINE_LOCATION अनुमति का नहीं, तो आपके ऐप्लिकेशन को जगह की जानकारी इस लेवल पर मिल सकती है.
सटीक: डिवाइस की जगह की जानकारी का सबसे सटीक अनुमान देता है. अगर जगह की जानकारी का अनुमान LocationManagerService या FusedLocationProvider है, तो आम तौर पर यह अनुमान करीब 50 मीटर (160 फ़ीट) के दायरे में होता है. कभी-कभी यह अनुमान कुछ मीटर (10 फ़ीट) या उससे भी सटीक होता है. ACCESS_FINE_LOCATION की अनुमति का एलान करने पर, आपके ऐप्लिकेशन को इस लेवल पर सटीक जानकारी मिल सकती है.

अगर उपयोगकर्ता ने जगह की अनुमानित जानकारी ऐक्सेस करने की अनुमति दी है, तो आपके ऐप्लिकेशन के पास सिर्फ़ जगह की अनुमानित जानकारी का ऐक्सेस होता है. भले ही, आपके ऐप्लिकेशन ने जगह की जानकारी ऐक्सेस करने से जुड़ी कौनसी अनुमतियां मांगी हों.

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

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

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

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

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

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

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`
अस्वीकार करें	जगह की जानकारी की अनुमति नहीं है	जगह की जानकारी की अनुमतियां नहीं दी गई हैं

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

Kotlin

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.
locationPermissionRequest.launch(arrayOf(
    Manifest.permission.ACCESS_FINE_LOCATION,
    Manifest.permission.ACCESS_COARSE_LOCATION))

Java

ActivityResultLauncher<String[]> locationPermissionRequest =
    registerForActivityResult(new ActivityResultContracts
        .RequestMultiplePermissions(), result -> {
            Boolean fineLocationGranted = result.getOrDefault(
                    Manifest.permission.ACCESS_FINE_LOCATION, false);
            Boolean 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
});

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

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

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

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

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

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

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

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

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

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

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

इंक्रीमेंटल अनुरोध करने की प्रोसेस इस तरह है:

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

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

ज़रूरत पड़ने पर, बैकग्राउंड में जगह की जानकारी का अनुरोध करना

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

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

अनुमति के डायलॉग बॉक्स का कॉन्टेंट, टारगेट किए जा रहे SDK टूल के वर्शन पर निर्भर करता है

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

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

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

ऐप्लिकेशन, Android 11 या उसके बाद के वर्शन को टारगेट करता है

अगर आपके ऐप्लिकेशन को ACCESS_BACKGROUND_LOCATION अनुमति नहीं मिली है और shouldShowRequestPermissionRationale() true दिखाता है, तो उपयोगकर्ताओं को जानकारी देने वाला यूज़र इंटरफ़ेस (यूआई) दिखाएं. इसमें ये चीज़ें शामिल होनी चाहिए:

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

उपयोगकर्ता किसी ऐप्लिकेशन के लिए जगह की जानकारी की सेटिंग बदलने के लिए, सिस्टम की सूचना पर टैप कर सकते हैं — **आठवां डायग्राम.** उपयोगकर्ता को यह याद दिलाने वाली सूचना कि उसने किसी ऐप्लिकेशन को, बैकग्राउंड में जगह की जानकारी का ऐक्सेस दिया है.

ऐप्लिकेशन, Android 10 या इससे पहले के वर्शन को टारगेट करता है

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

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

उपयोगकर्ता की गतिविधियों से, बैकग्राउंड में जगह की जानकारी की सटीकता पर असर पड़ सकता है

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

बैकग्राउंड में जगह की जानकारी ऐक्सेस करने की अनुमति देने का रिमाइंडर

Android 10 और उसके बाद के वर्शन पर, जब उपयोगकर्ता बैकग्राउंड में जगह की जानकारी ऐक्सेस करने की अनुमति देता है, तो आपके ऐप्लिकेशन की कोई सुविधा पहली बार बैकग्राउंड में डिवाइस की जगह की जानकारी ऐक्सेस करती है. इसके बाद, सिस्टम उपयोगकर्ता को सूचना भेजने के लिए शेड्यूल करता है. इस सूचना से उपयोगकर्ता को याद दिलाया जाता है कि उन्होंने आपके ऐप्लिकेशन को डिवाइस की जगह की जानकारी हर समय ऐक्सेस करने की अनुमति दी है. सूचना का उदाहरण, आठवीं इमेज में दिया गया है.

अपने ऐप्लिकेशन के SDK टूल डिपेंडेंसी में जगह की जानकारी से जुड़ी ज़रूरी शर्तों की जांच करना

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

अन्य संसाधन

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

कोडलैब

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

वीडियो

बैकग्राउंड में जगह की जानकारी का इस्तेमाल कैसे पता करें

सैंपल

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