【Android】実行時に位置情報権限をリクエストする方法をサンプルコード付きで解説

はじめに

このチュートリアルでは、Androidアプリで実行時に位置情報（Location）権限をリクエストする方法を解説します。Android 6.0（APIレベル23）以降では、位置情報のような危険な権限はマニフェストへの宣言だけでは不十分で、実行時にユーザーへ許可を求める必要があります。

手順1：新規プロジェクトの作成

まず、Android Studioで新しいプロジェクトを作成します。メニューから「File」→「New Project」を選択し、必要な項目をすべて入力してプロジェクトを作成してください。

手順2：レイアウトファイル（activity_main.xml）の作成

次に、res/layout/activity_main.xml に以下のコードを追加します。ここでは、画面中央にメッセージを表示するシンプルなレイアウトを定義しています。

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Request Location permission at Run time!"
        android:padding="4dp"
        android:layout_centerInParent="true"
        android:textSize="36sp"
        android:textStyle="bold"/>

</RelativeLayout>

手順3：MainActivity.java の実装

続いて、src/MainActivity.java に以下のコードを追加します。checkSelfPermission() で ACCESS_FINE_LOCATION 権限が付与されているかを確認し、未許可の場合は requestPermissions() を呼び出して許可ダイアログを表示します。ダイアログの結果は onRequestPermissionsResult() コールバックで受け取り、トーストで通知する仕組みです。

import android.Manifest;
import android.content.pm.PackageManager;
import android.support.v4.app.ActivityCompat;
import android.support.v4.content.ContextCompat;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.Toast;

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        if (ContextCompat.checkSelfPermission(MainActivity.this,
            Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED){
            if (ActivityCompat.shouldShowRequestPermissionRationale(MainActivity.this,
                Manifest.permission.ACCESS_FINE_LOCATION)){
                ActivityCompat.requestPermissions(MainActivity.this,
                new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, 1);
            }else{
                ActivityCompat.requestPermissions(MainActivity.this,
                new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, 1);
            }
        }
    }
    @Override
    public void onRequestPermissionsResult(int requestCode, String[] permissions,
        int[] grantResults){
        switch (requestCode){
            case 1: {
                if (grantResults.length>0 && grantResults[0] == PackageManager.PERMISSION_GRANTED){
                    if (ContextCompat.checkSelfPermission(MainActivity.this,
                        Manifest.permission.ACCESS_FINE_LOCATION)==PackageManager.PERMISSION_GRANTED){
                        Toast.makeText(this, "Permission Granted", Toast.LENGTH_SHORT).show();
                    }
                }else{
                    Toast.makeText(this, "Permission Denied", Toast.LENGTH_SHORT).show();
                }
                return;
            }
        }
    }
}

※ 上記コードは旧サポートライブラリ（android.support.v4）を使用しています。AndroidXを採用しているプロジェクトでは、import文を androidx.core.app.ActivityCompat および androidx.core.content.ContextCompat に置き換えるだけで、同じように動作します。

手順4：AndroidManifest.xml への権限宣言

最後に、androidManifest.xml に以下のコードを追加して、位置情報権限を宣言します。<uses-permission> タグによる宣言は必須なので、記述漏れがないよう注意しましょう。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
    package="app.com.sample">

    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

アプリの実行と動作確認

それでは、アプリを実行してみましょう。ここでは、実際のAndroid端末をパソコンに接続しているものとして説明します。Android Studioからアプリを実行するには、プロジェクト内のアクティビティファイルを開き、ツールバーの「Run」アイコンをクリックします。実行デバイスとして自分のスマートフォンを選択すると、端末に以下のような画面と権限リクエストのダイアログが表示されます。

ダイアログで「許可」を選択すると「Permission Granted」、「拒否」すると「Permission Denied」というトーストが表示されれば、実装は完了です。これで、実行時に安全に位置情報権限を取得できるようになりました。