Advertisement
  1. Code
  2. Android

Cómo trabajar con geofences en Android

by
Difficulty:IntermediateLength:LongLanguages:

Spanish (Español) translation by Elías Nicolás (you can also view the original English article)

Los recursos conscientes de la ubicación permiten que su aplicación interactúe con el mundo físico y son ideales para aumentar la participación del usuario. Aunque muchas aplicaciones móviles las usan, el tema de este tutorial es una característica que a menudo se pasa por alto, el geofencing.

Un geofence es un perímetro virtual establecido en un área geográfica real. Combinando la posición de un usuario con un perímetro de geofence, es posible saber si el usuario está dentro o fuera del geofence o incluso si está saliendo o ingresando al área.

A geofence knows if a location is inside or outside its delimited area

Imagine una aplicación universitaria que le puede decir qué colegas y profesores están actualmente en el campus. O una aplicación para un centro comercial que recompensa a los clientes habituales. Hay muchas otras posibilidades interesantes que puedes explorar.

En este tutorial, aprenderá a usar geofences en Android creando una aplicación que muestre al usuario una notificación cuando ingrese o salga de un geofence. Es útil si tiene conocimientos previos de Google Play Services, Google Maps Android API o IntentService. Si no lo hace, entonces puede seguir adelante, pero es posible que desee hacer una investigación sobre estos temas después de leer este tutorial.

1. Geofences en Android

En Android, hay varias formas de trabajar con geofences. Incluso podría crear su propia implementación para trabajar con geofences, pero es más fácil usar GeofencingApi de Google.

Estas API son parte de las API Location de Google. Incluye Geofence, GeofencingRequest, GeofenceApi, GeofencingEvent, y GeofenceStatusCodes. En este tutorial, usamos estas clases para crear y trabajar con geofences.

Interfaz Geofence

Geofence es una interfaz que representa un área geográfica que debe ser monitoreada. Se crea utilizando el Geofence.Builder. Durante su creación, establece la región supervisada, la fecha de caducidad del geofence, la capacidad de respuesta, un identificador y el tipo de transiciones que debe buscar.

Para mantener el consumo de energía al mínimo, se recomienda utilizar un geofence con un radio de al menos 100 metros para la mayoría de las situaciones. Si las geofences están ubicadas en el campo, debe aumentar el radio a 500 metros o más para asegurarse de que las geofences sean efectivas.

Transiciones geofence

  • GEOFENCE_TRANSITION_DWELL indica que el usuario ingresó al área y pasó algún tiempo allí. Es útil evitar múltiples alertas cuando el usuario ingresa y sale del área demasiado rápido. Puede configurar el tiempo de permanencia usando el parámetro setLoiteringDelay.
  • GEOFENCE_TRANSITION_ENTER indica cuando el usuario ingresa a la región monitoreada.    
  • GEOFENCE_TRANSITION_EXIT indica cuando el usuario sale de la región.

GeofenceRequest

GeofencingRequest recibe las geofences que deben ser monitoreadas. Puede crear una instancia utilizando un Builder, pasando un Geofence o una List<Geofence>, y el tipo de notificación que se activará cuando se crean los geofence(s).

GeofencingApi

La clase GeofencingApi es el punto de entrada para todas las interacciones con la API de geofencing de Google. Es parte de las API Location y depende de un GoogleApiClient para que funcione. Utilizará GeofencingApi para agregar y eliminar geofences.

Para agregar un geofence, llame al método addGeofence(). Supervisa el área dada utilizando la configuración pasada a GeofencingRequest y dispara un PendingIntent cuando se produce una transición de geofence, entrando o saliendo del área.

Para eliminar el geofence, llame a removeGeofences(). Puede eliminar el geofence usando su identificador de solicitud o su intento pendiente.

2. Creando una aplicación de geofencing

En este tutorial, creamos una aplicación simple que supervisa la ubicación del usuario y publica una notificación cuando el usuario ingresa o sale de un área geofence. La aplicación consta de una sola Activity y un IntentService. También echamos un vistazo rápido a GoogleMap, GoogleApiClient, y FusedLocationProviderApi, y exploramos algunas advertencias de la API de geofence.

App Screenshot

Paso 1: Configuración del proyecto

GeofencingApi es parte de Google Play Services. Para acceder a él, debe configurar correctamente su entorno de desarrollo y crear una instancia de GoogleApiClient. Cree un nuevo proyecto con una Activity, en blanco, edite el archivo build.gradle del proyecto como se muestra a continuación y sincronice su proyecto.

Paso 2: Permisos

Necesitamos establecer los permisos correctos para crear y usar geofences. Agregue el siguiente permiso al manifiesto del proyecto:

A partir de Android 6.0, la aplicación solicita permiso en tiempo de ejecución y no durante la instalación. Abordaremos esto más adelante en el tutorial.

Paso 3: Crear el diseño

El proyecto consta de un diseño, el diseño MainActity. Contiene la latitud y longitud actuales del dispositivo, y un fragmento de GoogleMap que muestra las geofences y la posición del usuario.

