diff options
Diffstat (limited to 'location/java/android')
| -rw-r--r-- | location/java/android/location/LocationManager.java | 14 |
1 files changed, 13 insertions, 1 deletions
diff --git a/location/java/android/location/LocationManager.java b/location/java/android/location/LocationManager.java index e5f1cf5..14b812e 100644 --- a/location/java/android/location/LocationManager.java +++ b/location/java/android/location/LocationManager.java @@ -152,12 +152,24 @@ public class LocationManager { /** * Broadcast intent action when the configured location providers - * change. + * change. If you're interacting with the + * {@link android.provider.Settings.Secure#LOCATION_MODE} API, + * use {@link #MODE_CHANGED_ACTION} instead. */ public static final String PROVIDERS_CHANGED_ACTION = "android.location.PROVIDERS_CHANGED"; /** + * Broadcast intent action when {@link android.provider.Settings.Secure#LOCATION_MODE} changes. + * If you're interacting with provider-based APIs such as {@link #getProviders(boolean)}, you + * use {@link #PROVIDERS_CHANGED_ACTION} instead. + * + * In the future, there may be mode changes that do not result in + * {@link #PROVIDERS_CHANGED_ACTION} broadcasts. + */ + public static final String MODE_CHANGED_ACTION = "android.location.MODE_CHANGED"; + + /** * Broadcast intent action indicating that the GPS has either started or * stopped receiving GPS fixes. An intent extra provides this state as a * boolean, where {@code true} means that the GPS is actively receiving fixes. |