Accede a las API de Google

Para acceder a las APIs que funcionan con 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 la 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 correspondientes GoogleApi-basadas actualizando a las versiones más recientes del SDK disponibles.

Para acceder a un servicio que no requiere autorización, crea una instancia de el objeto cliente del servicio y pasa un Context o un Activity objeto. Si es necesario, se les pedirá 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 proveedor de ubicación combinada:

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 usuario de Google. Si usas una API que requiere un objeto GoogleSignInAccount, usa el AuthorizationResult#toGoogleSignInAccount() método.

Verifica la disponibilidad de la API

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

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