Day 23：获取位置权限

本篇文章同步发表在 HKT 线上教室部落格，线上影音教学课程已上架至 Udemy 和 Youtube 频道。另外，想追踪更多相关技术资讯，欢迎到脸书粉丝专页按赞追踪喔～

程序码范例

范例名称：获取位置权限
开发人员：HKT (侯光灿)
程序语言：Kotlin
开发环境：Android Studio 4.1.2 & Android 11 & Kotlin 1.4.30
授权范围：使用时必须注明出处且不得为商业目的之使用
范例下载点：点我下载

在之前的介绍当中，我们主要的重心是放在，如何在滚动式列表上呈现药局资讯。而在接下来的重心，我们将会放在，如何在 Google Map 地图上，呈现药局地点与药局相关资讯。将会依序的跟大家介绍：

如何获取装置位置权限
如何检查 GPS 状态
如何获取装置经纬度座标位置
如何在 Google Map 上显示药局相关资讯

所以今天要先来跟大家介绍第一个部分，如何获取使用者位置权限，除了要在 AndroidManifest.xml 宣告外，因为「位置权限」被列属为危险权限，从 Android 6 (SDK 23)以上，需要特别额外跟使用询问获取，否则会因权限不足，而造成 APP 闪退。详细权限级别，可以查阅官网文件： Manifest.permission。

获取 APP 权限方法

获取 APP 权限，主要分成这四个部分。

checkSelfPermission

检查我们的APP，是否获得权限

shouldShowRequestPermissionRationale

是否要显示更多说明解释为何此权限对话视窗。收到 true，代表需要跟使用者显示更多说明解释为何此权限对话视窗，收到 false，代表不需额外显示给使用者说明。

使用情境:

第一次询问权限，这个值会收到 false。
第一次询问，用户选择「拒绝」，这个值会收到 true。则需要显示客制对话视窗，在视窗中解释为何需要此权限。
用户允许权限後或是选择「拒绝且不在询问」後，这个值会收到 false。

requestPermissions

要求用户给我们APP使用权限

onRequestPermissionsResult

覆写此方法，要求权限後，会收到用户决定是否给权限的结果 CallBack

AndroidManifest.xml

获取位置权限，需要先在 AndroidManifest.xml 里，加入此宣告。位置权限有两种，一个是概略位置存取权（ACCESS_COARSE_LOCATION）和另一个精确位置存取（ACCESS_FINE_LOCATION），择一即可，我们选择精确定位权限。

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

MapActivity.kt

我们先新开一个空白的 Activity 页面，档名为 MapActivity，并在 AndroidManifest.xml 里将启动载入Activity，更改为此 Activity。

<activity android:name=".MapActivity">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

检查有无权限

透过 checkSelfPermission 方法，检查有无精准位置（ACCESS_FINE_LOCATION）权限，若没有则询问使用者要求获取权限，若获得 locationPermissionGranted 设定为 true。

private var locationPermissionGranted = false

...
...
...

private fun getLocationPermission() {
    //检查权限
    if (ActivityCompat.checkSelfPermission(
            this,
            Manifest.permission.ACCESS_FINE_LOCATION
        ) == PackageManager.PERMISSION_GRANTED
    ) {
        //已获取到权限
        Toast.makeText(this, "已获取到位置权限，可以准备开始获取经纬度", Toast.LENGTH_SHORT).show()
        locationPermissionGranted = true
        //todo checkGPSState()
    } else {
        //询问要求获取权限
        requestLocationPermission()
    }
}

询问要求获取权限

private fun requestLocationPermission() {
    if (ActivityCompat.shouldShowRequestPermissionRationale(
            this, Manifest.permission.ACCESS_FINE_LOCATION
        )
    ) {
        AlertDialog.Builder(this)
            .setMessage("此应用程序，需要位置权限才能正常使用")
            .setPositiveButton("确定") { _, _ ->
                ActivityCompat.requestPermissions(
                    this, arrayOf(Manifest.permission.ACCESS_FINE_LOCATION),
                    REQUEST_LOCATION_PERMISSION
                )
            }
            .setNegativeButton("取消") { _, _ -> requestLocationPermission() }
            .show()
    } else {
        ActivityCompat.requestPermissions(
            this, arrayOf(Manifest.permission.ACCESS_FINE_LOCATION), REQUEST_LOCATION_PERMISSION
        )
    }
}

处理权限 CallBack

override fun onRequestPermissionsResult(
    requestCode: Int, permissions: Array<out String>, grantResults: IntArray
) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults)

    when (requestCode) {
        REQUEST_LOCATION_PERMISSION -> {
            if (grantResults.isNotEmpty()) {
                if (grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                    //已获取到权限
                    locationPermissionGranted = true
                    //todo checkGPSState()
                } else if (grantResults[0] == PackageManager.PERMISSION_DENIED) {
                    if (!ActivityCompat.shouldShowRequestPermissionRationale(
                            this,
                            Manifest.permission.ACCESS_FINE_LOCATION
                        )
                    ) {
                        //权限被永久拒绝
                        Toast.makeText(this, "位置权限已被关闭，功能将会无法正常使用", Toast.LENGTH_SHORT).show()

                        AlertDialog.Builder(this)
                            .setTitle("开启位置权限")
                            .setMessage("此应用程序，位置权限已被关闭，需开启才能正常使用")
                            .setPositiveButton("确定") { _, _ ->
                                val intent = Intent(Settings.ACTION_LOCATION_SOURCE_SETTINGS)
                                startActivityForResult(intent, REQUEST_LOCATION_PERMISSION)
                            }
                            .setNegativeButton("取消") { _, _ -> requestLocationPermission() }
                            .show()
                    } else {
                        //权限被拒绝
                        Toast.makeText(this, "位置权限被拒绝，功能将会无法正常使用", Toast.LENGTH_SHORT).show()
                        requestLocationPermission()
                    }
                }
            }
        }
    }
}

处理设定回来 CallBack

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    when (requestCode) {
        REQUEST_LOCATION_PERMISSION -> {
            getLocationPermission()
        }
    }
}