Background Location Limits
Stay organized with collections
Save and categorize content based on your preferences.
In an effort to reduce power consumption, Android 8.0 (API level 26) limits
how frequently an app can retrieve the user's current location while the app is
running in the background. Under these
conditions, apps can receive location updates only a few times each hour.
Note: These limitations apply to all apps used on devices
running Android 8.0 (API level 26) or higher, regardless of an app's
target SDK version.
This location retrieval behavior is particularly
important to keep in mind if your app relies on real-time alerts or motion
detection while running in the background.
Foreground app behavior is preserved
If an app is in the foreground on a device running Android 8.0 (API level 26),
the location update behavior is the same as on Android 7.1.1 (API level
25) and lower.
Warning: If your app retrieves near real-time location
updates over a long period of time, the device's battery life becomes
significantly shorter.
Tuning your app's location behavior
Consider whether your app's use cases for running in the background cannot
succeed at all if your app receives infrequent location updates. If this is the
case, you can retrieve location updates more frequently by performing one of the
following actions:
- Bring your app to the foreground.
-
Start a foreground
service in your app by calling
startForegroundService()
. When such a foreground service is active, it
appears as an ongoing notification in the
notification
area.
Caution: If your app starts a foreground service
while running in the background on a device that runs Android 11 (API
level 30) or higher, your app cannot access location information unless the
user has granted the
ACCESS_BACKGROUND_LOCATION
permission to your app. For more information, view the guidance about the
while-in-use
restrictions that are associated with foreground services.
-
Use elements of the Geofencing API, such as the
GeofencingClient
,
which are optimized for minimizing power use.
-
Use a passive location listener, which may receive faster location updates
if there are foreground apps requesting location updates at a faster rate.
Note: If your app needs access to location history that
contains time-frequent updates, use the batched version of the Fused Location
Provider API elements, such as the
FusedLocationProviderApi
interface. When your app is running in the background, this API receives the
user's location more frequently than the non-batched API. Keep in mind, however,
that your app still receives updates in batches only a few times each hour.
Affected APIs
The changes to location retrieval behavior in background apps affect the
following APIs:
- Fused
Location Provider (FLP)
-
-
If your app is running in the background, the location system service
computes a new location for your app only a few times each hour. This
is the case even when your app is requesting more frequent location
updates.
By using the
batched version of FLP, however, you have access to more
time-frequent location history after your app receives a batch update,
which also occurs only a few times each hour.
- If your app is running in the foreground, there is no change in
location sampling rates compared to Android 7.1.1 (API level 25).
- Geofencing
-
- Background apps can receive geofencing transition events more
frequently than updates from the Fused Location Provider.
- The average responsiveness for a geofencing event is every couple of
minutes or so.
- GNSS Measurements and GNSS Navigation Messages
-
- Location Manager
-
-
Location updates are provided to background apps only a few times
each hour.
Note: If your app is running on a device with
Google Play services installed, it is highly recommended that you use
the Fused
Location Provider (FLP) instead.
- Wi-Fi Manager
-
The
startScan()
method
performs a full scan for background apps only a few times each hour. If a
background app calls the method again soon afterward, the
WifiManager
class provides cached results from the
previous scan.
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2024-04-29 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-04-29 UTC."],[],[],null,["# Background Location Limits\n\nIn an effort to reduce power consumption, Android 8.0 (API level 26) limits\nhow frequently an app can retrieve the user's current location while the app is\n[running in the background](/guide/background). Under these\nconditions, apps can receive location updates only a few times each hour.\n\n**Note:** These limitations apply to all apps used on devices\nrunning Android 8.0 (API level 26) or higher, **regardless of an app's\ntarget SDK version**.\n\nThis location retrieval behavior is particularly\nimportant to keep in mind if your app relies on real-time alerts or motion\ndetection while running in the background.\n\nForeground app behavior is preserved\n------------------------------------\n\n\nIf an app is in the foreground on a device running Android 8.0 (API level 26),\nthe location update behavior is the same as on Android 7.1.1 (API level\n25) and lower.\n\n**Warning:** If your app retrieves near real-time location\nupdates over a long period of time, the device's battery life becomes\nsignificantly shorter.\n\nTuning your app's location behavior\n-----------------------------------\n\nConsider whether your app's use cases for running in the background cannot\nsucceed at all if your app receives infrequent location updates. If this is the\ncase, you can retrieve location updates more frequently by performing one of the\nfollowing actions:\n\n- Bring your app to the foreground.\n- Start a [foreground\n service](/guide/components/foreground-services) in your app by calling\n [startForegroundService()](/reference/android/content/Context#startForegroundService(android.content.Intent)). When such a foreground service is active, it\n appears as an ongoing notification in the\n [notification\n area](/guide/topics/ui/notifiers/notifications).\n\n **Caution:** If your app starts a foreground service\n while running in the background on a device that runs Android 11 (API\n level 30) or higher, your app cannot access location information unless the\n user has granted the\n [`ACCESS_BACKGROUND_LOCATION`](/reference/android/Manifest.permission#ACCESS_BACKGROUND_LOCATION)\n permission to your app. For more information, view the guidance about the\n [while-in-use\n restrictions](/guide/components/foreground-services#while-in-use-restrictions) that are associated with foreground services.\n- Use elements of the Geofencing API, such as the [`GeofencingClient`](https://developers.google.com/android/reference/com/google/android/gms/location/GeofencingClient), which are optimized for minimizing power use.\n- Use a passive location listener, which may receive faster location updates if there are foreground apps requesting location updates at a faster rate.\n\n**Note:** If your app needs access to location history that\ncontains time-frequent updates, use the batched version of the Fused Location\nProvider API elements, such as the\n[`FusedLocationProviderApi`](https://developers.google.com/android/reference/com/google/android/gms/location/FusedLocationProviderApi)\ninterface. When your app is running in the background, this API receives the\nuser's location more frequently than the non-batched API. Keep in mind, however,\nthat your app still receives updates in batches only a few times each hour.\n\nAffected APIs\n-------------\n\n\nThe changes to location retrieval behavior in background apps affect the\nfollowing APIs:\n\n[Fused\nLocation Provider (FLP)](https://developers.google.com/android/reference/com/google/android/gms/location/FusedLocationProviderApi)\n:\n - If your app is running in the background, the location system service\n computes a new location for your app only a few times each hour. This\n is the case even when your app is requesting more frequent location\n updates.\n\n By using the\n [batched version](https://developers.google.com/android/reference/com/google/android/gms/location/LocationRequest#setMaxWaitTime(long)) of FLP, however, you have access to more\n time-frequent location history after your app receives a batch update,\n which also occurs only a few times each hour.\n - If your app is running in the foreground, there is no change in location sampling rates compared to Android 7.1.1 (API level 25).\n\nGeofencing\n:\n - Background apps can receive geofencing transition events more frequently than updates from the Fused Location Provider.\n - The average responsiveness for a geofencing event is every couple of minutes or so.\n\nGNSS Measurements and GNSS Navigation Messages\n:\n - When your app is in the background, callbacks that are registered to receive outputs from [GnssMeasurement](/reference/android/location/GnssMeasurement) and [GnssNavigationMessage](/reference/android/location/GnssNavigationMessage) stop executing.\n\nLocation Manager\n:\n - Location updates are provided to background apps only a few times\n each hour.\n\n\n **Note:** If your app is running on a device with\n Google Play services installed, it is highly recommended that you use\n the [Fused\n Location Provider (FLP)](https://developers.google.com/android/reference/com/google/android/gms/location/FusedLocationProviderApi) instead.\n\nWi-Fi Manager\n:\n The [startScan()](/reference/android/net/wifi/WifiManager#startScan()) method\n performs a full scan for background apps only a few times each hour. If a\n background app calls the method again soon afterward, the\n [WifiManager](/reference/android/net/wifi/WifiManager) class provides cached results from the\n previous scan."]]