Geofence Android demo (#2491)

Author: flasher297

app/permission.json

@@ -1,9 +1,11 @@
 [
+    "android.permission.ACCESS_BACKGROUND_LOCATION",
     "android.permission.ACCESS_COARSE_LOCATION",
     "android.permission.ACCESS_FINE_LOCATION",
     "android.permission.ACCESS_NETWORK_STATE",
     "android.permission.ACCESS_WIFI_STATE",
     "android.permission.INTERNET",
+    "android.permission.POST_NOTIFICATIONS",
     "android.permission.REORDER_TASKS",
     "com.mapbox.maps.testapp.DYNAMIC_RECEIVER_NOT_EXPORTED_PERMISSION"
 ]

app/src/main/AndroidManifest.xml

@@ -4,6 +4,8 @@
 
     <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
     <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
+    <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
+    <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
 
     <application
         android:name=".MapboxApplication"
@@ -400,6 +402,19 @@
                 android:name="android.support.PARENT_ACTIVITY"
                 android:value=".ExampleOverviewActivity" />
         </activity>
+        <activity
+            android:name=".examples.geofence.GeofencingActivity"
+            android:description="@string/description_geofencing"
+            android:exported="true"
+            android:label="@string/activity_geofencing"
+            android:launchMode="singleTask">
+            <meta-data
+                android:name="@string/category"
+                android:value="@string/category_location" />
+            <meta-data
+                android:name="android.support.PARENT_ACTIVITY"
+                android:value=".ExampleOverviewActivity" />
+        </activity>
         <activity
             android:name=".examples.camera.RestrictBoundsActivity"
             android:description="@string/description_restrict_bounds"

app/src/main/java/com/mapbox/maps/testapp/MapboxApplication.kt

@@ -2,15 +2,64 @@ package com.mapbox.maps.testapp
 
 import android.os.StrictMode
 import androidx.multidex.MultiDexApplication
+import com.mapbox.android.core.permissions.PermissionsManager
+import com.mapbox.common.experimental.geofencing.GeofencingError
+import com.mapbox.common.experimental.geofencing.GeofencingEvent
+import com.mapbox.common.experimental.geofencing.GeofencingFactory
+import com.mapbox.common.experimental.geofencing.GeofencingObserver
+import com.mapbox.maps.logD
+import com.mapbox.maps.logW
+import com.mapbox.maps.testapp.examples.geofence.GeofencingActivity
 
 /**
  * Application class of the test application.
  **/
 class MapboxApplication : MultiDexApplication() {
 
+  private val geofencingObserver: GeofencingObserver = object : GeofencingObserver {
+
+    override fun onEntry(event: GeofencingEvent) {
+      GeofencingActivity.showNotification(
+        this@MapboxApplication,
+        "Entry into feature id = ${event.feature.id()} at ${event.timestamp}",
+        event.feature.id(),
+        GeofencingActivity.NOTIFICATION_FEATURE_ENTRY
+      )
+    }
+
+    override fun onExit(event: GeofencingEvent) {
+      GeofencingActivity.showNotification(
+        this@MapboxApplication,
+        "Exit from feature id = ${event.feature.id()} at ${event.timestamp}",
+        event.feature.id(),
+        GeofencingActivity.NOTIFICATION_FEATURE_EXIT
+      )
+    }
+
+    override fun onDwell(event: GeofencingEvent) {
+      GeofencingActivity.showNotification(
+        this@MapboxApplication,
+        "Dwell into feature id = ${event.feature.id()} at ${event.timestamp}",
+        event.feature.id(),
+        GeofencingActivity.NOTIFICATION_FEATURE_DWELL
+      )
+    }
+
+    override fun onError(error: GeofencingError) {
+      logD("MapboxApplication", "onError() called with: error = $error")
+    }
+  }
+
+  // TODO: temporary workaround to avoid double adding of listener if we don't
+  // have location permissions on the start of the app
+  private var isObserverAdded: Boolean = false
+
   override fun onCreate() {
     super.onCreate()
     initializeStrictMode()
+    if (ENABLE_BACKGROUND_GEOFENCING) {
+      registerGeofencingObserver()
+    }
   }
 
   private fun initializeStrictMode() {
@@ -27,4 +76,25 @@ class MapboxApplication : MultiDexApplication() {
         .build()
     )
   }
+
+  fun registerGeofencingObserver() {
+    if (PermissionsManager.areLocationPermissionsGranted(this) && !isObserverAdded) {
+      val geofencing = GeofencingFactory.getOrCreate()
+      geofencing.addObserver(geofencingObserver) { it ->
+        it.error?.let {
+          logW("MapboxApplication", "Failed to registerGeofencingObserver: ${it.message}")
+        }
+      }
+      isObserverAdded = true
+    }
+  }
+
+  companion object {
+
+    /**
+     * Flag to showcase background behavior of the geofence engine. When enabled, notifications will
+     * be created for the different geofencing events.
+     */
+    const val ENABLE_BACKGROUND_GEOFENCING = true
+  }
 }