Androidで現在のGPS位置情報をプログラムから取得する方法【サンプルコード付き】

この記事では、Androidアプリでプログラムから現在のGPS位置情報を取得する方法を、サンプルコードとともにステップごとに解説します。

仕組みの概要

位置情報の取得には、Google Play Servicesが提供するFusedLocationProviderClientを使用します。このAPIはGPS・Wi-Fi・携帯基地局など複数の情報源を統合し、高精度かつバッテリー消費を抑えた位置情報を提供してくれます。

また、位置情報はユーザーのプライバシーに関わるデータであるため、ACCESS_FINE_LOCATIONパーミッションを実行時にリクエストする処理も必須となります。

ステップ1：新規プロジェクトの作成

Android Studioを起動し、「File」→「New Project」を選択して、必要事項を入力しながら新しいプロジェクトを作成します。

ステップ2：レイアウトファイル（activity_main.xml）の作成

res/layout/activity_main.xmlに以下のコードを追加します。取得した位置情報を表示するTextViewと、取得を開始するButtonを縦方向に並べたシンプルな構成です。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:layout_margin="16dp"
    android:gravity="center_horizontal"
    android:orientation="vertical">
    <TextView
        android:id="@+id/location"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Current GPS Location"
        android:textSize="24sp"
        android:textStyle="bold" />
    <Button
        android:id="@+id/getLocation"
        android:text="Get location"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />
</LinearLayout>

ステップ3：MainActivity.javaの実装

src/MainActivity.javaに以下のコードを記述します。ボタンがタップされるとgetLastLocation()によって直近の位置情報を取得し、成功すればその内容をTextViewに表示します。

import android.content.pm.PackageManager;
import android.location.Location;
import android.os.Bundle;
import android.support.v4.app.ActivityCompat;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import android.widget.Button;
import android.widget.TextView;
import com.google.android.gms.location.FusedLocationProviderClient;
import com.google.android.gms.location.LocationServices;
import com.google.android.gms.tasks.OnSuccessListener;
import static android.Manifest.permission.ACCESS_FINE_LOCATION;

public class MainActivity extends AppCompatActivity {
    private FusedLocationProviderClient client;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        requestPermission();
        client = LocationServices.getFusedLocationProviderClient(this);
        Button button = findViewById(R.id.getLocation);
        button.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                if (ActivityCompat.checkSelfPermission(MainActivity.this, ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
                    return;
                }
                client.getLastLocation().addOnSuccessListener(MainActivity.this, new OnSuccessListener() {
                    @Override
                    public void onSuccess(Location location) {
                        if (location != null) {
                            TextView textView = findViewById(R.id.location);
                            textView.setText(location.toString());
                        }
                    }
                });
            }
        });
    }

    private void requestPermission() {
        ActivityCompat.requestPermissions(this, new String[]{ACCESS_FINE_LOCATION}, 1);
    }
}

※上記コードは旧サポートライブラリ（android.support）を使用しています。最近のプロジェクトではAndroidXに読み替えてください（例：androidx.appcompat.app.AppCompatActivity、androidx.core.app.ActivityCompat）。また、Google Play Servicesの依存関係として「com.google.android.gms:play-services-location」をbuild.gradleに追加しておく必要があります。

ステップ4：AndroidManifest.xmlへの権限宣言

androidManifest.xmlに以下のコードを追加し、位置情報パーミッションを宣言します。

<?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」アイコンをクリックしてください。デバイス選択画面で自分のモバイル端末を選ぶと、端末側に以下のような初期画面が表示されます。