Ubicación aproximada

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

1. Introducción

En Android 12 (nivel de API 31) y versiones posteriores, los usuarios cuentan con la opción de controlar la precisión de la ubicación que desean otorgar a sus apps. En versiones anteriores de Android, la precisión de la ubicación se controla, de manera implícita, mediante la app que solicita el permiso ACCESS_FINE_LOCATION o el permiso ACCESS_COARSE_LOCATION.

En este codelab, te brindaremos orientación y prácticas recomendadas para las apps cuya versión del SDK de destino es 31 o superior a fin de solicitar permisos de ubicación.

Requisitos previos

Qué aprenderás

  • Cómo solicitar permisos de ubicación en Android S
  • Cómo implementar un flujo óptimo de solicitudes de ubicación, para que los usuarios puedan otorgar a tu app permisos de ubicación precisa

Condiciones

Ubicación precisa: el nivel de detalle de la ubicación para el permiso ACCESS_FINE_LOCATION.

Ubicación aproximada: el nivel de detalle de la ubicación para el permiso ACCESS_COARSE_LOCATION.

APIs que se tratarán

2. Cómo solicitar el permiso ACCESS_FINE_LOCATION

Flujo de IU nueva

Primero, observemos la IU nueva para obtener algunas ideas de los cambios en la precisión de la ubicación.

A continuación, en la Figura 1a y la Figura 1b, se muestra el diálogo de permisos que aparece cuando no se le otorgó a tu app el permiso ACCESS_FINE_LOCATION ni el permiso ACCESS_COARSE_LOCATION.

7acc5e2fe09d67ca.jpeg a5e9363364fcc9f9.jpeg

Figura 1a: Se seleccionó la ubicación precisa Figura 1b: Se seleccionó la ubicación aproximada

A continuación, en la Figura 2a, se muestra el diálogo de actualización del permiso que aparece cuando se le otorgó a tu app el permiso ACCESS_COARSE_LOCATION mientras está en uso. Este diálogo aparece si el usuario selecciona "Cuando se use la app" para la ubicación aproximada en la pantalla anterior (que se muestra en la Figura 1b).

2624d89993700ea5.jpeg

Figura 2a

A continuación, en la Figura 2b, se muestra el diálogo de actualización del permiso que aparece cuando se le otorgó a tu app el permiso ACCESS_COARSE_LOCATION solo para la sesión actual. Este diálogo aparece si el usuario selecciona "Solo esta vez" en la pantalla anterior (se muestra en la Figura 1b).

a2dfb923b8f3548d.jpeg

Figura 2b

3. Implementación del código

Cómo declarar permisos de ubicación en el manifiesto de tu app

Para solicitar ACCESS_FINE_LOCATION, el sistema exigirá que tu app declare ACCESS_FINE_LOCATION y ACCESS_COARSE_LOCATION en el manifiesto de tu app. De lo contrario, el sistema ignorará la solicitud y no le otorgará a tu app ninguno de los dos permisos.

<manifest ... >
  <!-- Required when requesting precise location access on Android 12 (API level 31) and higher. -->
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
  <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
</manifest>

Cómo solicitar el permiso ACCESS_FINE_LOCATION

MyActivity.kt (Kotlin)

when {
    ContextCompat.checkSelfPermission(
            CONTEXT,
            Manifest.permission.ACCESS_FINE_LOCATION
            ) == PackageManager.PERMISSION_GRANTED -> {
        // You can use the API that requires the permission.
        performAction(...)
    }
    shouldShowRequestPermissionRationale(...) -> {
        // In an educational UI, explain to the user why your app requires this
        // permission for a specific feature to behave as expected. In this UI,
        // include a "cancel" or "no thanks" button that allows the user to
        // continue using your app without granting the permission.
        showInContextUI(...)
    }
    else -> {
        // Ask for both the ACCESS_FINE_LOCATION and ACCESS_COARSE_LOCATION permissions.
        requestPermissions(CONTEXT,
                arrayOf(Manifest.permission.ACCESS_FINE_LOCATION,
                        Manifest.permission.ACCESS_COARSE_LOCATION),
                REQUEST_CODE)
    }
}

