位置情報取得に利用するLocationClient

位置情報を取得するにはLocationManagerが提供されていますが、GPSとWiFiの設定に依存してLocationProviderの切り替えが必要でした。Google Play services APKが提供するLocation Serviceを使用すれば、Providerを考慮することなく位置情報を取得することができます。

Permissionの設定

Location Serviceを使用すには、AndroidManifest.xmlにPermissionの記載が必要です。LocationManagerと同様に、位置情報の精度に応じてPermissionが異なります。

?

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

?

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

LocationClientの接続

Location Serviceを使用するには、LocationClientクラスの生成が必要です。

?

1 2	mLocationClient = new LocationClient(this, mConnectionCallbacks,    mOnConnectionFailedListener);

第2引数にConnectionCallbacksインターフェイス、第3引数にOnConnectionFailedListenerインターフェイスをセットします。ConnectionCallbacksインターフェイスは、LocationClientがLocation Serviceに接続 / 切断した際にコールされます。OnConnectionFailedListenerは何らかのエラーが発生した場合にコールされます。

LocationClientの接続要求はLocationClient#connectメソッドをコールします。

?

1 2 3 4 5 6 7 8 9

@Override protected void onStart() {     super.onStart();     if (isGooglePlayServicesAvailable()) {         if (!mLocationClient.isConnected()) {             mLocationClient.connect();         }     } }

接続に成功すると、mConnectionCallbacks#onConnectedがコールされます。

LocationRequestの生成

LocationClientの接続が成功した後に、requestLocationUpdatesメソッドをコールし位置情報の取得要求を行います。

?

1 2 3 4

@Override public void onConnected(Bundle bundle) {     mLocationClient.requestLocationUpdates(mLocationRequest, mLocationListener); }

第1引数にLocationRequestクラスを、第2引数にLocationListenerインターフェイスをセットします。LocationRequestクラスは次のようなセットモジュールを提供します。

メソッド	内容
setInterval	位置情報の更新間隔をmsで指定
setPriority	プライオリティ(精度)の指定
setExpirationDuration	要求の期間(動作時間を)msで指定
setFastestInterval	位置情報の最速更新間隔をmsで指定
setSmallestDisplacement	最小移動距離をmで指定(指定メートル移動したら更新)

位置情報の取得

位置情報はmLocationListener#onLocationChangedメソッドにてAndroid OSから受け取ります。位置情報はLocationクラスとして取得します。

?

1 2 3 4 5 6 7

private LocationListener mLocationListener = new LocationListener() {       @Override     public void onLocationChanged(Location location) {     }   };

LocationClientの停止

位置情報の更新を停止するには、LocationClientクラスのremoveLocationUpdatesメソッドをコールしリスナーを解除します。続けて、disconnectメソッドをコールしLocation Serviceから切断します。

?

1 2 3 4 5 6 7 8 9 10

@Override protected void onStop() {     if (isGooglePlayServicesAvailable()) {         if (mLocationClient.isConnected()) {             mLocationClient.removeLocationUpdates(mLocationListener);         }         mLocationClient.disconnect();     }     super.onStop(); }

Google Play servicesを使う

Google Play servicesを使う準備

Google Play services APIを使うには、Android SDK ManagerでGoogle Play servicesをダウンロードします。ダウンロードすると、次のディレクトリに保存されます。<AndroidSDK>\sdk\extras\google\google_play_services\libproject\google-play-services_lib

上記のプロジェクトをEclipseにインポートします。

Google Play services APIを使用するプロジェクトにて、AndroidManifest.xmlにmeta-dataの記載を行います。

?

1 2 3 4 5

<application     <meta-data         android:name="com.google.android.gms.version"         android:value="@integer/google_play_services_version" /> </application>

Google Play servicesの存在確認

アプリケーションが動作するユーザー端末がどのような状態かわかりません。Google Play services APIを使用する前に、Google Play services APKがインストールされてるかどうかチェックしましょう。

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45

public class UsingGooglePlayServiceSampleActivity extends FragmentActivity {       private boolean isGooglePlayServicesAvailable() {         int resultCode = GooglePlayServicesUtil.isGooglePlayServicesAvailable(this);           if (ConnectionResult.SUCCESS == resultCode) {             return true;         } else {             Dialog dialog = GooglePlayServicesUtil.getErrorDialog(resultCode, this,                     CONNECTION_FAILURE_RESOLUTION_REQUEST);             if (dialog != null) {                 ErrorDialogFragment errorFragment = new ErrorDialogFragment();                 errorFragment.setDialog(dialog);                 errorFragment.show(getSupportFragmentManager(), "errro_dialog");             }         }           return false;     }       public static class ErrorDialogFragment extends DialogFragment {           private Dialog mDialog;           public ErrorDialogFragment() {             super();             mDialog = null;         }           public void setDialog(Dialog dialog) {             mDialog = dialog;         }           @Override         public Dialog onCreateDialog(Bundle savedInstanceState) {             return mDialog;         }           @Override         public void onDestroy() {             mDialog = null;             super.onDestroy();         }     } }

GooglePlayServicesUtil.isGooglePlayServicesAvailable()をコールします。APIリファレンスに記載されているResultコード一覧の値が返ってきます。エラーが発生した場合、GooglePlayServicesUtil.getErrorDialog()をコールしDialogを取得します。取得したDialogはDialogFragmentを使って、表示してください。

Dialogを通じてユーザーに発生した問題を通知します。Dialogを閉じると、onActivityResultがコールされてResultを通知します。

?

1 2 3 4 5 6 7

protected void onActivityResult(int requestCode, int resultCode, Intent data) {     if (requestCode == CONNECTION_FAILURE_RESOLUTION_REQUEST) {         if (resultCode == Activity.RESULT_OK) {             // retry process         }     } }