@azatek/background-geolocation 7.0.0 → 7.0.1

package/README.md

@@ -35,10 +35,31 @@ const watcherId = await BackgroundGeolocation.addWatcher({
 
 ## Accuracy Modes
 
-- **LocationAccuracy.HIGH (100)**: GPS only - High battery usage, best accuracy
-- **LocationAccuracy.BALANCED (102)**: GPS + Network - Medium battery, good accuracy
-- **LocationAccuracy.LOW (104)**: Network only - Low battery, approximate location
-- **LocationAccuracy.PASSIVE (105)**: Minimal battery, uses other apps' location requests
+| Mode | Value | Description | Accuracy Level |
+|------|-------|-------------|----------------|
+| **HIGH** | 100 | Best accuracy, high battery usage | Android: PRIORITY_HIGH_ACCURACY<br>iOS: kCLLocationAccuracyBest |
+| **BALANCED** | 102 | Good accuracy (default) | Android: PRIORITY_BALANCED_POWER_ACCURACY<br>iOS: kCLLocationAccuracyNearestTenMeters |
+| **LOW** | 104 | Approximate location | Android: PRIORITY_LOW_POWER<br>iOS: kCLLocationAccuracyHundredMeters |
+| **PASSIVE** | 105 | Minimal battery | Android: PRIORITY_PASSIVE<br>iOS: kCLLocationAccuracyThreeKilometers |
+
+### Platform Behavior
+
+**Both platforms now behave identically:**
+- Location updates are triggered **only by distance changes**, not time intervals
+- `distanceFilter: 50` → Updates only when device moves 50+ meters
+- `distanceFilter: 0` → Updates on any movement (controlled by accuracy setting)
+
+**Important:**
+- ⚠️ With `distanceFilter > 0`, you will **NOT** receive updates when stationary
+- ✅ This matches iOS behavior and saves battery
+- 💡 Set `distanceFilter: 0` if you need updates even when stationary
+
+**Android-specific:**
+- Uses `FusedLocationProviderClient` with very large time interval to effectively disable time-based updates
+
+**iOS-specific:**
+- Uses `CLLocationManager.distanceFilter` natively
+- HIGH mode automatically switches to `kCLLocationAccuracyBestForNavigation` when device is charging
 
 ## Original Usage
 

package/android/src/main/java/com/equimaps/capacitor_background_geolocation/BackgroundGeolocationService.java

@@ -85,45 +85,38 @@ public class BackgroundGeolocationService extends Service {
 			
 			// Map accuracy enum to Android Priority
 			int priority;
-			long interval;
-			
+
 			switch (accuracy) {
 				case 100: // HIGH
 					priority = Priority.PRIORITY_HIGH_ACCURACY;
-					interval = 5000; // 5 seconds
 					break;
 				case 102: // BALANCED (Default)
 					priority = Priority.PRIORITY_BALANCED_POWER_ACCURACY;
-					interval = 10000; // 10 seconds
 					break;
 				case 104: // LOW
 					priority = Priority.PRIORITY_LOW_POWER;
-					interval = 30000; // 30 seconds
 					break;
 				case 105: // PASSIVE
 					priority = Priority.PRIORITY_PASSIVE;
-					interval = 60000; // 60 seconds
 					break;
 				default:
 					priority = Priority.PRIORITY_BALANCED_POWER_ACCURACY;
-					interval = 10000;
 			}
-			
-			// Use modern LocationRequest.Builder API
+
+			// Match iOS behavior: Only update based on distance, not time intervals
+			// When distanceFilter is 0, use a minimal interval to get updates
+			// When distanceFilter > 0, use a very large interval so only distance triggers updates
+			long interval = (distanceFilter > 0) ? Long.MAX_VALUE : 1000;
+
 			LocationRequest locationRequest = new LocationRequest.Builder(priority, interval)
 					.setMinUpdateDistanceMeters(distanceFilter)
 					.setWaitForAccurateLocation(false)
-					.setMaxUpdateDelayMillis(interval)
 					.build();
 
             LocationCallback callback = new LocationCallback(){
                 @Override
                 public void onLocationResult(LocationResult locationResult) {
-                    Logger.debug("onLocationResult called");
                     Location location = locationResult.getLastLocation();
-                    if (location != null) {
-                        Logger.debug("Location received: " + location.getLatitude() + ", " + location.getLongitude());
-                    }
                     Intent intent = new Intent(ACTION_BROADCAST);
                     intent.putExtra("location", location);
                     intent.putExtra("id", id);
@@ -133,9 +126,8 @@ public class BackgroundGeolocationService extends Service {
                 }
                 @Override
                 public void onLocationAvailability(LocationAvailability availability) {
-                    Logger.debug("Location availability: " + availability.isLocationAvailable());
                     if (!availability.isLocationAvailable()) {
-                        Logger.debug("Location not available");
+                        Logger.warn("Location not available - check if GPS is enabled");
                     }
                 }
             };
@@ -152,13 +144,11 @@ public class BackgroundGeolocationService extends Service {
             // permissions are not yet granted. Rather than check the permissions, which is fiddly,
             // we simply ignore the exception.
             try {
-                Logger.debug("Requesting location updates with priority: " + priority + ", interval: " + interval);
                 watcher.client.requestLocationUpdates(
                         watcher.locationRequest,
                         watcher.locationCallback,
                         null
                 );
-                Logger.debug("Location updates requested successfully");
             } catch (SecurityException e) {
                 Logger.error("SecurityException when requesting location updates", e);
             }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@azatek/background-geolocation",
-    "version": "7.0.0",
+    "version": "7.0.1",
     "description": "Capacitor plugin for background geolocation tracking with configurable GPS accuracy modes (HIGH/BALANCED/LOW/PASSIVE) for battery optimization. Fork of @capacitor-community/background-geolocation with enhanced accuracy control.",
     "keywords": [
         "capacitor",