Xopoz GPS Tracking Configuration Guide
Optimize Your Android Device for Reliable Location Tracking
⚠️ Important Notice
This is an Android operating system configuration issue, NOT a Xopoz software problem.
By default, Android severely throttles GPS location requests when your screen is off to save battery. Xopoz updates GPS location every 1 minute in the background, but this guide shows you how to fix Android's limitation that prevents this from working properly.
📋 What This Guide Covers
This guide will help you configure your Android device to allow Xopoz to:
- Request GPS location updates every 1 minute as designed (not forced to wait 10 minutes by Android)
- Bypass Android's background location throttling system
- Ensure reliable tracking even when your screen is off
- Maintain Xopoz's optimized 1-minute GPS sampling for accurate location tracking
🎯 The Problem Explained
Default Android Behavior: Android forces GPS apps to wait 10 minutes between location requests when the screen is off, regardless of the app's design.
Your Experience: Xopoz is designed to update GPS position every 1 minute in the background, but GPS samples arrive every 10 minutes instead.
Why This Happens: Android's location_background_throttle_interval_ms setting defaults to 600,000 milliseconds (10 minutes) to save battery on all devices.
The Solution: Use ADB commands to configure your device specifically for reliable GPS tracking.
🔧 Prerequisites
Step 1: Install ADB (Android Debug Bridge)
ADB is Google's official tool for communicating with Android devices from your computer.
📥 Download Platform Tools from Google
What you're downloading: A small package (~10MB) containing just the essential ADB tools - no need for the full Android Studio.
Step 2: Enable Developer Options on Your Phone
- Open Settings on your Android device
- Go to About Phone
- Tap Build Number seven times rapidly
- You'll see a message: "You are now a developer!"
- Go back to Settings and open Developer Options
- Enable USB Debugging
Step 3: Connect Your Phone
- Connect your Android device to your computer via USB cable
- Your phone will show a popup: "Allow USB debugging?"
- Check "Always allow from this computer" and tap OK
- Open Command Prompt (Windows) or Terminal (Mac/Linux)
- Navigate to the folder where you extracted Platform Tools
- Type
adb devices and press Enter
- You should see your device listed
⚙️ Configuration Commands
Now we'll run two critical commands to optimize your device for Xopoz tracking.
✅ Command 1: Reduce Background Throttle Interval
This changes Android's GPS throttling from 10 minutes to 30 seconds, allowing more frequent location updates.
Check Current Setting (Diagnostic)
First, let's see what your device is currently set to:
C:\> adb shell settings get global location_background_throttle_interval_ms
600000
Apply the Fix
Now set it to 30 seconds (30,000 milliseconds) for optimal Xopoz tracking:
C:\> adb shell settings put global location_background_throttle_interval_ms 30000
Verify the Change
Confirm the new setting is active:
C:\> adb shell settings get global location_background_throttle_interval_ms
30000
📊 What This Does
Before: Android forces 10-minute waits between GPS requests
After: Android allows GPS requests every 30 seconds
Result: Xopoz's 1-minute GPS update interval now works correctly!
✅ Command 2: Whitelist Xopoz Package
This completely exempts Xopoz from Android's background location throttling system.
Check Current Whitelist (Diagnostic)
See if any apps are currently whitelisted:
C:\> adb shell settings get secure location_background_throttle_package_whitelist
null
Add Xopoz to Whitelist
This is the most powerful command - it tells Android to never throttle Xopoz:
C:\> adb shell settings put secure location_background_throttle_package_whitelist com.tbr.xopoz
Verify Whitelisting
Confirm Xopoz is now protected:
C:\> adb shell settings get secure location_background_throttle_package_whitelist
com.tbr.xopoz
🛡️ What Whitelisting Does
Purpose: Exempts Xopoz from all background location throttling
Effect: Android's power management system treats Xopoz as a trusted location app
Benefit: Combined with Command 1, ensures maximum GPS reliability
📖 Technical Reference
These settings are part of Android's documented power management system:
📚 XDA Developers: Android Oreo Background Location Whitelist
Android Source Code References
The whitelist setting is defined in Android's framework:
/**
* Packages that are allowlisted for background throttling
* (throttling will not be applied).
* @hide
*/
@Readable
public static final String LOCATION_BACKGROUND_THROTTLE_PACKAGE_WHITELIST =
"location_background_throttle_package_whitelist";
✅ Testing Your Configuration
After applying both commands, test your Xopoz tracking:
- Restart Xopoz: Close and reopen the app to ensure settings take effect
- Start Tracking: Enable GPS tracking in Xopoz
- Turn Off Screen: Lock your device and wait
- Check Results: After a few minutes, unlock and verify GPS samples are arriving every 1 minute (not every 10 minutes)
- Battery Monitoring: Monitor battery usage over several hours to ensure reasonable consumption
🎉 Expected Results
GPS Sample Frequency: Every 1 minute as designed by Xopoz
Screen-Off Tracking: Continuous reliable tracking even with screen locked
Battery Impact: Optimized by Xopoz's 1-minute sampling interval and immediate GPS shutdown after each sample
🔋 Battery Optimization
Xopoz is designed with battery efficiency in mind:
- Fixed 1-Minute Interval: Optimized balance between accuracy and battery consumption
- Immediate GPS Shutdown: GPS chip powers off within 2-4 seconds after each location acquisition
- Direct Android GPS API: Bypasses Google Play Services for minimal overhead
- Phantom Mode: Enable to track locally without server uploads for additional power savings
- Smart Wake Locks: Controlled wake lock usage prevents GPS throttling during background operation
Expected Battery Consumption: With these ADB optimizations applied, Xopoz's 1-minute GPS sampling consumes approximately 3-5% battery per hour during active tracking, which is highly competitive for professional GPS tracking applications.
❓ Troubleshooting
ADB Device Not Found
- Ensure USB debugging is enabled in Developer Options
- Try a different USB cable (data cables, not charge-only)
- Install manufacturer-specific USB drivers if needed
- Try restarting both your phone and computer
Settings Revert After Reboot
- Some Android versions reset these settings on restart
- Re-run the commands after each device reboot
- Consider creating a batch script (.bat) to automate the commands
GPS Still Not Working as Expected
- Check Xopoz has location permission: "Allow all the time"
- Verify battery optimization is disabled for Xopoz
- Ensure "High accuracy" location mode is enabled in Android settings
- Check that Xopoz foreground service notification is visible
🔄 Automation Script (Optional)
Create a batch file to quickly apply both commands:
@echo off
echo Configuring Android for Xopoz GPS tracking...
adb shell settings put global location_background_throttle_interval_ms 30000
adb shell settings put secure location_background_throttle_package_whitelist com.tbr.xopoz
echo.
echo Configuration complete! Testing...
adb shell settings get global location_background_throttle_interval_ms
adb shell settings get secure location_background_throttle_package_whitelist
pause
Save this as configure-xopoz.bat and run it whenever needed.
💡 Pro Tip: Multiple Device Setup
If you track multiple devices with Xopoz, all devices will update at the same 1-minute interval. However, you can adjust the Android throttle setting differently on each device if needed:
- Standard Configuration: 30,000ms (30 seconds) - recommended for all devices
- Aggressive Configuration: 15,000ms (15 seconds) - for critical tracking scenarios
- Relaxed Configuration: 60,000ms (1 minute) - matches Xopoz exactly with minimal Android overhead
Recommendation: Use 30,000ms (30 seconds) on all devices as it provides a comfortable buffer below Xopoz's 1-minute interval while preventing Android throttling.