image.png
LocationManager manager = (LocationManager) getSystemService(Context.LOCATION_SERVICE);
<!-- 授权获取定位信息 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
-
boolean addGpsStatusListener(GpsStatus.Listener listener)添加一个监听 GPS 状态的监听器 -
void addProximityAlert(double latitude, double longitude, float radius, long expiration, @NonNull PendingIntent pendingIntent)添加一个临近警告 -
List<String> getAllProviders()获取所有的 LocationProvider 列表 -
String getBestProvider(@NonNull Criteria criteria, boolean enabledOnly)根据指定条件返回最优的 LocationProvider 对象 -
GpsStatus getGpsStatus(@Nullable GpsStatus status)获取 GPS 状态 -
Location getLastKnownLocation(@NonNull String provider)获取最近一次已知的 Location -
LocationProvider getProvider(@NonNull String provider)根据名称来获取 LocationProvider -
List<String> getProviders(@NonNull Criteria criteria, boolean enabledOnly)根据指定条件获取满足该条件的全部 LocationProvider 的名称 -
List<String> getProviders(boolean enabledOnly)获取所有可用的 LocationProvider -
boolean isProviderEnabled(@NonNull String provider)判断指定名称的 LocationProvider 是否可用 -
void removeGpsStatusListener(GpsStatus.Listener listener)删除 GPS 状态监听器 -
void removeProximityAlert(@NonNull PendingIntent intent)删除一个临近警告 -
void requestLocationUpdates(@NonNull String provider, long minTimeMs, float minDistanceM, @NonNull PendingIntent pendingIntent)通过指定的 LocationProvider 周期性地获取定位信息，并通过 intent 启动相应的组件 -
void requestLocationUpdates(@NonNull String provider, long minTimeMs, float minDistanceM, @NonNull LocationListener listener)通过指定的 LocationProvider 周期性地获取定位信息，并触发 listener 所对应的触发器。
LocationProvider（定位提供者）
LocationProvider 对象就是定位组件的抽象表示，通过 LocationProvider 可以获取该定位组件的相关信息。LocationProvider 提供了如下常用方法。
-
int getAccuracy()返回该 LocationProvider 的精度 -
String getName()返回该 LocationProvider 的名称 -
int getPowerRequirement()获取该 LocationProvider 的电源需求 -
boolean hasMonetaryCost()返回该 LocationProvider 是收费的还是免费的 -
boolean meetsCriteria(Criteria criteria)判断该 LocationProvider 是否满足 Criteria 条件 -
boolean requiresCell()判断该 LocationProvider 是否需要访问网络基站 -
boolean requiresNetwork()判断该 LocationProvider 是否需要网络数据 -
boolean requiresSatellite()判断该 LocationProvider 是否需要访问基于卫星的定位系统 -
boolean supportsAltitude()判断该 LocationProvider 是否支持高度信息 -
boolean supportsBearing()判断该 LocationProvider 是否支持方向信息 -
boolean supportsSpeed()判断该 LocationProvider 是否支持速度信息
Location，它就是一个代表位置信息的抽象类，提供了如下方法来获取定位信息。
-
float getAccuracy()获取定位信息的精度 -
double getAltitude()获取定位信息的高度 -
float getBearing()获取定位信息的方向 -
double getLatitude()获取定位信息的纬度 -
double getLongitude()获取定位信息的经度 -
String getProvider()获取提供该定位信息的 LocationProvider -
float getSpeed()获取定位信息的速度 -
boolean hasAccuracy()判断该定位信息是否有精度信息 -
boolean hasAltitude()判断该定位信息是否有高度信息 -
boolean hasBearing()判断该定位信息是否有方向信息 -
boolean hasSpeed()判断该定位信息是否有速度信息
获取 GPS 定位信息的通用步骤如下。
- 获取系统的 LocationManager 对象。
- 使用 LocationManager，通过指定 LocationProvider 来获取定位信息，定位信息由Location 对象来表示。
- 从 Location 对象中获取定位信息。
获取 定位数据
public class MainActivity extends AppCompatActivity {
// 定义LocationManager对象
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) {
// 创建LocationManager对象
locManager = (LocationManager) getSystemService(Context.LOCATION_SERVICE);
// 从GPS获取最近的定位信息
Location location =
locManager.getLastKnownLocation(LocationManager.GPS_PROVIDER);
// 使用location来更新EditText的显示
updateView(location);
// 设置每3秒获取一次GPS定位信息
locManager.requestLocationUpdates(LocationManager.GPS_PROVIDER,
3000, 8f, new LocationListener() // ①
{
@Override
public void onLocationChanged(Location location) {
// 当GPS定位信息发生改变时，更新位置
updateView(location);
}
@Override
public void onStatusChanged(String provider, int status, Bundle extras) {
}
@Override
public void onProviderEnabled(String provider) {
// 当GPS LocationProvider可用时，更新位置
updateView(locManager.getLastKnownLocation(provider));
}
@Override
public void onProviderDisabled(String provider) {
updateView(null);
}
});
}
}
// 更新EditText中显示的内容
public void updateView(Location newLocation) {
if (newLocation != null) {
String sb = "实时的位置信息：\n" +
"经度：" +
newLocation.getLongitude() +
"\n纬度：" +
newLocation.getLatitude() +
"\n高度：" +
newLocation.getAltitude() +
"\n速度：" +
newLocation.getSpeed() +
"\n方向：" +
newLocation.getBearing();
show.setText(sb);
} else {
// 如果传入的Location对象为空，则清空EditText
show.setText("");
}
}
}
Android 9 新增的室内 Wi-Fi 定位
Android 9 新增了对 RTT Wi-Fi 协议的支持，因此运行 Android 9 的设备可支持室内 Wi-Fi 定位。如果设备要测量与 3 个或更多 Wi-Fi 接入点的距离，则可以使用多点定位算法来对该设备进行定位。室内 Wi-Fi 定位的管理器是 WifiRttManager
WifiRttManager wifiRttManager = (WifiRttManager) getSystemService(Context.WIFI_RTT_RANGING_SERVICE);
开始定位
void startRanging(@NonNull RangingRequest request, @NonNull Executor executor, @NonNull RangingResultCallback callback)
- 第 1 个参数是
RangingRequest，该参数代表一个定位请求。该参数管理本次定位是基于哪些 Wi-Fi 访问点（AP）进行的。 - 第 2 个参数是一个
Executor对象，该对象负责使用新线程来执行室内 Wi-Fi 定位，避免阻塞UI线程。 - 第 3 个参数是一个
RangingResultCallback对象，当室内 Wi-Fi 定位成功或出错时，将触发该对象内特定的方法。
public class MainActivity extends AppCompatActivity {
WifiRttManager mWifiRttManager;
// 定义监听Wi-Fi状态改变的BroadcastReceiver
public class WifiChangeReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
if (WifiManager.SCAN_RESULTS_AVAILABLE_ACTION.equals(intent.getAction())) {
// 开始执行Wi-Fi定位
startWifiLoc();
}
}
}
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// 定义一个监听网络状态改变、Wi-Fi状态改变的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注册BroadcastReceiver
registerReceiver(new WifiChangeReceiver(), wifiFilter);
}
// 定义执行WIFI定位的方法
@SuppressLint("MissingPermission")
private void startWifiLoc() {
// 获取WIFI管理器
WifiManager wifiManager = (WifiManager) getSystemService(Context.WIFI_SERVICE);
// 判断是否支持室内Wi-Fi定位功能
boolean hasRtt = getPackageManager().hasSystemFeature(
PackageManager.FEATURE_WIFI_RTT);
System.out.println("是否具有室内WIFI定位功能：" + hasRtt);
// 只有当版本大于Android 9时候才能使用室内WIFI定位功能
if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.P) {
// 获取室内Wi-Fi定位管理器
mWifiRttManager = (WifiRttManager)
getSystemService(Context.WIFI_RTT_RANGING_SERVICE); // ①
RangingRequest request = new RangingRequest.Builder()
// 添加Wi-Fi的扫描结果（即添加Wi-Fi访问点）
.addAccessPoints(wifiManager.getScanResults())
// 创建RangingRequest对象
.build(); // ②
// 开始请求执行WIFI室内定位
mWifiRttManager.startRanging(request, Executors.newCachedThreadPool(),
new RangingResultCallback() // ③
{
// 如果Wi-Fi定位出错时触发该方法
@Override
public void onRangingFailure(int code) {
}
// 室内Wi-Fi定位返回结果时触发该方法
@Override
public void onRangingResults(@NonNull List<RangingResult> results) {
// 通过RangingResult集合可获取与特定WIFI接入点之间的距离
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版）》
