Update docs, SampleApp with new features

README.md

@@ -89,7 +89,7 @@ function onDeviceReady() {
 
     // BackgroundGeoLocation is highly configurable.
     bgGeo.configure(callbackFn, failureFn, {
-        debug: true, // <-- enable this hear sounds for background-geolocation life-cycle.
+        // Geolocation config
         desiredAccuracy: 0,
         stationaryRadius: 50,
         distanceFilter: 50,
@@ -99,15 +99,19 @@ function onDeviceReady() {
         fastestLocationUpdateInterval: 5000,
         activityRecognitionInterval: 10000,
         stopTimeout: 0,
-        forceReload: true,      // <-- [Android] If the user closes the app **while location-tracking is started** , reboot app (WARNING: possibly distruptive to user) 
+        activityType: 'AutomotiveNavigation',
+
+        // Application config
+        debug: true, // <-- enable this hear sounds for background-geolocation life-cycle.
+        forceReloadOnLocationChange: false,  // <-- [Android] If the user closes the app **while location-tracking is started** , reboot app when a new location is recorded (WARNING: possibly distruptive to user) 
+        forceReloadOnMotionChange: false,    // <-- [Android] If the user closes the app **while location-tracking is started** , reboot app when device changes stationary-state (stationary->moving or vice-versa) --WARNING: possibly distruptive to user) 
+        forceReloadOnGeofence: false,        // <-- [Android] If the user closes the app **while location-tracking is started** , reboot app when a geofence crossing occurs --WARNING: possibly distruptive to user) 
         stopOnTerminate: false,              // <-- [Android] Allow the background-service to run headless when user closes the app.
         startOnBoot: true,                   // <-- [Android] Auto start background-service in headless mode when device is powered-up.
-        activityType: 'AutomotiveNavigation',
-        /**
-        * HTTP Feature:  set an url to allow the native background service to POST locations to your server
-        */
+        
+        // HTTP / SQLite config
         url: 'http://posttestserver.com/post.php?dir=cordova-background-geolocation',
-        batchSync: false,       // <-- [Default: false] Set true to sync locations to server in 1 HTTP request.
+        batchSync: true,       // <-- [Default: false] Set true to sync locations to server in a single HTTP request.
         autoSync: true,         // <-- [Default: true] Set true to sync each location to server as it arrives.
         maxDaysToPersist: 1,    // <-- Maximum days to persist a location in plugin's SQLite database when HTTP fails
         headers: {

example/SampleApp/www/js/index.js

@@ -166,9 +166,45 @@ var app = {
             console.log('BackgroundGeoLocation error');
         };
 
-        // Only ios emits this stationary event
-        bgGeo.onStationary(function(location, taskId) {
-            console.log('[js] BackgroundGeoLocation onStationary ' + JSON.stringify(location));
+        // BackgroundGeoLocation is highly configurable.
+        bgGeo.configure(callbackFn, failureFn, {
+            // Geolocation config
+            desiredAccuracy: 0,
+            stationaryRadius: 50,
+            distanceFilter: 50,
+            disableElasticity: false, // <-- [iOS] Default is 'false'.  Set true to disable speed-based distanceFilter elasticity
+            locationUpdateInterval: 5000,
+            minimumActivityRecognitionConfidence: 80,   // 0-100%.  Minimum activity-confidence for a state-change 
+            fastestLocationUpdateInterval: 5000,
+            activityRecognitionInterval: 10000,
+            stopTimeout: 0,
+            activityType: 'AutomotiveNavigation',
+
+            // Application config
+            debug: true, // <-- enable this hear sounds for background-geolocation life-cycle.
+            forceReloadOnLocationChange: false,  // <-- [Android] If the user closes the app **while location-tracking is started** , reboot app when a new location is recorded (WARNING: possibly distruptive to user) 
+            forceReloadOnMotionChange: false,    // <-- [Android] If the user closes the app **while location-tracking is started** , reboot app when device changes stationary-state (stationary->moving or vice-versa) --WARNING: possibly distruptive to user) 
+            forceReloadOnGeofence: false,        // <-- [Android] If the user closes the app **while location-tracking is started** , reboot app when a geofence crossing occurs --WARNING: possibly distruptive to user) 
+            stopOnTerminate: false,              // <-- [Android] Allow the background-service to run headless when user closes the app.
+            startOnBoot: true,                   // <-- [Android] Auto start background-service in headless mode when device is powered-up.
+            
+            // HTTP / SQLite config
+            url: 'http://posttestserver.com/post.php?dir=cordova-background-geolocation',
+            batchSync: true,       // <-- [Default: false] Set true to sync locations to server in a single HTTP request.
+            autoSync: true,         // <-- [Default: true] Set true to sync each location to server as it arrives.
+            maxDaysToPersist: 1,    // <-- Maximum days to persist a location in plugin's SQLite database when HTTP fails
+            headers: {
+                "X-FOO": "bar"
+            },
+            params: {
+                "auth_token": "maybe_your_server_authenticates_via_token_YES?"
+            }
+        });
+        
+        // Listen to motion-state changes (stationary / moving)
+        bgGeo.onMotionChange(function(isMoving, location, taskId) {
+            console.log('[js] BackgroundGeoLocation stationary-state changed ' + isMoving);
+            console.log('[js] location: ' + JSON.stringify(location));
             
             app.setCurrentLocation(location);
 
@@ -177,6 +213,7 @@ var app = {
             // Center ourself on map
             app.onClickHome();
             
+            if (!isMoving) {
                 if (!app.stationaryRadius) {
                     app.stationaryRadius = new google.maps.Circle({
                         fillColor: '#cc0000',
@@ -189,45 +226,15 @@ var app = {
                 var center = new google.maps.LatLng(coords.latitude, coords.longitude);
                 app.stationaryRadius.setRadius(radius);
                 app.stationaryRadius.setCenter(center);
+            }
             
             bgGeo.finish(taskId);
 
         });
 
-        // BackgroundGeoLocation is highly configurable.
-        bgGeo.configure(callbackFn, failureFn, {
-            debug: true, // <-- enable this hear sounds for background-geolocation life-cycle.
-            desiredAccuracy: 0,
-            stationaryRadius: 50,
-            distanceFilter: 50,
-            disableElasticity: false, // <-- [iOS] Default is 'false'.  Set true to disable speed-based distanceFilter elasticity
-            locationUpdateInterval: 5000,
-            minimumActivityRecognitionConfidence: 80,   // 0-100%.  Minimum activity-confidence for a state-change 
-            fastestLocationUpdateInterval: 5000,
-            activityRecognitionInterval: 10000,
-            stopTimeout: 0,
-            forceReload: false,      // <-- [Android] If the user closes the app **while location-tracking is started** , reboot app (WARNING: possibly distruptive to user) 
-            stopOnTerminate: true, // <-- [Android] Allow the background-service to run headless when user closes the app.
-            startOnBoot: false,      // <-- [Android] Auto start background-service in headless mode when device is powered-up.
-            activityType: 'AutomotiveNavigation',
-            /**
-            * HTTP Feature:  set an url to allow the native background service to POST locations to your server
-            */
-            url: 'http://posttestserver.com/post.php?dir=cordova-background-geolocation',
-            batchSync: true,       // <-- [Default: false] Set true to sync locations to server in a single HTTP request.
-            autoSync: true,         // <-- [Default: true] Set true to sync each location to server as it arrives.
-            maxDaysToPersist: 1,    // <-- Maximum days to persist a location in plugin's SQLite database when HTTP fails
-            headers: {
-                "X-FOO": "bar"
-            },
-            params: {
-                "auth_token": "maybe_your_server_authenticates_via_token_YES?"
-            }
-        });
-        
-        bgGeo.onGeofence(function(identifier, taskId) {
-            alert('Enter Geofence: ' + identifier);
-            console.log('[js] Geofence ENTER: ', identifier, taskId);
+        // Listen to Geofence events.
+        bgGeo.onGeofence(function(params, taskId) {
+            console.log('[js] Geofence crossed: ', params.action, params.identifier);
             bgGeo.finish(taskId);
         });
 
@@ -240,7 +247,8 @@ var app = {
                 identifier: 'MyGeofence',
                 radius: 200,
                 latitude: e.latLng.lat(),
-                longitude: e.latLng.lng()
+                longitude: e.latLng.lng(),
+                notifyOnEntry: true
             }, function() {
                 app.geofence = new google.maps.Circle({
                     fillColor: '#00cc00',