Cómo migrar a las API de ubicación y contexto

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

Google recomienda utilizar las API de ubicación y contexto de los Servicios de Google Play en apps que requieren servicios de ubicación. Si tu app utiliza las API de ubicación del framework, es importante realizar la migración a los Servicios de Google Play para aprovechar las funciones más recientes de Google.

El uso de los Servicios de Google Play es la opción preferida para obtener servicios de ubicación en tu app por las siguientes razones:

  1. Los Servicios de Google Play proporcionan una interfaz simple y una superficie de API más limpia.
  2. Debes especificar una calidad de servicio deseada y las API administrarán las tecnologías subyacentes por ti.
  3. Las API de los Servicios de Google Play tienen un rendimiento y un uso de batería optimizados.
  4. Las API de los Servicios de Google Play se mantienen de forma activa. Google mejora los algoritmos y agrega más funciones de manera constante.

Actualiza tu app

En los siguientes pasos, se describe el proceso para actualizar una app y usar las API de ubicación y contexto:

  1. Configura los Servicios de Google Play en tu proyecto.
  2. Actualiza la app a fin de usar la API de configuración de ubicación para validar la configuración de la ubicación actual.
  3. Reemplaza la lógica personalizada que se usa para tareas complejas, como identificar si un usuario está cerca de un área o intentar adivinar qué está haciendo el usuario, por las API generales, como la API de geovallado o la API de reconocimiento de actividad.
  4. Reemplaza el uso de la API de ubicación del framework por la API del proveedor de ubicación combinada.
  5. Quita las referencias a la API de ubicación del framework.

Configura los Servicios de Google Play en tu proyecto

Si quieres que las API de ubicación y contexto estén disponibles para tu proyecto, debes agregar una referencia al repositorio de Maven de Google y declarar una dependencia a las API requeridas. Para obtener más información, consulta Cómo configurar los Servicios de Google Play.

Usa la API de configuración de ubicación

Cuando se utiliza la API de configuración de ubicación, las apps proporcionan el nivel de QoS deseado y la API solicita al usuario los cambios apropiados en la configuración del sistema. Sigue estos pasos para usar la API de configuración de la ubicación en tu app:

  1. Solicita permisos de ubicación en el manifiesto de la app.
  2. Configura un objeto LocationRequest, que especifica el nivel de QoS deseado.
  3. Usa la API de configuración de la ubicación para comprobar la configuración actual.

Si quieres obtener más información, consulta Cómo cambiar la configuración de la ubicación o las muestras de ubicación de Google Play para ver código de ejemplo.

Reemplaza la lógica personalizada con API generales

Las API generales, como la API de geovallado y la API de reconocimiento de actividad, proporcionan funciones que tu app puede usar para ofrecer experiencias increíbles. Sin embargo, estas funciones requieren una lógica compleja que puede ser difícil de codificar y mantener. Si tu app tiene esa lógica personalizada, debes reemplazarla con componentes que aprovechen las API generales.

Para obtener detalles sobre la implementación, consulta las guías de la API de ubicación y contexto específica.

Reemplaza la API de ubicación del framework con la API del proveedor de ubicación combinada

Puedes usar la API del proveedor de ubicación combinada para obtener datos de ubicación, como la latitud y la longitud. La API del proveedor de ubicación combinada usa un objeto Location, al igual que la API del framework de ubicación, para representar la ubicación geográfica. La API proporciona funciones para detectar las actualizaciones de ubicación y obtener la ubicación más reciente. Por todas estas funciones, se puede utilizar la API del proveedor de ubicación combinada para reemplazar los componentes que usan la API de ubicación del framework con solo realizar unos pocos cambios en el resto de la app.

Obtener la ubicación más reciente es un buen punto de partida para muchas experiencias porque es una operación rápida que utiliza datos de ubicación solicitados por cualquier cliente en el dispositivo. A fin de realizar un seguimiento periódico de la ubicación, tu app puede suscribirse para recibir actualizaciones de ubicación, lo que proporciona datos actualizados y permite experiencias más complejas.

Quita las referencias a la API de ubicación del framework

Reemplaza las referencias a clases en el paquete com.google.android.location por clases desde el paquete com.google.android.gms.location, excepto las referencias a la clase Location, que utiliza la API del proveedor de ubicación combinada. Por lo general, puedes quitar los componentes que administran los distintos proveedores, como GPS y Wi-Fi, desde tu app. Las API de ubicación y contexto administran automáticamente estos proveedores.

Prueba tu app

Para ejecutar una app que utiliza la versión más reciente de los Servicios de Google Play, necesitas un dispositivo que tenga instalada la app de Play Store y una cuenta de Google. Para fines relacionados con el desarrollo, puedes utilizar las siguientes opciones:

  • Un dispositivo físico conectado al entorno de desarrollo mediante un cable USB
  • Un emulador con la app de Play Store instalada

Para obtener más información sobre cómo conectar un dispositivo físico a tu entorno de desarrollo, consulta Cómo ejecutar apps en un dispositivo de hardware. Si quieres crear un emulador que incluya la app de Play Store, consulta Cómo crear y administrar dispositivos virtuales.