Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

am 43a88375: am 92d99223: Merge "LocationManager javadoc permission fixes" into jb-mr1-dev

Browse Source 
* commit '43a883759fe40216650782b3f78d42fdcfb7b589':
  LocationManager javadoc permission fixes
This commit is contained in:
Victoria Lease
2012-10-22 13:44:16 -07:00
committed by Android Git Automerger
parent e78d50b4a0 43a883759f
commit c018f08a88
1 changed files with 9 additions and 23 deletions
Download Patch File Download Diff File Expand all files Collapse all files

32
location/java/android/location/LocationManager.java
View File

@@ -72,15 +72,10 @@ import com.android.internal.location.ProviderProperties;
* <p class="note">Unless noted, all Location API methods require
* the {@link android.Manifest.permission#ACCESS_COARSE_LOCATION} or
* {@link android.Manifest.permission#ACCESS_FINE_LOCATION} permissions.
* If your application only has the Coarse permission then it will still
* receive location results, but the update rate will be throttled and
* the exact location will be obfuscated to a coarse level of accuracy.
*
* <p> class="note">Before API level 17, the use of 'fine' location
* providers such as GPS required the fine permission. As of API level
* 17, applications with only the coarse permission may use all providers,
* including GPS, but the locations are obfuscated (made coarse) before
* being sent to the application.
* If your application only has the coarse permission then it will not have
* access to the GPS or passive location providers. Other providers will still
* return location results, but the update rate will be throttled and the exact
* location will be obfuscated to a coarse level of accuracy.
*/
public class LocationManager {
private static final String TAG = "LocationManager";
@@ -109,13 +104,8 @@ public class LocationManager {
*
* <p>This provider determines location using
* satellites. Depending on conditions, this provider may take a while to return
* a location fix.
*
* <p>Before API version 17, this provider required the
* {@link android.Manifest.permission#ACCESS_FINE_LOCATION} permission.
* From API version 17 and onwards, this provider can also be used with
* {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}, however
* the locations returned will be obfuscated to a coarse level of accuracy.
* a location fix. Requires the permission
* {@link android.Manifest.permission#ACCESS_FINE_LOCATION}.
*
* <p> The extras Bundle for the GPS location provider can contain the
* following key/value pairs:
@@ -136,13 +126,9 @@ public class LocationManager {
* when other applications or services request them without actually requesting
* the locations yourself. This provider will return locations generated by other
* providers. You can query the {@link Location#getProvider()} method to determine
* the origin of the location update.
*
* <p>Before API version 17, this provider required the
* {@link android.Manifest.permission#ACCESS_FINE_LOCATION} permission.
* From API version 17 and onwards, this provider can also be used with
* {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}, however
* the locations returned will be obfuscated to a coarse level of accuracy.
* the origin of the location update. Requires the permission
* {@link android.Manifest.permission#ACCESS_FINE_LOCATION}, although if the GPS is
* not enabled this provider might only return coarse fixes.
*
* @deprecated Use {@link LocationRequest} instead, see notes on {@link LocationManager}
*/