जियोफ़ेंस बनाएं और उसे मॉनिटर करें

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

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

इस लेख में, जियोफ़ेंस जोड़ने और हटाने का तरीका बताया गया है. साथ ही, BroadcastReceiver का इस्तेमाल करके, जियोफ़ेंस ट्रांज़िशन को सुनने का तरीका भी बताया गया है.

ध्यान दें: Wear डिवाइसों पर, जियोफ़ेंसिंग एपीआई, बैटरी का बेहतर तरीके से इस्तेमाल नहीं करते. हमारा सुझाव है कि Wear पर इन एपीआई का इस्तेमाल न करें. ज़्यादा जानकारी के लिए, पावर और बैटरी बचाना लेख पढ़ें.

जियोफ़ेंस की निगरानी के लिए सेट अप करना

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

• ACCESS_FINE_LOCATION
• ACCESS_BACKGROUND_LOCATION अगर आपका ऐप्लिकेशन Android 10 (एपीआई लेवल 29) या उसके बाद के वर्शन को टारगेट करता है

ज़्यादा जानने के लिए, जगह की जानकारी की अनुमतियों के लिए अनुरोध करने का तरीका बताने वाली गाइड देखें.

अगर आपको जियोफ़ेंस ट्रांज़िशन को सुनने के लिए BroadcastReceiver का इस्तेमाल करना है, तो सेवा के नाम की जानकारी देने वाला एलिमेंट जोड़ें. यह एलिमेंट, <application> एलिमेंट का चाइल्ड होना चाहिए:

<application
   android:allowBackup="true">
   ...
   <receiver android:name=".GeofenceBroadcastReceiver"/>
<application/>

जगह की जानकारी वाले एपीआई ऐक्सेस करने के लिए, आपको जियोफ़ेंसिंग क्लाइंट का एक इंस्टेंस बनाना होगा. अपने क्लाइंट को कनेक्ट करने का तरीका जानने के लिए:

Kotlin

lateinit var geofencingClient: GeofencingClient

override fun onCreate(savedInstanceState: Bundle?) {
    // ...
    geofencingClient = LocationServices.getGeofencingClient(this)
}

Java

private GeofencingClient geofencingClient;

@Override
public void onCreate(Bundle savedInstanceState) {
    // ...
    geofencingClient = LocationServices.getGeofencingClient(this);
}

जियोफ़ेंस बनाना और जोड़ना

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

ध्यान दें: एक उपयोगकर्ता वाले डिवाइसों पर, हर ऐप्लिकेशन के लिए 100 जियोफ़ेंस सेट की जा सकती हैं. एक से ज़्यादा उपयोगकर्ता वाले डिवाइसों पर, हर उपयोगकर्ता के लिए हर ऐप्लिकेशन के लिए 100 जियोफ़ेंस सेट की जा सकती हैं.

जियोफ़ेंस ऑब्जेक्ट बनाना

सबसे पहले, Geofence.Builder का इस्तेमाल करके जियोफ़ेंस बनाएं. इसके लिए, जियोफ़ेंस के लिए अपनी पसंद के दायरे, अवधि, और ट्रांज़िशन टाइप सेट करें. उदाहरण के लिए, किसी सूची ऑब्जेक्ट को पॉप्युलेट करने के लिए:

Kotlin

geofenceList.add(Geofence.Builder()
        // Set the request ID of the geofence. This is a string to identify this
        // geofence.
        .setRequestId(entry.key)

        // Set the circular region of this geofence.
        .setCircularRegion(
                entry.value.latitude,
                entry.value.longitude,
                Constants.GEOFENCE_RADIUS_IN_METERS
        )

        // Set the expiration duration of the geofence. This geofence gets automatically
        // removed after this period of time.
        .setExpirationDuration(Constants.GEOFENCE_EXPIRATION_IN_MILLISECONDS)

        // Set the transition types of interest. Alerts are only generated for these
        // transition. We track entry and exit transitions in this sample.
        .setTransitionTypes(Geofence.GEOFENCE_TRANSITION_ENTER or Geofence.GEOFENCE_TRANSITION_EXIT)

        // Create the geofence.
        .build())

