9.3.2 LocationManager应用示例
最后更新于：2022-04-02 06:06:17
本节所使用的示例运行后的界面如图9-30所示。
:-: 
图9-30 示例运行效果
* 左边按钮为"Fine-grain provider"，表示通过GpsLP来获取位置信息。
* 右边按钮为"Both Providers"，表示同时使用GpsLP和NetworkLP来获取位置信息。
* 按钮下方的"Lat/Long"表示当前设备的位置信息（经纬度值），而"Address"表示根据该位置信息得到的地址信息。
示例非常简单，所有内容都集中在LocationActivity.java文件中。先来看onCreate函数，代码如下所示。
**LocationActivity.java：：onCreate**
~~~
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
......// UI 等初始化
// Geocoder：只有Android 2.3版本以后系统才支持该功能
// 同时还需要判断是否存在GeocoderProvider
mGeocoderAvailable =
Build.VERSION.SDK_INT >= Build.VERSION_CODES.GINGERBREAD &&
Geocoder.isPresent();
mHandler = new Handler() {......// Handler的作用是更新图9-30中的位置和地址信息};
// 客户端必须要获取LocationManager来和LMS交互
mLocationManager = (LocationManager) getSystemService(Context.LOCATION_SERVICE);
}
}
~~~
接着，LocationActivity在其onResume中将调用setup函数完成进一步的初始化工作，其代码如下所示。
**LocationActivity.java：：setup**
~~~
private void setup() {
Location gpsLocation = null; Location networkLocation = null;
mLocationManager.removeUpdates(listener);
mLatLng.setText(R.string.unknown); mAddress.setText(R.string.unknown);
if (mUseFine) { // mUseFine对应为图9-30中的“Fine-grain Provider”按钮
......
// requestUpdatesFromProvider为关键函数，下文将详细分析
gpsLocation = requestUpdatesFromProvider(
LocationManager.GPS_PROVIDER,// 该参数为字符串，值为“gps”
R.string.not_support_gps);
if (gpsLocation != null) updateUILocation(gpsLocation);
} else if (mUseBoth) {// mUseBoth对应为图9-30中的“Both Providers”按钮
gpsLocation = requestUpdatesFromProvider(LocationManager.GPS_PROVIDER, R.string.not_support_gps);
networkLocation = requestUpdatesFromProvider(
LocationManager.NETWORK_PROVIDER, // 该参数值为“network”
R.string.not_support_network);
......
}
}
~~~
看setup中的关键函数requestUpdatesFromProvider代码如下所示。
**LocationActivity.java：：requestUpdatesFromProvider**
~~~
private Location requestUpdatesFromProvider(final String provider,
final int errorResId) {
Location location = null;
// 判断由provider指定的LP是否启用。
if (mLocationManager.isProviderEnabled(provider)) {
/*
调用LocationManager的requestLocationUpdates函数，该函数用于注册一个回调函数以
接收位置变化信息，其各个参数的作用如下。
provider：用于指明使用哪个LP，目前可取参数有“gps”（对应为GpsLP）、“network”（对应
为NetworkLP）、“passive”（对应为PassiveProvider）。
TEN_SECONDS:用于指明多少毫秒更新一次位置数据，本例中使用的值为10秒。
TEN_METERS：用于指明位置变化多少时更新一次数据，本例中使用的值为10米。
listener：类型为LocationListener，当位置发生变化时，其onLocationChanged函数将被调用。
*/
mLocationManager.requestLocationUpdates(provider, TEN_SECONDS,
TEN_METERS,listener);
// getLastKnownLocation用于获取LP上一次保存的位置信息数据
// Android平台中，位置信息用Location类表示
location = mLocationManager.getLastKnownLocation(provider);
}
return location;
}
~~~
requestLocationUpdates是LM中非常重要的函数，请读者务必把握其用法。
当位置信息发生变化后，LocationListener的onChange函数将被调用。本例中使用的LocationListener相关代码如下所示。
**LocationActivity.java：：LocationListener**
~~~
private final LocationListener listener = new LocationListener() {
public void onLocationChanged(Location location) {
updateUILocation(location);// 下文将分析它
}
// 当用户在设置中启用或禁止相关LocationProvider后，下面这两个函数将被调用
public void onProviderEnabled(String provider) { }
public void onProviderDisabled(String provider) { }
// 当LocationProvider的状态发生变化时，下面这个函数将被调用
public void onStatusChanged(String provider, int status, Bundle extras) {}
};
~~~
updateUILocation函数代码如下所示。
**LocationActivity.java：：updateUILocation**
~~~
private void updateUILocation(Location location) {
// updateUILocation的参数location代表对应LP得到的位置信息
// 示例程序将根据该信息来更新图9-30中“Lat/Long”的值
Message.obtain(mHandler, UPDATE_LATLNG,
location.getLatitude() + ", " + location.getLongitude()).sendToTarget();
// doReverseGeocoding根据位置信息来获取地址信息
if (mGeocoderAvailable) doReverseGeocoding(location);
}
~~~
doReverseGeocoding用于根据位置信息来获取地址信息，由于该工作往往需要通过网络来查询，所以doReverseGeocoding内部将创建一个AsyncTask用来完成此工作。我们直接来看AsyncTask的代码。
**LocationActivity.java：：ReverseGeocodingTask**
~~~
private class ReverseGeocodingTask extends AsyncTask {
Context mContext;
......
protected Void doInBackground(Location... params) {
// 创建一个Geocoder对象，它可用于处理地址信息和位置信息的转换
Geocoder geocoder = new Geocoder(mContext, Locale.getDefault());
Location loc = params[0];
List addresses = null;
try {
// getFromLocation用于根据位置信息来查询对应的地址信息
addresses = geocoder.getFromLocation(loc.getLatitude(), loc.getLongitude(), 1);
} ......
if (addresses != null && addresses.size() > 0) {
Address address = addresses.get(0);
String addressText = String.format("%s, %s, %s",
address.getMaxAddressLineIndex() > 0 ? address.getAddressLine(0) : "",
address.getLocality(),address.getCountryName());
// 更新图9-30中的“Address”信息
Message.obtain(mHandler, UPDATE_ADDRESS, addressText).sendToTarget();
}
return null;
}
}
~~~
通过上述示例可以发现，Android平台中使用LM非常简单，其主要工作如下。
1. 先创建一个LocationManager对象，用于和LMS交互。
2. 然后调用requestLocationUpdates以设置一个回调接口对象LocationListener，同时还需要指明使用哪个LP[^①]。
3. 当LP更新相关信息后，LocationListener对应的函数将被调用，应用程序在这些回调函数中做相关处理即可。
4. 如果应用程序需要在位置和地址信息做转换，则使用Geocoder类提供的函数即可。
虽然LM比较简单，但它提供的都是一些很基本的功能，如果想实现一些诸如显示地图信息这样的功能，LM就无能为力了。为了实现一些更复杂的位置相关的功能，Google提供了更高级的API来帮助开发者。关于这一部分内容，建议读者阅读参考资料[30]。
[^①]:根据审稿专家的意见，有些应用会只传进定位的条件（精度），而不去指定使用哪个LP。在不带GPS功能的平台，若应用只指定从GPS中获取定位数据，则它将得不到位置信息。
';