位置情報API

• Quest 2
• Meta Quest Pro
• Meta Quest 3

• Category (カテゴリ): 前景位置情報(Meta Questヘッドセットでは、背景位置情報へのアクセスはサポートされていません。禁止されているAndroidアクセス許可を参照)。
• Accuracy (正確性): 正確な位置情報かそれとも近似位置情報か(正確な位置情報と近似位置情報の定義については、こちら⁠を参照)。

• アプリで近似位置情報が必要な場合は、android.permission.ACCESS_COARSE_LOCATIONを使います。
• アプリで正確な位置情報が必要な場合は、android.permission.ACCESS_FINE_LOCATIONを使います。

<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. 位置情報マネージャ⁠のインスタンスを作成します。

    LocationManager locationManager = (LocationManager) getSystemService(Context.LOCATION_SERVICE);
   
2. LocationManagerから位置情報の更新⁠をリクエストします。

    locationManager.requestLocationUpdates(LocationManager.NETWORK_PROVIDER, 0, 0, locationListener);
   
3. 位置情報の更新情報を受け取るためのLocationListener⁠を実装します。

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

• getLastKnownLocation⁠

    public Location getLastKnownLocation (String provider)
  
  この呼び出しを実行すると、指定されたプロバイダーから、最新の既知の位置情報が返されます。これまでの位置情報がない場合はnullになります。状況によっては、かなり古い位置情報が返される場合があるので、位置情報の経過時間を必ずチェックしてください。
• getCurrentLocation⁠

    public void getCurrentLocation (String provider,
                    LocationRequest locationRequest,
                    CancellationSignal cancellationSignal,
                    Executor executor,
                    Consumer<Location> consumer)
  
  指定されたLocationRequest⁠に基づいて、指定されたプロバイダーから、現在地情報の単一の修正が非同期で返されます。
• requestLocationUpdates⁠

    public void requestLocationUpdates (String provider,
                    long minTimeMs,
                    float minDistanceM,
                    LocationListener listener)
  
  指定された引数を使って特定のプロバイダーからの位置情報の更新情報と、呼び出し元スレッドのルーパーにおけるコールバックを登録します。

    public void requestLocationUpdates (String provider,
                long minTimeMs,
                float minDistanceM,
                PendingIntent pendingIntent)
  
  指定されたプロバイダーを使った位置情報の更新情報と、指定されたPendingIntent⁠を通じて配信されるコールバックを登録します。

    public void requestLocationUpdates (String provider,
                LocationRequest locationRequest,
                PendingIntent pendingIntent)
  
  LocationRequest⁠を使って指定されたプロバイダーから提供される位置情報の更新情報と、指定されたPendingIntent⁠を通じて配信されるコールバックを登録します。

    public void requestLocationUpdates (String provider,
                    LocationRequest locationRequest,
                    Executor executor,
                    LocationListener listener)
  
  指定されたプロバイダーを使った位置情報の更新情報を登録し、指定されたExecutor⁠のコールバックを登録します。
• removeUpdates⁠

   public void removeUpdates (LocationListener listener)
  
  指定されたLocationListener⁠の位置情報の更新情報をすべて削除します。

• バッテリー消費量を最小限に抑えるため、位置情報の更新は必要な場合にだけリクエストしてください。
• ユーザーのプライバシーを尊重するため、正確な位置情報データが必要でない場合は、近似位置情報を使ってください。
• アプリが位置情報へのアクセスを必要とする理由をユーザーに明確に説明してください。