image.png
LocationManager manager = (LocationManager) getSystemService(Context.LOCATION_SERVICE);
<!-- 授權(quán)獲取定位信息 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
-
boolean addGpsStatusListener(GpsStatus.Listener listener)添加一個(gè)監(jiān)聽 GPS 狀態(tài)的監(jiān)聽器 -
void addProximityAlert(double latitude, double longitude, float radius, long expiration, @NonNull PendingIntent pendingIntent)添加一個(gè)臨近警告 -
List<String> getAllProviders()獲取所有的 LocationProvider 列表 -
String getBestProvider(@NonNull Criteria criteria, boolean enabledOnly)根據(jù)指定條件返回最優(yōu)的 LocationProvider 對(duì)象 -
GpsStatus getGpsStatus(@Nullable GpsStatus status)獲取 GPS 狀態(tài) -
Location getLastKnownLocation(@NonNull String provider)獲取最近一次已知的 Location -
LocationProvider getProvider(@NonNull String provider)根據(jù)名稱來獲取 LocationProvider -
List<String> getProviders(@NonNull Criteria criteria, boolean enabledOnly)根據(jù)指定條件獲取滿足該條件的全部 LocationProvider 的名稱 -
List<String> getProviders(boolean enabledOnly)獲取所有可用的 LocationProvider -
boolean isProviderEnabled(@NonNull String provider)判斷指定名稱的 LocationProvider 是否可用 -
void removeGpsStatusListener(GpsStatus.Listener listener)刪除 GPS 狀態(tài)監(jiān)聽器 -
void removeProximityAlert(@NonNull PendingIntent intent)刪除一個(gè)臨近警告 -
void requestLocationUpdates(@NonNull String provider, long minTimeMs, float minDistanceM, @NonNull PendingIntent pendingIntent)通過指定的 LocationProvider 周期性地獲取定位信息，并通過 intent 啟動(dòng)相應(yīng)的組件 -
void requestLocationUpdates(@NonNull String provider, long minTimeMs, float minDistanceM, @NonNull LocationListener listener)通過指定的 LocationProvider 周期性地獲取定位信息，并觸發(fā) listener 所對(duì)應(yīng)的觸發(fā)器。
LocationProvider（定位提供者）
LocationProvider 對(duì)象就是定位組件的抽象表示，通過 LocationProvider 可以獲取該定位組件的相關(guān)信息。LocationProvider 提供了如下常用方法。
-
int getAccuracy()返回該 LocationProvider 的精度 -
String getName()返回該 LocationProvider 的名稱 -
int getPowerRequirement()獲取該 LocationProvider 的電源需求 -
boolean hasMonetaryCost()返回該 LocationProvider 是收費(fèi)的還是免費(fèi)的 -
boolean meetsCriteria(Criteria criteria)判斷該 LocationProvider 是否滿足 Criteria 條件 -
boolean requiresCell()判斷該 LocationProvider 是否需要訪問網(wǎng)絡(luò)基站 -
boolean requiresNetwork()判斷該 LocationProvider 是否需要網(wǎng)絡(luò)數(shù)據(jù) -
boolean requiresSatellite()判斷該 LocationProvider 是否需要訪問基于衛(wèi)星的定位系統(tǒng) -
boolean supportsAltitude()判斷該 LocationProvider 是否支持高度信息 -
boolean supportsBearing()判斷該 LocationProvider 是否支持方向信息 -
boolean supportsSpeed()判斷該 LocationProvider 是否支持速度信息
Location，它就是一個(gè)代表位置信息的抽象類，提供了如下方法來獲取定位信息。
-
float getAccuracy()獲取定位信息的精度 -
double getAltitude()獲取定位信息的高度 -
float getBearing()獲取定位信息的方向 -
double getLatitude()獲取定位信息的緯度 -
double getLongitude()獲取定位信息的經(jīng)度 -
String getProvider()獲取提供該定位信息的 LocationProvider -
float getSpeed()獲取定位信息的速度 -
boolean hasAccuracy()判斷該定位信息是否有精度信息 -
boolean hasAltitude()判斷該定位信息是否有高度信息 -
boolean hasBearing()判斷該定位信息是否有方向信息 -
boolean hasSpeed()判斷該定位信息是否有速度信息
獲取 GPS 定位信息的通用步驟如下。
- 獲取系統(tǒng)的 LocationManager 對(duì)象。
- 使用 LocationManager，通過指定 LocationProvider 來獲取定位信息，定位信息由Location 對(duì)象來表示。
- 從 Location 對(duì)象中獲取定位信息。
獲取 定位數(shù)據(jù)
public class MainActivity extends AppCompatActivity {
// 定義LocationManager對(duì)象
private LocationManager locManager;
// 定義程序界面中的TextView組件
private TextView show;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// 獲取程序界面上的EditText組件
show = findViewById(R.id.show);
requestPermissions(new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, 0x123);
}
@SuppressLint("MissingPermission")
@Override
public void onRequestPermissionsResult(int requestCode,
@NonNull String[] permissions, @NonNull int[] grantResults) {
// 如果用戶允許使用GPS定位信息
if (requestCode == 0x123 && grantResults.length == 1
&& grantResults[0] == PackageManager.PERMISSION_GRANTED) {
// 創(chuàng)建LocationManager對(duì)象
locManager = (LocationManager) getSystemService(Context.LOCATION_SERVICE);
// 從GPS獲取最近的定位信息
Location location =
locManager.getLastKnownLocation(LocationManager.GPS_PROVIDER);
// 使用location來更新EditText的顯示
updateView(location);
// 設(shè)置每3秒獲取一次GPS定位信息
locManager.requestLocationUpdates(LocationManager.GPS_PROVIDER,
3000, 8f, new LocationListener() // ①
{
@Override
public void onLocationChanged(Location location) {
// 當(dāng)GPS定位信息發(fā)生改變時(shí)，更新位置
updateView(location);
}
@Override
public void onStatusChanged(String provider, int status, Bundle extras) {
}
@Override
public void onProviderEnabled(String provider) {
// 當(dāng)GPS LocationProvider可用時(shí)，更新位置
updateView(locManager.getLastKnownLocation(provider));
}
@Override
public void onProviderDisabled(String provider) {
updateView(null);
}
});
}
}
// 更新EditText中顯示的內(nèi)容
public void updateView(Location newLocation) {
if (newLocation != null) {
String sb = "實(shí)時(shí)的位置信息：\n" +
"經(jīng)度：" +
newLocation.getLongitude() +
"\n緯度：" +
newLocation.getLatitude() +
"\n高度：" +
newLocation.getAltitude() +
"\n速度：" +
newLocation.getSpeed() +
"\n方向：" +
newLocation.getBearing();
show.setText(sb);
} else {
// 如果傳入的Location對(duì)象為空，則清空EditText
show.setText("");
}
}
}
Android 9 新增的室內(nèi) Wi-Fi 定位
Android 9 新增了對(duì) RTT Wi-Fi 協(xié)議的支持，因此運(yùn)行 Android 9 的設(shè)備可支持室內(nèi) Wi-Fi 定位。如果設(shè)備要測(cè)量與 3 個(gè)或更多 Wi-Fi 接入點(diǎn)的距離，則可以使用多點(diǎn)定位算法來對(duì)該設(shè)備進(jìn)行定位。室內(nèi) Wi-Fi 定位的管理器是 WifiRttManager
WifiRttManager wifiRttManager = (WifiRttManager) getSystemService(Context.WIFI_RTT_RANGING_SERVICE);
開始定位
void startRanging(@NonNull RangingRequest request, @NonNull Executor executor, @NonNull RangingResultCallback callback)
- 第 1 個(gè)參數(shù)是
RangingRequest，該參數(shù)代表一個(gè)定位請(qǐng)求。該參數(shù)管理本次定位是基于哪些 Wi-Fi 訪問點(diǎn)（AP）進(jìn)行的。 - 第 2 個(gè)參數(shù)是一個(gè)
Executor對(duì)象，該對(duì)象負(fù)責(zé)使用新線程來執(zhí)行室內(nèi) Wi-Fi 定位，避免阻塞UI線程。 - 第 3 個(gè)參數(shù)是一個(gè)
RangingResultCallback對(duì)象，當(dāng)室內(nèi) Wi-Fi 定位成功或出錯(cuò)時(shí)，將觸發(fā)該對(duì)象內(nèi)特定的方法。
public class MainActivity extends AppCompatActivity {
WifiRttManager mWifiRttManager;
// 定義監(jiān)聽Wi-Fi狀態(tài)改變的BroadcastReceiver
public class WifiChangeReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
if (WifiManager.SCAN_RESULTS_AVAILABLE_ACTION.equals(intent.getAction())) {
// 開始執(zhí)行Wi-Fi定位
startWifiLoc();
}
}
}
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// 定義一個(gè)監(jiān)聽網(wǎng)絡(luò)狀態(tài)改變、Wi-Fi狀態(tài)改變的IntentFilter
IntentFilter wifiFilter = new IntentFilter();
wifiFilter.addAction(WifiManager.NETWORK_STATE_CHANGED_ACTION);
wifiFilter.addAction(WifiManager.WIFI_STATE_CHANGED_ACTION);
wifiFilter.addAction(WifiManager.SCAN_RESULTS_AVAILABLE_ACTION);
// 為IntentFilter注冊(cè)BroadcastReceiver
registerReceiver(new WifiChangeReceiver(), wifiFilter);
}
// 定義執(zhí)行WIFI定位的方法
@SuppressLint("MissingPermission")
private void startWifiLoc() {
// 獲取WIFI管理器
WifiManager wifiManager = (WifiManager) getSystemService(Context.WIFI_SERVICE);
// 判斷是否支持室內(nèi)Wi-Fi定位功能
boolean hasRtt = getPackageManager().hasSystemFeature(
PackageManager.FEATURE_WIFI_RTT);
System.out.println("是否具有室內(nèi)WIFI定位功能：" + hasRtt);
// 只有當(dāng)版本大于Android 9時(shí)候才能使用室內(nèi)WIFI定位功能
if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.P) {
// 獲取室內(nèi)Wi-Fi定位管理器
mWifiRttManager = (WifiRttManager)
getSystemService(Context.WIFI_RTT_RANGING_SERVICE); // ①
RangingRequest request = new RangingRequest.Builder()
// 添加Wi-Fi的掃描結(jié)果（即添加Wi-Fi訪問點(diǎn)）
.addAccessPoints(wifiManager.getScanResults())
// 創(chuàng)建RangingRequest對(duì)象
.build(); // ②
// 開始請(qǐng)求執(zhí)行WIFI室內(nèi)定位
mWifiRttManager.startRanging(request, Executors.newCachedThreadPool(),
new RangingResultCallback() // ③
{
// 如果Wi-Fi定位出錯(cuò)時(shí)觸發(fā)該方法
@Override
public void onRangingFailure(int code) {
}
// 室內(nèi)Wi-Fi定位返回結(jié)果時(shí)觸發(fā)該方法
@Override
public void onRangingResults(@NonNull List<RangingResult> results) {
// 通過RangingResult集合可獲取與特定WIFI接入點(diǎn)之間的距離
for (RangingResult rr : results) {
System.out.println("與" + rr.getMacAddress()
+ "WIFI的距離是:" + rr.getDistanceMm());
}
}
});
}
}
}
<uses-feature android:name="android.hardware.wifi.rtt" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
摘抄至《瘋狂Android講義（第4版）》
