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版)》
网友评论