定位服务API案例
要使用定位服务API,需要确保设备已经下载并安装了HMS Core服务组件,并将Location Kit的SDK集成到项目中。
指定应用权限
- Android提供了两种位置权限: ACCESS_COARSE_LOCATION(粗略的位置权限)和ACCESS_FINE_LOCATION(精确的位置权限)。需要在“AndroidManifest.xml”文件中申请权限:
- 在Android Q版本中,如果需要应用程序在后台执行时也具备持续定位能力,需要在“AndroidManifest.xml”文件中申请ACCESS_BACKGROUND_LOCATION权限:
- 在“AndroidManifest.xml”中添加后,还要在代码中动态申请一下权限(Android 6.0危险权限要求):
- // Android SDK<=28 所需权限动态申请
- if (Build.VERSION.SDK_INT <= Build.VERSION_CODES.P) {
-
Log.i(TAG, "android sdk <= 28 Q");
-
if (ActivityCompat.checkSelfPermission(this,
-
Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED
-
&& ActivityCompat.checkSelfPermission(this,
-
Manifest.permission.ACCESS_COARSE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
-
String[] strings =
-
{Manifest.permission.ACCESS_FINE_LOCATION, Manifest.permission.ACCESS_COARSE_LOCATION};
-
ActivityCompat.requestPermissions(this, strings, 1);
-
}
- } else {
-
// Android SDK>28 所需权限动态申请,需添加“android.permission.ACCESS_BACKGROUND_LOCATION”权限
-
if (ActivityCompat.checkSelfPermission(this,
-
Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED
-
&& ActivityCompat.checkSelfPermission(this,
-
Manifest.permission.ACCESS_COARSE_LOCATION) != PackageManager.PERMISSION_GRANTED
-
&& ActivityCompat.checkSelfPermission(this,
-
"android.permission.ACCESS_BACKGROUND_LOCATION") != PackageManager.PERMISSION_GRANTED) {
-
String[] strings = {android.Manifest.permission.ACCESS_FINE_LOCATION,
-
android.Manifest.permission.ACCESS_COARSE_LOCATION,
-
"android.permission.ACCESS_BACKGROUND_LOCATION"};
-
ActivityCompat.requestPermissions(this, strings, 2);
-
}
- }
创建定位服务客户端
在项目中使用到定位服务的Activity中的onCreate()方法中创建一个FusedLocationProviderClient实例,通过该实例调用定位相关接口。 - // 定位交互接入对象
- private FusedLocationProviderClient fusedLocationProviderClient;
- // 定位请求信息对象
- private LocationRe