获取最后可知位置

编写:penkzhou - 原文:http://developer.android.com/training/location/retrieve-current.html

使用Google Play services location APIs,我们的应用可以请求获得用户设备的最后可知位置。大多数情况下,我们会对用户的当前位置比较感兴趣。而通常用户的当前位置相当于设备的最后可知位置。

特别地,使用fused location provider来获取设备的最后可知位置。fused location provider是Google Play services location APIs中的一个。它处理基本定位技术并提供一个简单的API,使得我们可以指定高水平的需求,如高精度或者低功耗。同时它优化了设备的耗电情况。

这节课介绍如何通过使用fused location provider的getLastLocation())方法为设备的位置构造一个单一请求。

安装Google Play Services

为了访问fused location provider,我们的应用开发工程必须包括Google Play services。通过SDK Manager下载和安装Google Play services组件,添加相关的库到我们的工程。更详细的介绍,请看Setting Up Google Play Services

确定应用的权限

使用位置服务的应用必须请求用户位置权限。Android拥有两种位置权限:ACCESS_COARSE_LOCATIONACCESS_FINE_LOCATION。我们选择的权限决定API返回的位置信息的精度。如果我们选择了ACCESS_COARSE_LOCATION,API返回的位置信息的精确度大体相当于一个城市街区。

这节课只要求粗略的定位。在我们应用的manifest文件中,用uses-permission节点请求这个权限,如下所示:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.google.android.gms.location.sample.basiclocationsample" >

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

连接Google Play Services

为了连接到API,我们需要创建一个Google Play services API客户端实例。关于使用这个客户端的更详细的介绍,请看Accessing Google APIs

在我们的activity的onCreate())方法中,用GoogleApiClient.Builder创建一个Google API Client实例。使用这个builder添加LocationServices API。

实例应用定义了一个buildGoogleApiClient()方法,这个方法在activity的onCreate()方法中被调用。buildGoogleApiClient()方法包括下面的代码。

protected synchronized void buildGoogleApiClient() {
    mGoogleApiClient = new GoogleApiClient.Builder(this)
        .addConnectionCallbacks(this)
        .addOnConnectionFailedListener(this)
        .addApi(LocationServices.API)
        .build();
}

获取最后可知位置

一旦我们将Google Play services和location services API连接完成后,我们就可以获取用户设备的最后可知位置。当我们的应用连接到这些服务之后,我们可以用fused location provider的getLastLocation())方法来获取设备的位置。调用这个方法返回的定位精确度是由我们在应用的manifest文件里添加的权限决定的,如本文的确定应用的权限部分描述的内容一样。

为了请求最后可知位置,调用getLastLocation())方法,并将我们创建的GoogleApiClient对象的实例传给该方法。在Google API Client提供的onConnected())回调函数里调用getLastLocation())方法,这个回调函数在client准备好的时候被调用。下面的示例代码说明了请求和一个对响应简单的处理:

public class MainActivity extends ActionBarActivity implements
        ConnectionCallbacks, OnConnectionFailedListener {
    ...
    @Override
    public void onConnected(Bundle connectionHint) {
        mLastLocation = LocationServices.FusedLocationApi.getLastLocation(
                mGoogleApiClient);
        if (mLastLocation != null) {
            mLatitudeText.setText(String.valueOf(mLastLocation.getLatitude()));
            mLongitudeText.setText(String.valueOf(mLastLocation.getLongitude()));
        }
    }
}

getLastLocation())方法返回一个Location对象。通过Location对象,我们可以取得地理位置的经度和纬度坐标。在少数情况下,当位置不可用时,这个Location对象会返回null。

下一课,获取位置更新,教你如何周期性地获取位置信息更新。