Accede a las API de Google

Para acceder a las APIs con tecnología de los Servicios de Google Play en tu app para Android, debes usar objetos de cliente de 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 su construcción no es costosa.

Comenzar

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

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

Para acceder a un servicio que no requiere autorización, crea una instancia del objeto de cliente del servicio y pasa un objeto Context o Activity. Si es necesario, se les solicita a los usuarios que actualicen los Servicios de Google Play antes de que se ejecuten las llamadas 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 de los usuarios de Google. Si usas una API que requiere un objeto GoogleSignInAccount, usa el método AuthorizationResult#toGoogleSignInAccount().

Verifica la disponibilidad de la API

Antes de habilitar una función que dependa 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 combinada 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."));
}