W3Cschool
恭喜您成為首批注冊(cè)用戶
獲得88經(jīng)驗(yàn)值獎(jiǎng)勵(lì)
編寫:penkzhou - 原文:http://developer.android.com/training/location/receive-location-updates.html
如果我們的應(yīng)用可以周期性地跟蹤位置,那么應(yīng)用可以給用戶提供更多相關(guān)信息。例如,如果我們的應(yīng)用在用戶行走或者駕車時(shí)幫助找到他們的路,或者如果我們的應(yīng)用跟蹤用戶的位置,那么它需要定期獲取設(shè)備的位置。除了地理位置之外(經(jīng)度和緯度),我們可能還想為用戶提供更多的信息,例如方位(行駛的水平方向)、海拔或者設(shè)備的速度。這些信息可以在 Location 對(duì)象中獲得,我們的應(yīng)用可以從 fused location provider 中得到這個(gè)對(duì)象。
當(dāng)我們用 getLastLocation()) 獲取設(shè)備的位置時(shí),如上一節(jié)課獲取最后可知位置介紹的一樣,一個(gè)更加直接的方法是從 fused location provider 中請(qǐng)求周期性的更新。作為回應(yīng),API根據(jù)現(xiàn)有的位置供應(yīng)源,如Wifi和GPS(Global Positioning System),用最佳位置周期地更新我們的應(yīng)用。這些providers、我們請(qǐng)求的權(quán)限和我們?cè)谖恢谜?qǐng)求中設(shè)置的選項(xiàng)決定了位置的精確度。
這節(jié)課介紹如何用fused location provider的requestLocationUpdates()方法來(lái)請(qǐng)求定期更新設(shè)備的位置。
應(yīng)用的 Location Services 由 Google Play services 和 fused location provider 提供。為了用這些服務(wù),用 Google API Client 連接到我們的應(yīng)用,然后請(qǐng)求位置更新。用 GoogleApiClient 進(jìn)行連接的詳細(xì)步驟請(qǐng)見(jiàn)獲取最后可知位置,包括了請(qǐng)求當(dāng)前位置。
設(shè)備的最后可知位置提供有關(guān)起點(diǎn)的基準(zhǔn)信息,在開(kāi)始定期更新位置信息前,保證應(yīng)用擁有一個(gè)可知的位置。獲取最后可知位置介紹了如何通過(guò)調(diào)用 getLastLocation()) 獲取最后可知位置。接下來(lái)的內(nèi)容假設(shè)我們的應(yīng)用已經(jīng)取得最后可知位置,并已將最后可知位置作為一個(gè) Location 對(duì)象保存在全局變量 mCurrentLocation
中。
使用位置服務(wù)的應(yīng)用必須請(qǐng)求位置權(quán)限。在這節(jié)課中我們需要很好的定位檢測(cè),使得我們的應(yīng)用可以從可用的位置供應(yīng)源得到盡可能精確的位置數(shù)據(jù)。在我們應(yīng)用的manifest文件中,用uses-permission
節(jié)點(diǎn)請(qǐng)求位置權(quán)限,如下所示:
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.google.android.gms.location.sample.locationupdates" >
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
</manifest>
創(chuàng)建一個(gè) LocationRequest 以保存請(qǐng)求 fused location provider 的參數(shù)。這些參數(shù)決定了請(qǐng)求精確度的水平。對(duì)于位置請(qǐng)求中所有可用的選項(xiàng),請(qǐng)見(jiàn) LocationRequest 類的參考文檔。這節(jié)課設(shè)置更新間隔、最快更新間隔和優(yōu)先級(jí)。如下所述:
更新間隔
setInterval()) - 這個(gè)方法設(shè)置應(yīng)用接收位置更新的速率(每毫秒)。注意如果另一個(gè)應(yīng)用正在接收一個(gè)更快的或者更慢的更新速率,又或者根本沒(méi)有更新(例如,設(shè)備還沒(méi)有連接),那么我們應(yīng)用的位置更新速率可能會(huì)比setInterval()
設(shè)置的速率更快。
最快更新間隔
setFastestInterval()) - 這個(gè)方法設(shè)置應(yīng)用可以處理位置更新的最快速率(每毫秒)。因?yàn)槠渌鼞?yīng)用會(huì)影響到已發(fā)送出去的位置更新的速率,所以我們需要設(shè)置這個(gè)最快速率。Google Play services location APIs 發(fā)送任何應(yīng)用用 setInterval()) 請(qǐng)求的最快的更新速率。如果這個(gè)速率比我們的應(yīng)用可以處理的速率還要快,那么我們可能會(huì)遇到UI閃爍或者數(shù)據(jù)溢出等問(wèn)題。為了避免這個(gè)問(wèn)題,調(diào)用 setFastestInterval()) 限制更新速率的上限。
優(yōu)先級(jí)
setPriority()) - 這個(gè)方法設(shè)置請(qǐng)求的優(yōu)先級(jí),為 Google Play services 位置服務(wù)提供了關(guān)于使用哪個(gè)位置源的強(qiáng)烈的暗示。支持下面幾個(gè)值:
PRIORITY_BALANCED_POWER_ACCURACY - 這個(gè)設(shè)置請(qǐng)求一個(gè)城市街區(qū)范圍的位置精確度(精確度約為100米)。這被認(rèn)為是一個(gè)粗略的精確度,也可能是耗電較小的設(shè)置。對(duì)于這個(gè)設(shè)置,位置服務(wù)可能使用 WiFi 和基站進(jìn)行定位。注意,無(wú)論如何,位置供應(yīng)源的選擇依賴于很多其它的因素。
PRIORITY_HIGH_ACCURACY - 這個(gè)設(shè)置請(qǐng)求最高精度的位置信息。對(duì)于這個(gè)設(shè)置,位置服務(wù)更可能使用 GPS(Global Positioning System) 來(lái)定位。
PRIORITY_LOW_POWER - 這個(gè)設(shè)置請(qǐng)求一個(gè)城市范圍的精確度(精確度約為10公里)。這被認(rèn)為是一個(gè)粗略的精確度,也可能是耗電較小的設(shè)置。
PRIORITY_NO_POWER - 如果需要對(duì)功率消耗的影響微乎其微,但又想在可用的時(shí)候接收位置更新,那么使用這個(gè)設(shè)置。對(duì)于這個(gè)設(shè)置,我們的應(yīng)用不會(huì)觸發(fā)任何位置更新,但是會(huì)接收由其它應(yīng)用觸發(fā)的位置。
下面的示例介紹創(chuàng)建位置請(qǐng)求和設(shè)置相關(guān)的參數(shù):
protected void createLocationRequest() {
LocationRequest mLocationRequest = new LocationRequest();
mLocationRequest.setInterval(10000);
mLocationRequest.setFastestInterval(5000);
mLocationRequest.setPriority(LocationRequest.PRIORITY_HIGH_ACCURACY);
}
PRIORITY_HIGH_ACCURACY 的優(yōu)先級(jí)聯(lián)合在我們應(yīng)用的 manifest 文件中定義的 ACCESS_FINE_LOCATION 權(quán)限和一個(gè)5000毫秒(5秒)的更新間隔。該優(yōu)先級(jí)使 fused location provider 返回精確到幾英尺之內(nèi)的位置更新。這個(gè)方法適用于需要實(shí)時(shí)顯示位置的地圖應(yīng)用。
性能提示:如果我們的應(yīng)用在接收一個(gè)位置更新后接入網(wǎng)絡(luò)或者執(zhí)行持續(xù)時(shí)間長(zhǎng)的工作,那么將最快更新間隔調(diào)整到一個(gè)更慢的值。這個(gè)調(diào)整防止我們的應(yīng)用接收不可用的更新。一旦持續(xù)時(shí)間長(zhǎng)的工作完成,將最快更新間隔改回一個(gè)快的值。
我們已經(jīng)設(shè)置了包含應(yīng)用位置更新要求的位置請(qǐng)求,我們可以調(diào)用 requestLocationUpdates() 來(lái)啟動(dòng)周期性的更新。在 Google API Client 提供的 onConnected()) 回調(diào)函數(shù)(當(dāng) client 準(zhǔn)備好之后會(huì)調(diào)用這個(gè)回調(diào)函數(shù))中啟動(dòng)周期性更新。
根據(jù)請(qǐng)求的形式,fused location provider 要么調(diào)用 LocationListener.onLocationChanged() 回調(diào)函數(shù)并傳遞一個(gè) Location 對(duì)象,要么發(fā)出一個(gè)將位置信息包含在擴(kuò)展數(shù)據(jù)的 PendingIntent。更新的精確度和頻率受已請(qǐng)求的位置權(quán)限和在位置請(qǐng)求對(duì)象中設(shè)置的選項(xiàng)等因素影響。
這節(jié)課介紹如何使用 LocationListener 回調(diào)函數(shù)獲取位置更新。調(diào)用 requestLocationUpdates() ,并傳入 GoogleApiClient 的實(shí)例、LocationRequest 對(duì)象和一個(gè) LocationListener。定義一個(gè) startLocationUpdates()
方法,該方法在 onConnected()) 回調(diào)函數(shù)被調(diào)用,如下面的示例代碼所示:
@Override
public void onConnected(Bundle connectionHint) {
...
if (mRequestingLocationUpdates) {
startLocationUpdates();
}
}
protected void startLocationUpdates() {
LocationServices.FusedLocationApi.requestLocationUpdates(
mGoogleApiClient, mLocationRequest, this);
}
注意到上述的代碼片段提到一個(gè)布爾標(biāo)志位,mRequestingLocationUpdates
,該標(biāo)志位用于判斷用戶將位置更新打開(kāi)還是關(guān)閉。關(guān)于這個(gè)標(biāo)志位更詳細(xì)的介紹,請(qǐng)見(jiàn)下面的保存 Activity 的狀態(tài)的內(nèi)容。
fused location provider 調(diào)用 LocationListener.onLocationChanged()) 回調(diào)函數(shù)。這個(gè)回調(diào)函數(shù)傳入的參數(shù)是一個(gè)含有位置經(jīng)緯度的 Location 對(duì)象。下面的代碼介紹了如何實(shí)現(xiàn) LocationListener 接口和定義方法,然后獲取位置更新的時(shí)間戳并在應(yīng)用用戶界面上顯示經(jīng)度、緯度和時(shí)間戳:
public class MainActivity extends ActionBarActivity implements
ConnectionCallbacks, OnConnectionFailedListener, LocationListener {
...
@Override
public void onLocationChanged(Location location) {
mCurrentLocation = location;
mLastUpdateTime = DateFormat.getTimeInstance().format(new Date());
updateUI();
}
private void updateUI() {
mLatitudeTextView.setText(String.valueOf(mCurrentLocation.getLatitude()));
mLongitudeTextView.setText(String.valueOf(mCurrentLocation.getLongitude()));
mLastUpdateTimeTextView.setText(mLastUpdateTime);
}
}
我們需要考慮當(dāng) activity 不在焦點(diǎn)上時(shí)我們是否需要停止位置更新,例如,當(dāng)用戶切換到另一個(gè)應(yīng)用或者同一個(gè)應(yīng)用的不同 activity 的情況。假如應(yīng)用即使在后臺(tái)運(yùn)行時(shí)也不需要收集用戶數(shù)據(jù),將會(huì)有利于降低功耗。這節(jié)課會(huì)介紹如何在 activity 的 onPause()) 方法里停止位置更新。
為了停止位置更新,調(diào)用 removeLocationUpdates(),并傳入 GoogleApiClient 對(duì)象的實(shí)例和一個(gè) LocationListener,如下面的示例代碼所示:
@Override
protected void onPause() {
super.onPause();
stopLocationUpdates();
}
protected void stopLocationUpdates() {
LocationServices.FusedLocationApi.removeLocationUpdates(
mGoogleApiClient, this);
}
使用一個(gè)布爾值,mRequestingLocationUpdates
,來(lái)判斷當(dāng)前位置更新是否打開(kāi)。在 activity 的 onResume()) 方法里,檢查當(dāng)前的位置更新是否起作用。如果位置更新不起作用,那么激活它:
@Override
public void onResume() {
super.onResume();
if (mGoogleApiClient.isConnected() && !mRequestingLocationUpdates) {
startLocationUpdates();
}
}
一個(gè)設(shè)備配置的變動(dòng),如旋轉(zhuǎn)屏幕或者改變語(yǔ)言,可以導(dǎo)致當(dāng)前的 activity 崩潰。我們的應(yīng)用必須保存任何在重新創(chuàng)建 activity 時(shí)需要用到的信息。一種方法是通過(guò)一個(gè)保存在 Bundle 對(duì)象的實(shí)例狀態(tài)來(lái)解決這個(gè)問(wèn)題。
下面的示例代碼介紹了如何用 activity 的 onSaveInstanceState()) 回調(diào)函數(shù)來(lái)保存實(shí)例狀態(tài):
public void onSaveInstanceState(Bundle savedInstanceState) {
savedInstanceState.putBoolean(REQUESTING_LOCATION_UPDATES_KEY,
mRequestingLocationUpdates);
savedInstanceState.putParcelable(LOCATION_KEY, mCurrentLocation);
savedInstanceState.putString(LAST_UPDATED_TIME_STRING_KEY, mLastUpdateTime);
super.onSaveInstanceState(savedInstanceState);
}
定義一個(gè) updateValuesFromBundle()
方法來(lái)恢復(fù)保存在 activity 的上一個(gè)實(shí)例的值(如果這些值可用的話)。在 onCreate()) 中調(diào)用這個(gè)方法。如下所示:
@Override
public void onCreate(Bundle savedInstanceState) {
...
updateValuesFromBundle(savedInstanceState);
}
private void updateValuesFromBundle(Bundle savedInstanceState) {
if (savedInstanceState != null) {
// Update the value of mRequestingLocationUpdates from the Bundle, and
// make sure that the Start Updates and Stop Updates buttons are
// correctly enabled or disabled.
if (savedInstanceState.keySet().contains(REQUESTING_LOCATION_UPDATES_KEY)) {
mRequestingLocationUpdates = savedInstanceState.getBoolean(
REQUESTING_LOCATION_UPDATES_KEY);
setButtonsEnabledState();
}
// Update the value of mCurrentLocation from the Bundle and update the
// UI to show the correct latitude and longitude.
if (savedInstanceState.keySet().contains(LOCATION_KEY)) {
// Since LOCATION_KEY was found in the Bundle, we can be sure that
// mCurrentLocationis not null.
mCurrentLocation = savedInstanceState.getParcelable(LOCATION_KEY);
}
// Update the value of mLastUpdateTime from the Bundle and update the UI.
if (savedInstanceState.keySet().contains(LAST_UPDATED_TIME_STRING_KEY)) {
mLastUpdateTime = savedInstanceState.getString(
LAST_UPDATED_TIME_STRING_KEY);
}
updateUI();
}
}
更多關(guān)于保存實(shí)例狀態(tài)的內(nèi)容,請(qǐng)看 Android Activity 類的參考文檔。
Note:為了可以更加持久地存儲(chǔ),我們可以將用戶的偏好設(shè)定保存在應(yīng)用的 SharedPreferences 中。在 activity 的 onPause()) 方法中設(shè)置偏好設(shè)定,在 onResume()) 中獲取這些設(shè)定。更多關(guān)于偏好設(shè)定的內(nèi)容,請(qǐng)見(jiàn)保存到 Rreference。
下一節(jié)課,顯示位置地址,介紹如何顯示指定位置的街道地址。
Copyright©2021 w3cschool編程獅|閩ICP備15016281號(hào)-3|閩公網(wǎng)安備35020302033924號(hào)
違法和不良信息舉報(bào)電話:173-0602-2364|舉報(bào)郵箱:jubao@eeedong.com
掃描二維碼
下載編程獅App
編程獅公眾號(hào)
聯(lián)系方式:
更多建議: