Androidでネットワークプロバイダーからロケール情報を取得する方法

はじめに

このチュートリアルでは、Androidアプリでネットワークプロバイダー（NETWORK_PROVIDER）から位置情報を取得し、Geocoderクラスを利用してロケール（地域・言語）情報を画面に表示する方法を段階的に解説します。

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

Android Studioを起動し、「File」⇒「New Project」を選択して新しいプロジェクトを作成します。必要な項目をすべて入力してプロジェクトの雛形を生成してください。

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

res/layout/activity_main.xml に以下のコードを追加します。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:app="https://schemas.android.com/apk/res-auto"
    xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:gravity="center"
    android:layout_height="match_parent"
    tools:context=".MainActivity">
    <TextView
        android:id="@+id/text"
        android:textSize="30sp"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />
</LinearLayout>

上記のコードでは、取得したロケール情報を画面に表示するためのTextViewを1つ配置しています。

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

src/MainActivity.java に以下のコードを追加します。

package com.example.myapplication;

import android.Manifest;
import android.content.pm.PackageManager;
import android.location.Address;
import android.location.Geocoder;
import android.location.Location;
import android.location.LocationManager;
import android.os.Build;
import android.os.Bundle;
import android.support.annotation.RequiresApi;
import android.support.v4.app.ActivityCompat;
import android.support.v7.app.AppCompatActivity;
import android.widget.TextView;

import java.io.IOException;
import java.util.List;

public class MainActivity extends AppCompatActivity {
    TextView textView;
    Location location;
    double describeContents;
    List<Address> addresses;
    Geocoder geocoder;

    @RequiresApi(api = Build.VERSION_CODES.P)
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        textView = findViewById(R.id.text);
        LocationManager locationManager = (LocationManager) this.getSystemService(LOCATION_SERVICE);
        if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED && ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
            ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.ACCESS_FINE_LOCATION, Manifest.permission.ACCESS_COARSE_LOCATION}, 101);
        }
        location = locationManager
        .getLastKnownLocation(LocationManager.NETWORK_PROVIDER);
        geocoder = new Geocoder(this);
    }

    @RequiresApi(api = Build.VERSION_CODES.O)
    @Override
    public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
        switch (requestCode) {
            case 101:
                if (grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                    if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED && ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
                        return;
                    }
                    try {
                        addresses = geocoder.getFromLocation(location.getLatitude(), location.getLongitude(), 10);
                        Address address = addresses.get(0);
                        textView.setText("" + address.getLocale());
                    } catch (IOException e) {
                        e.printStackTrace();
                    }
                } else {
                    //not granted
                }
                break;
            default:
                super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        }
    }

    @RequiresApi(api = Build.VERSION_CODES.O)
    @Override
    protected void onResume() {
        super.onResume();
        if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED && ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
            return;
        }
        try {
            addresses = geocoder.getFromLocation(location.getLatitude(), location.getLongitude(), 10);
            Address address = addresses.get(0);
            textView.setText("" + address.getLocale());
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

このコードの処理の流れは以下のとおりです。

• LocationManagerを取得し、NETWORK_PROVIDER経由で最後に記録された位置情報（getLastKnownLocation）を取り出します。
• ACCESS_FINE_LOCATION および ACCESS_COARSE_LOCATION 権限が未許可の場合は、リクエストコード101でユーザーに権限を要求します。
• 権限が許可されたタイミング（onRequestPermissionsResult）や onResume の際に、Geocoderの getFromLocation() に緯度経度を渡して住所情報を取得し、最初の Address オブジェクトから getLocale() でロケール情報をTextViewに表示します。

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

AndroidManifest.xml に以下のコードを追加します。

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

    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <uses-permission android:name="android.permission.INTERNET"/>
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />

    <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>

ここでは、位置情報の取得に必要な ACCESS_COARSE_LOCATION 権限と、Geocoderがバックエンドサービスと通信するために不可欠な INTERNET 権限を宣言しています。なお、Javaコード上で ACCESS_FINE_LOCATION を要求しているため、実運用では同権限の uses-permission 宣言も併せて追加することをおすすめします。

アプリの実行

それではアプリを実行してみましょう。実機のAndroidスマートフォンがパソコンに接続されているものとします。Android Studioでプロジェクト内のアクティビティファイルを開き、ツールバーの実行アイコンをクリックします。 接続した端末を選択すると、端末の画面に以下のようにロケール情報が表示されます。

実装時の注意点

• 実行時権限： 位置情報権限はAndroid 6.0以降、実行時にユーザーの許可が必要です。許可されなかった場合はロケール情報を取得できません。
• nullチェック： getLastKnownLocation() はキャッシュされた直近の位置情報を返すため、まだ位置情報が記録されていない場合は null を返すことがあります。実務では null チェックを必ず入れましょう。
• Geocoderの依存性： Geocoder は端末内のバックエンドサービスに依存するため、非対応の環境では IOException が発生する可能性があります。例外処理の実装を忘れないようにしてください。