Location API

• Quest 2
• Meta Quest Pro
• Meta Quest 3

• Category: Foreground location (Meta Quest headsets do not support background location access; see Prohibited Android Permissions).
• Accuracy: Either precise location or approximate location (see the definition of precise and approximate location here).

• Use android.permission.ACCESS_COARSE_LOCATION if your app needs approximate location information.
• Use android.permission.ACCESS_FINE_LOCATION if your app needs precise location information.

<manifest ... >
<!-- Always include this permission -->
<uses-permission
android:name="android.permission.ACCESS_COARSE_LOCATION"
 />
<!--Include only if your app benefits from precise location access. -->
  <uses-permission
android:name="android.permission.ACCESS_FINE_LOCATION"
 />
</manifest>

// Create a class-level field for the ActivityResultLauncher
private ActivityResultLauncher<String[]> locationPermissionLauncher;

// Initialize the ActivityResultLauncher in your onCreate or initialization method
locationPermissionLauncher = registerForActivityResult(
    new ActivityResultContracts.RequestMultiplePermissions(),
    new ActivityResultCallback<Map<String, Boolean>>() {
        @Override
        public void onActivityResult(Map<String, Boolean> permissions) {
            if (permissions.getOrDefault(Manifest.permission.ACCESS_FINE_LOCATION, false)) {
                // Precise location access granted.
            } else if (permissions.getOrDefault(Manifest.permission.ACCESS_COARSE_LOCATION, false)) {
                // Only approximate location access granted.
            } else {
                // No location access granted.
            }
        }
    }
);

1. Create an instance of Location Manager.

    LocationManager locationManager = (LocationManager) getSystemService(Context.LOCATION_SERVICE);
   
2. Request location updates from the LocationManager.

    locationManager.requestLocationUpdates(LocationManager.NETWORK_PROVIDER, 0, 0, locationListener);
   
3. Implement a LocationListener to receive location updates.

    private final LocationListener locationListener = new LocationListener() {
        @Override
        public void onLocationChanged(Location location) {
            // Handle location updates here
        }
    };
   

• getLastKnownLocation

    public Location getLastKnownLocation (String provider)
  
  This call returns the last known location from the given provider or null if no previous location exists. The returned location may be quite old in some circumstances, so you should always check the age of the location.
• getCurrentLocation

    public void getCurrentLocation (String provider,
                    LocationRequest locationRequest,
                    CancellationSignal cancellationSignal,
                    Executor executor,
                    Consumer<Location> consumer)
  
  Asynchronously returns a single current location fix from the given provider based on the given LocationRequest.
• requestLocationUpdates

    public void requestLocationUpdates (String provider,
                    long minTimeMs,
                    float minDistanceM,
                    LocationListener listener)
  
  Register for location updates from the given provider with the given arguments and a callback on the Looper of the calling thread.

    public void requestLocationUpdates (String provider,
                long minTimeMs,
                float minDistanceM,
                PendingIntent pendingIntent)
  
  Register for location updates using the named provider and callbacks delivered via the provided PendingIntent.

    public void requestLocationUpdates (String provider,
                LocationRequest locationRequest,
                PendingIntent pendingIntent)
  
  Register for location updates from the specified provider using a LocationRequest, and callbacks delivered via the provided PendingIntent.

    public void requestLocationUpdates (String provider,
                    LocationRequest locationRequest,
                    Executor executor,
                    LocationListener listener)
  
  Register for location updates using the named provider and a callback on the specified Executor.
• removeUpdates

   public void removeUpdates (LocationListener listener)
  
  Remove all location updates for the specified LocationListener.

• Request location updates only when necessary to minimize battery consumption.
• Use coarse location data when you don’t require precise location data to respect users’ privacy.
• Clearly explain to users why your app requires access to their location.