Dado que activity_main.xml es bastante sencillo, quiero concentrarme solo en el elemento MapFragment. Puede ver el diseño completado en los archivos de origen de este tutorial.

Paso 4: Clave API de Google Maps

Como estamos usando un MapFragment, necesitamos configurar e inicializar una instancia de GoogleMap. Primero, necesitas obtener una clave API. Una vez que tenga una clave API, agréguela al manifiesto del proyecto.

Vamos a empezar con la instancia de GoogleMap. Implemente GoogleMap.OnMapReadyCallback, GoogleMap.OnMapClickListener, y GoogleMap.OnMarkerClickListener en la clase  Activity e inicialice el mapa.

Paso 5: GoogleApiClient

Para utilizar la interfaz GeofencingApi, necesitamos un punto de entrada GoogleApiClient. Implementemos un GoogleApiClient.ConnectionCallbacks y un GoogleApiClient.OnConnectionFailedListener en Activity como se muestra a continuación.

Paso 6: FusedLocationProviderApi

También necesitamos acceder a la ubicación actual del usuario. La interfaz FusedLocationProviderApi nos proporciona esta información y permite un gran nivel de control de la solicitud de ubicación. Esto es muy importante, ya que las solicitudes de ubicación tienen un efecto directo sobre el consumo de la batería del dispositivo.

Ahora, implementemos un LocationListener. Verifique si el usuario le dio a la aplicación los permisos apropiados creando la solicitud Location y muestre su ubicación actual en la pantalla.

Es importante tener en cuenta que el LocationRequest creado anteriormente no está optimizado para un entorno de producción. El UPDATE_INTERVAL es demasiado corto y consumiría demasiada energía de la batería. Una configuración más realista para la producción podría ser:

Paso 7: Marcadores GoogleMap

Nuestra Activity necesita dos marcadores diferentes. Un locationMarker usa la latitud y longitud que proporciona FusedLocationProviderApi  para informar la ubicación actual del dispositivo. Un geoFenceMarker es el objetivo para la creación de geofence ya que usa el último toque dado en el mapa para recuperar su posición.

Paso 8: Creando un Geofence

Por fin, es hora de crear un geofence. Usamos el geoFenceMarker como el punto central para el geofence.

A continuación, creamos el objeto GeofencingRequest.

Utilizamos un objeto PendingIntent para llamar a un IntentServiceque manejará GeofenceEvent. Creamos el GeofenceTrasitionService.class más tarde.

También dibujamos la geofence en el mapa como referencia visual.

El método startGeofence() es responsable de iniciar el proceso de geofencing en la clase MainActivity.

Paso 9: Servicio de transición Geofence

Ahora podemos finalmente crear el GeofenceTrasitionService.class mencionado anteriormente. Esta clase extiende IntentService y es responsable de manejar GeofencingEvent. Primero, obtenemos este evento de la intención recibida.

Luego verificamos si el tipo de transición de geofencing que tuvo lugar nos interesa. Si es así, recuperamos una lista de las geofences activadas y creamos una notificación con las acciones apropiadas.

También he implementado algunos métodos de ayuda para hacer que la implementación de la clase sea más fácil de entender.

3. Pruebas

Pruebas en un dispositivo virtual

Es mucho más sencillo probar el geofencing en un dispositivo virtual. Hay varias formas de hacerlo. En Android Studio, abra un dispositivo virtual y haga clic en el botón más opciones en la parte inferior derecha.

Click on More Options

En la pestaña Location a la izquierda, ingrese las coordenadas para la ubicación.

Send Latitude and Longitude

Prefiero usar los comandos telnet para controlar el dispositivo virtual. Para usar esto, necesita conectarse al dispositivo desde la línea de comandos usando el siguiente comando:

El puerto del dispositivo se muestra en la ventana del dispositivo virtual. El puerto del dispositivo suele ser igual a 5554.

Es posible que necesite autorizar esta conexión utilizando su auth_token, pero la línea de comandos le muestra dónde se encuentra. Vaya a esa ubicación y copie el token y el tipo, auth [TU_TOKEN].

Ahora puede establecer la ubicación del dispositivo ejecutando el siguiente comando:

Conclusión

Geofencing puede ser una gran adición a su aplicación, ya que puede aumentar considerablemente la participación del usuario. Hay muchas posibilidades para explorar e incluso podría crear una experiencia sofisticada utilizando balizas interiores, como el Estimote. Con balizas interiores, usted sabe exactamente dónde ha pasado el usuario, por ejemplo, un centro comercial.

Agregar Geofencing a un proyecto es simple, pero debemos tener en cuenta el consumo de energía en todo momento. Esto significa que debemos elegir cuidadosamente el tamaño de la geofence y la tasa de actualización porque ambos afectan directamente el consumo de energía de su aplicación.

Por lo tanto, las pruebas son muy importantes para tener una idea realista del consumo de energía de su aplicación. También considere darles a los usuarios la opción de desactivar el geofencing por completo si no quieren o necesitan esta función.

Advertisement
Advertisement
Advertisement
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.