Google API ऐक्सेस करें

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

शुरू करें

शुरू करने से पहले, पक्का करें कि आपने अपने ऐप्लिकेशन प्रोजेक्ट में Google Play services सेट अप की हों.

ऐसी सेवा को ऐक्सेस करने के लिए जिसके लिए अनुमति की ज़रूरत नहीं होती, सेवा के क्लाइंट ऑब्जेक्ट का इंस्टेंस बनाएं. इसके लिए, Context या एक Activity ऑब्जेक्ट पास करें. ज़रूरत पड़ने पर, एपीआई कॉल करने से पहले, उपयोगकर्ताओं को Google Play services अपग्रेड करने के लिए कहा जाता है.

यहां दिए गए कोड स्निपेट में, Fused Location Provider का इस्तेमाल करके, डिवाइस की आखिरी बार की जगह की जानकारी पाने का तरीका बताया गया है:

Kotlin

// Code required for requesting location permissions omitted for brevity.
val client = LocationServices.getFusedLocationProviderClient(this)

// Get the last known location. In some rare situations, this can be null.
client.lastLocation.addOnSuccessListener { location : Location? ->
    location?.let {
        // Logic to handle location object.
    }
}

Java

// Code required for requesting location permissions omitted for brevity.
FusedLocationProviderClient client =
        LocationServices.getFusedLocationProviderClient(this);

// Get the last known location. In some rare situations, this can be null.
client.getLastLocation()
        .addOnSuccessListener(this, location -> {
            if (location != null) {
                // Logic to handle location object.
            }
        });

उपयोगकर्ता की अनुमति के बिना ऐक्सेस न किए जा सकने वाले एपीआई को ऐक्सेस करने के लिए, Google के उपयोगकर्ता डेटा को ऐक्सेस करने की अनुमति देने से जुड़ी गाइडलाइन का पालन करें. अगर ऐसे एपीआई का इस्तेमाल किया जा रहा है जिसके लिए GoogleSignInAccount ऑब्जेक्ट की ज़रूरत होती है, तो AuthorizationResult#toGoogleSignInAccount() तरीके का इस्तेमाल करें.

देखें कि एपीआई उपलब्ध है या नहीं

Google Play services के एपीआई पर निर्भर रहने वाली किसी सुविधा को चालू करने से पहले, यह देखें कि एपीआई डिवाइस पर उपलब्ध है या नहीं. इसके लिए, checkApiAvailability() को कॉल करें.

यहां दिए गए कोड स्निपेट में, यह देखने का तरीका बताया गया है कि Fused Location Provider उपलब्ध है या नहीं:

Kotlin

fun getLastLocationIfApiAvailable(context: Context?): Task<Location>? {
    val client = getFusedLocationProviderClient(context)
    return GoogleApiAvailability.getInstance()
        .checkApiAvailability(client)
        .onSuccessTask { _ -> client.lastLocation }
        .addOnFailureListener { _ -> Log.d(TAG, "Location unavailable.")}
}

Java

public Task<Location> getLastLocationIfApiAvailable(Context context) {
    FusedLocationProviderClient client =
            getFusedLocationProviderClient(context);
    return GoogleApiAvailability.getInstance()
            .checkApiAvailability(client)
            .onSuccessTask(unused -> client.getLastLocation())
            .addOnFailureListener(e -> Log.d(TAG, "Location unavailable."));
}