Accede a las API de Google

Para acceder a las APIs potenciadas por los Servicios de Google Play en tu app para Android, debes usar objetos de clientes de la API. Estos objetos controlan la conexión a los Servicios de Google Play, ponen en cola las solicitudes y las ejecutan en orden cuando hay una conexión disponible. Puedes crear clientes de API nuevos según sea necesario, ya que no son costosos de construir.

Comenzar

Antes de comenzar, asegúrate de configurar los Servicios de Google Play en el proyecto de tu app.

Advertencia: Las APIs que usan GoogleApiClient están obsoletas. Si aún usas GoogleApiClient, migra a las APIs basadas en GoogleApi correspondientes actualizando a las versiones del SDK disponibles más recientes.

Para acceder a un servicio que no requiere autorización, crea una instancia del objeto cliente del servicio y pasa un objeto Context o un objeto Activity. Si es necesario, se les solicita a los usuarios que actualicen los Servicios de Google Play antes de que se ejecute cualquier llamada a la API.

En el siguiente fragmento de código, se muestra cómo obtener la última ubicación conocida del dispositivo con el 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.
            }
        });

Para acceder a las APIs que requieren autorización del usuario, sigue la guía para autorizar el acceso a los datos del usuario de Google. Si usas una API que requiere un objeto GoogleSignInAccount, usa el método AuthorizationResult#toGoogleSignInAccount().

Comprueba la disponibilidad de la API

Antes de habilitar una función que depende de una API de los Servicios de Google Play, llama a checkApiAvailability() para verificar si la API está disponible en el dispositivo.

Nota: Esta verificación solo es necesaria si necesitas inhabilitar una función cuando una API no está disponible. También puedes llamar a los métodos de la API sin esta verificación, ya que fallarán si la API no está disponible.

En el siguiente fragmento de código, se muestra cómo verificar si el proveedor de ubicación fusionada está disponible:

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."));
}