Java

geofenceList.add(new Geofence.Builder()
    // Set the request ID of the geofence. This is a string to identify this
    // geofence.
    .setRequestId(entry.getKey())

    .setCircularRegion(
            entry.getValue().latitude,
            entry.getValue().longitude,
            Constants.GEOFENCE_RADIUS_IN_METERS
    )
    .setExpirationDuration(Constants.GEOFENCE_EXPIRATION_IN_MILLISECONDS)
    .setTransitionTypes(Geofence.GEOFENCE_TRANSITION_ENTER |
            Geofence.GEOFENCE_TRANSITION_EXIT)
    .build());

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

जियोफ़ेंस और शुरुआती ट्रिगर तय करना

यहां दिया गया स्निपेट, GeofencingRequest क्लास और उसके नेस्ट किए गए GeofencingRequestBuilder क्लास का इस्तेमाल करके, मॉनिटर करने के लिए जियोफ़ेंस तय करता है. साथ ही, यह भी सेट करता है कि जियोफ़ेंस से जुड़े इवेंट कैसे ट्रिगर किए जाते हैं:

Kotlin

private fun getGeofencingRequest(): GeofencingRequest {
    return GeofencingRequest.Builder().apply {
        setInitialTrigger(GeofencingRequest.INITIAL_TRIGGER_ENTER)
        addGeofences(geofenceList)
    }.build()
}

Java

private GeofencingRequest getGeofencingRequest() {
    GeofencingRequest.Builder builder = new GeofencingRequest.Builder();
    builder.setInitialTrigger(GeofencingRequest.INITIAL_TRIGGER_ENTER);
    builder.addGeofences(geofenceList);
    return builder.build();
}

इस उदाहरण में, दो जियोफ़ेंस ट्रिगर का इस्तेमाल दिखाया गया है. जब कोई डिवाइस किसी जियोफ़ेंस में प्रवेश करता है, तो GEOFENCE_TRANSITION_ENTER ट्रांज़िशन ट्रिगर होता है. वहीं, जब कोई डिवाइस किसी जियोफ़ेंस से बाहर निकलता है, तो GEOFENCE_TRANSITION_EXIT ट्रांज़िशन ट्रिगर होता है. INITIAL_TRIGGER_ENTER की वैल्यू तय करने पर, Location services को यह जानकारी मिलती है कि अगर डिवाइस पहले से ही जियोफ़ेंस में है, तो GEOFENCE_TRANSITION_ENTER को ट्रिगर किया जाना चाहिए.

कई मामलों में, INITIAL_TRIGGER_DWELL का इस्तेमाल करना बेहतर हो सकता है. यह सिर्फ़ तब इवेंट ट्रिगर करता है, जब उपयोगकर्ता किसी तय समय के लिए जियोफ़ेंस में रुकता है. इस तरीके से, "सूचना स्पैम" को कम करने में मदद मिल सकती है. यह स्पैम तब होता है, जब कोई डिवाइस कुछ समय के लिए जियोफ़ेंस में जाता है और फिर उससे बाहर निकलता है. अपनी जियोफ़ेंस से सबसे अच्छे नतीजे पाने के लिए, कम से कम 100 मीटर का दायरा सेट करें. इससे, सामान्य वाई-फ़ाई नेटवर्क की जगह की जानकारी को ज़्यादा सटीक बनाने में मदद मिलती है. साथ ही, डिवाइस की बैटरी खर्च होने की दर को कम करने में भी मदद मिलती है.

जियोफ़ेंस ट्रांज़िशन के लिए ब्रॉडकास्ट रिसीवर तय करना

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

यहां दिए गए स्निपेट में, BroadcastReceiver शुरू करने वाले PendingIntent को तय करने का तरीका बताया गया है:

Kotlin

class MainActivity : AppCompatActivity() {

    // ...

    private val geofencePendingIntent: PendingIntent by lazy {
        val intent = Intent(this, GeofenceBroadcastReceiver::class.java)
        // We use FLAG_UPDATE_CURRENT so that we get the same pending intent back when calling
        // addGeofences() and removeGeofences().
        PendingIntent.getBroadcast(this, 0, intent, PendingIntent.FLAG_UPDATE_CURRENT)
    }
}

Java

public class MainActivity extends AppCompatActivity {

    // ...

    private PendingIntent getGeofencePendingIntent() {
        // Reuse the PendingIntent if we already have it.
        if (geofencePendingIntent != null) {
            return geofencePendingIntent;
        }
        Intent intent = new Intent(this, GeofenceBroadcastReceiver.class);
        // We use FLAG_UPDATE_CURRENT so that we get the same pending intent back when
        // calling addGeofences() and removeGeofences().
        geofencePendingIntent = PendingIntent.getBroadcast(this, 0, intent, PendingIntent.
                FLAG_UPDATE_CURRENT);
        return geofencePendingIntent;
    }

जियोफ़ेंस जोड़ना

जियोफ़ेंस जोड़ने के लिए, GeofencingClient.addGeofences() तरीके का इस्तेमाल करें. GeofencingRequest ऑब्जेक्ट और PendingIntent दें. नीचे दिए गए स्निपेट में, नतीजों को प्रोसेस करने का तरीका बताया गया है:

Kotlin

geofencingClient?.addGeofences(getGeofencingRequest(), geofencePendingIntent)?.run {
    addOnSuccessListener {
        // Geofences added
        // ...
    }
    addOnFailureListener {
        // Failed to add geofences
        // ...
    }
}

Java

geofencingClient.addGeofences(getGeofencingRequest(), getGeofencePendingIntent())
        .addOnSuccessListener(this, new OnSuccessListener<Void>() {
            @Override
            public void onSuccess(Void aVoid) {
                // Geofences added
                // ...
            }
        })
        .addOnFailureListener(this, new OnFailureListener() {
            @Override
            public void onFailure(@NonNull Exception e) {
                // Failed to add geofences
                // ...
            }
        });

जियोफ़ेंस के ट्रांज़िशन को हैंडल करना

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

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

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

Kotlin

class GeofenceBroadcastReceiver : BroadcastReceiver() {
    // ...
    override fun onReceive(context: Context?, intent: Intent?) {
        val geofencingEvent = GeofencingEvent.fromIntent(intent)
        if (geofencingEvent.hasError()) {
            val errorMessage = GeofenceStatusCodes
                    .getStatusCodeString(geofencingEvent.errorCode)
            Log.e(TAG, errorMessage)
            return
        }

        // Get the transition type.
        val geofenceTransition = geofencingEvent.geofenceTransition

        // Test that the reported transition was of interest.
        if (geofenceTransition == Geofence.GEOFENCE_TRANSITION_ENTER |
                geofenceTransition == Geofence.GEOFENCE_TRANSITION_EXIT) {

            // Get the geofences that were triggered. A single event can trigger
            // multiple geofences.
            val triggeringGeofences = geofencingEvent.triggeringGeofences

            // Get the transition details as a String.
            val geofenceTransitionDetails = getGeofenceTransitionDetails(
                    this,
                    geofenceTransition,
                    triggeringGeofences
            )

            // Send notification and log the transition details.
            sendNotification(geofenceTransitionDetails)
            Log.i(TAG, geofenceTransitionDetails)
        } else {
            // Log the error.
            Log.e(TAG, getString(R.string.geofence_transition_invalid_type,
                    geofenceTransition))
        }
    }
}

Java

public class GeofenceBroadcastReceiver extends BroadcastReceiver {
    // ...
    protected void onReceive(Context context, Intent intent) {
        GeofencingEvent geofencingEvent = GeofencingEvent.fromIntent(intent);
        if (geofencingEvent.hasError()) {
            String errorMessage = GeofenceStatusCodes
                    .getStatusCodeString(geofencingEvent.getErrorCode());
            Log.e(TAG, errorMessage);
            return;
        }

        // Get the transition type.
        int geofenceTransition = geofencingEvent.getGeofenceTransition();

        // Test that the reported transition was of interest.
        if (geofenceTransition == Geofence.GEOFENCE_TRANSITION_ENTER ||
                geofenceTransition == Geofence.GEOFENCE_TRANSITION_EXIT) {

            // Get the geofences that were triggered. A single event can trigger
            // multiple geofences.
            List<Geofence> triggeringGeofences = geofencingEvent.getTriggeringGeofences();

            // Get the transition details as a String.
            String geofenceTransitionDetails = getGeofenceTransitionDetails(
                    this,
                    geofenceTransition,
                    triggeringGeofences
            );

            // Send notification and log the transition details.
            sendNotification(geofenceTransitionDetails);
            Log.i(TAG, geofenceTransitionDetails);
        } else {
            // Log the error.
            Log.e(TAG, getString(R.string.geofence_transition_invalid_type,
                    geofenceTransition));
        }
    }
}

PendingIntent की मदद से ट्रांज़िशन इवेंट का पता लगाने के बाद, BroadcastReceiver को जियोफ़ेंस ट्रांज़िशन टाइप मिलता है और यह जांच की जाती है कि यह उन इवेंट में से एक है या नहीं जिनका इस्तेमाल ऐप्लिकेशन, सूचनाएं ट्रिगर करने के लिए करता है. इस मामले में, यह जांच की जाती है कि यह इवेंट GEOFENCE_TRANSITION_ENTER या GEOFENCE_TRANSITION_EXIT है. इसके बाद, यह सेवा एक सूचना भेजती है और ट्रांज़िशन की जानकारी को लॉग करती है.

जियोफ़ेंस की निगरानी बंद करना

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

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

Kotlin

geofencingClient?.removeGeofences(geofencePendingIntent)?.run {
    addOnSuccessListener {
        // Geofences removed
        // ...
    }
    addOnFailureListener {
        // Failed to remove geofences
        // ...
    }
}

Java

geofencingClient.removeGeofences(getGeofencePendingIntent())
        .addOnSuccessListener(this, new OnSuccessListener<Void>() {
            @Override
            public void onSuccess(Void aVoid) {
                // Geofences removed
                // ...
            }
        })
        .addOnFailureListener(this, new OnFailureListener() {
            @Override
            public void onFailure(@NonNull Exception e) {
                // Failed to remove geofences
                // ...
            }
        });

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

जियोफ़ेंसिंग के लिए सबसे सही तरीके इस्तेमाल करना

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

बिजली की खपत कम करना

जियोफ़ेंसिंग का इस्तेमाल करने वाले ऐप्लिकेशन में, बैटरी की खपत को ऑप्टिमाइज़ करने के लिए, इन तरीकों का इस्तेमाल किया जा सकता है:

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

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

अपनी जियोफ़ेंस के लिए सबसे सही दायरा चुनना

सबसे अच्छे नतीजे पाने के लिए, जियोफ़ेंस का दायरा कम से कम 100 से 150 मीटर के बीच होना चाहिए. वाई-फ़ाई की सुविधा उपलब्ध होने पर, जगह की सटीक जानकारी आम तौर पर 20 से 50 मीटर के बीच होती है. अगर अंदर की जगह की जानकारी उपलब्ध है, तो जगह की सटीक जानकारी की रेंज 5 मीटर तक हो सकती है. अगर आपको यह नहीं पता है कि जियोफ़ेंस के अंदर इनडोर जगह की जानकारी उपलब्ध है या नहीं, तो मान लें कि वाई-फ़ाई की मदद से जगह की जानकारी 50 मीटर तक सटीक है.

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

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

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

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

सूचना के स्पैम को कम करने के लिए, डवेल ट्रांज़िशन टाइप का इस्तेमाल करना

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

ज़रूरत पड़ने पर ही जियोफ़ेंस को फिर से रजिस्टर करें

रजिस्टर की गई जियोफ़ेंस, com.google.android.gms पैकेज के मालिकाना हक वाली com.google.process.location प्रोसेस में रखी जाती हैं. नीचे दिए गए इवेंट को हैंडल करने के लिए, ऐप्लिकेशन को कुछ करने की ज़रूरत नहीं है, क्योंकि सिस्टम इन इवेंट के बाद, जियोफ़ेंस को वापस ले लेता है:

• Google Play services को अपग्रेड किया गया हो.
• रिसॉर्स की पाबंदी की वजह से, Google Play services को सिस्टम बंद कर देता है और फिर से शुरू कर देता है.
• जगह की जानकारी की प्रोसेस क्रैश हो जाती है.

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

• डिवाइस को फिर से चालू किया गया. ऐप्लिकेशन को डिवाइस के बूट होने की कार्रवाई के लिए सुनना चाहिए. इसके बाद, ज़रूरी जियोफ़ेंस को फिर से रजिस्टर करना चाहिए.
• ऐप्लिकेशन को अनइंस्टॉल करके, फिर से इंस्टॉल किया जाता है.
• ऐप्लिकेशन का डेटा मिट जाता है.
• Google Play services का डेटा मिट जाता है.
• ऐप्लिकेशन को GEOFENCE_NOT_AVAILABLE चेतावनी मिली है. आम तौर पर, ऐसा एनएलपी (Android का नेटवर्क लोकेशन प्रोवाइडर) बंद होने के बाद होता है.

जियोफ़ेंस के दायरे में आने के इवेंट से जुड़ी समस्या हल करना

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

सूचनाएं उम्मीद के मुताबिक काम न करने की कुछ वजहें यहां दी गई हैं:

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

• डिवाइस पर वाई-फ़ाई बंद है. वाई-फ़ाई चालू होने पर, जगह की जानकारी को ज़्यादा सटीक बनाया जा सकता है. इसलिए, अगर वाई-फ़ाई बंद है, तो हो सकता है कि आपके ऐप्लिकेशन को कभी भी जियोफ़ेंस से जुड़ी चेतावनियां न मिलें. यह कई सेटिंग पर निर्भर करता है. जैसे, जियोफ़ेंस की त्रिज्या, डिवाइस मॉडल या Android वर्शन. हमने Android 4.3 (एपीआई लेवल 18) से, “सिर्फ़ वाई-फ़ाई स्कैन मोड” की सुविधा जोड़ी है. इसकी मदद से, उपयोगकर्ता वाई-फ़ाई बंद करके भी नेटवर्क की जगह की जानकारी को बेहतर तरीके से ऐक्सेस कर सकते हैं. अगर वाई-फ़ाई और सिर्फ़ वाई-फ़ाई स्कैन मोड, दोनों बंद हैं, तो उपयोगकर्ता को इसके बारे में बताना और उसे शॉर्टकट देना अच्छा होता है. SettingsClient का इस्तेमाल करके, पक्का करें कि डिवाइस की सिस्टम सेटिंग, जगह की जानकारी का बेहतर तरीके से पता लगाने के लिए सही तरीके से कॉन्फ़िगर की गई हों.

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

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

अन्य संसाधन

जियोफ़ेंसिंग के बारे में ज़्यादा जानने के लिए, नीचे दिया गया कॉन्टेंट देखें:

सैंपल

जियोफ़ेंस बनाने और उनकी निगरानी करने के लिए, सैंपल ऐप्लिकेशन.