MyActivity.java (Java)

if (ContextCompat.checkSelfPermission(
        CONTEXT, Manifest.permission.ACCESS_FINE_LOCATION) ==
        PackageManager.PERMISSION_GRANTED) {
    // You can use the API that requires the permission.
    performAction(...);
} else if (shouldShowRequestPermissionRationale(...)) {
    // In an educational UI, explain to the user why your app requires this
    // permission for a specific feature to behave as expected. In this UI,
    // include a "cancel" or "no thanks" button that allows the user to
    // continue using your app without granting the permission.
    showInContextUI(...);
} else {
    // Ask for both the ACCESS_FINE_LOCATION and ACCESS_COARSE_LOCATION permissions.
    requestPermissions(CONTEXT,
            new String[] { Manifest.permission.ACCESS_FINE_LOCATION,
                           Manifest.permission.ACCESS_COARSE_LOCATION },
            REQUEST_CODE);
}

Cómo controlar la respuesta

MyActivity.kt (Kotlin)

override fun onRequestPermissionsResult(requestCode: Int,
        permissions: Array<String>, grantResults: IntArray) {
    when (requestCode) {
        REQUEST_CODE -> {
            // If the request is cancelled, the result arrays are empty.
            if (grantResults.isNotEmpty()) {
                if (grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                    // ACCESS_FINE_LOCATION is granted
                } else if (grantResults[1] ==
                               PackageManager.PERMISSION_GRANTED) {
                    // ACCESS_COARSE_LOCATION is granted
                }
            } else {
                // Explain to the user that the feature is unavailable because
                // the feature requires a permission that the user has denied.
                // At the same time, respect the user's decision. Don't link to
                // system settings in an effort to convince the user to change
                // their decision.
            }
            return
        }

        // Add other 'when' lines to check for other
        // permissions this app might request.
        else -> {
            // Ignore all other requests.
        }
    }
}

MyActivity.java (Java)

@Override
public void onRequestPermissionsResult(int requestCode, String[] permissions,
        int[] grantResults) {
    switch (requestCode) {
        case PERMISSION_REQUEST_CODE:
            // If the request is cancelled, the result arrays are empty.
            if (grantResults.length > 0) {
                if (grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                    // ACCESS_FINE_LOCATION is granted
                } else if (grantResults[1] ==
                               PackageManager.PERMISSION_GRANTED) {
                    // ACCESS_COARSE_LOCATION is granted
                }
            } else {
                // Explain to the user that the feature is unavailable because
                // the feature requires a permission that the user has denied.
                // At the same time, respect the user's decision. Don't link to
                // system settings in an effort to convince the user to change
                // their decision.
            }
            return;
        }
        // Other 'case' lines to check for other
        // permissions this app might request.
    }
}

4. Cómo solicitar solo el permiso ACCESS_COARSE_LOCATION

En la Figura 4, se muestra el diálogo del permiso que aparece cuando tu app solicita solo el permiso ACCESS_COARSE_LOCATION.

9d20729f14673547.jpeg

Figura 4

Para funcionar solo con el permiso de ubicación aproximada, la app debe declarar y controlar solo el permiso de ubicación aproximada en cada paso.

5. Configuración de la ubicación

A continuación, en la Figura 5, se muestra la configuración nueva del permiso de ubicación. Se muestra un botón nuevo de activación para que los usuarios puedan controlar si la app puede acceder a una ubicación precisa o aproximada.

a9553249c3e2b90c.jpeg

Figura 5

6. Apps que se orientan a SDK versión 30 o anterior

Las opciones nuevas de precisión de la ubicación (precisa/aproximada) no se ven en las app que se orientan a SDK versión 30 o anterior.

7. ¡Felicitaciones!

Aprendiste a solicitar permisos de ubicación en Android 12 y exploraste con éxito muchos componentes clave de los permisos de ubicación.

Ahora, puedes solicitar permisos de ubicación para casos diferentes de uso a fin de satisfacer las necesidades de tu app.

Averigua más sobre la ubicación: