Kotlin获取GPS坐标返回Pair<Double,Double>空值问题求助

问题概述 #

编写的getLocation()函数始终返回Pair<Double,Double>类型空值，有时返回Pair(0.00,0.00)，已在Manifest文件配置所需权限，代码如下：

private fun getLocation(): Pair<Double, Double>? {
    try {
        val locationManager = getSystemService(LOCATION_SERVICE) as LocationManager
        if (!locationManager.isProviderEnabled(LocationManager.GPS_PROVIDER)) {
            // 显示错误信息并返回null
            val builder = AlertDialog.Builder(this)
            builder.setMessage("Please activate your GPS.")
                .setCancelable(false)
                .setPositiveButton("Paramètres") { _, _ ->
                    startActivity(Intent(Settings.ACTION_LOCATION_SOURCE_SETTINGS))
                }
                .setNegativeButton("Cancel") { dialog, _ ->
                    dialog.cancel()
                }
            val alert = builder.create()
            alert.show()
            return null
        }
        // 验证GPS是否激活
        if (!locationManager.isProviderEnabled(LocationManager.GPS_PROVIDER)) {
            // 显示错误提示
            val builder = AlertDialog.Builder(this)
            builder.setMessage("Please activate your GPS for this fonctionality")
                .setCancelable(false)
                .setPositiveButton("Paramètres") { _, _ ->
                    startActivity(Intent(Settings.ACTION_LOCATION_SOURCE_SETTINGS))
                }
                .setNegativeButton("Annuler") { dialog, _ ->
                    dialog.cancel()
                }
            val alert = builder.create()
            alert.show()
            return null
        }

        // 验证应用是否拥有全部权限
        if (ActivityCompat.checkSelfPermission(
                this,
                Manifest.permission.ACCESS_FINE_LOCATION
            ) != PackageManager.PERMISSION_GRANTED
        ) {
            // 请求用户的位置权限授权
            ActivityCompat.requestPermissions(
                this,
                arrayOf(Manifest.permission.ACCESS_FINE_LOCATION),
                1
            )
            return null
        }
       
        val lastKnownLocation =
            locationManager.getLastKnownLocation(LocationManager.GPS_PROVIDER)
                ?: locationManager.getLastKnownLocation(LocationManager.NETWORK_PROVIDER)
                ?: return null
       
        locationManager.requestLocationUpdates(
            LocationManager.GPS_PROVIDER,
            0,
            0f
        ) { location ->
            println("Location: ${location.latitude}, ${location.longitude}")
        }
        
        val lat = lastKnownLocation.latitude
        val long = lastKnownLocation.longitude
        println("Location getlocation: $lat, $long")
        return Pair(lat, long)
    } catch (ex: SecurityException) {
        // 处理未授予ACCESS_FINE_LOCATION权限时抛出的SecurityException异常
        println("Security error : ${ex.message}")
        return null
    } catch (ex: Exception) {
        // 处理LocationManager抛出的其他异常
        println("Cant get location : ${ex.message}")
        return null
    }
}

核心问题分析 #

1. 重复的GPS启用检查：代码中两次执行相同的GPS启用检查，第一次检查后已返回null，第二次检查永远不会执行，属于冗余代码。
2. getLastKnownLocation不可靠：该方法返回设备缓存的历史位置，若设备从未获取过位置或缓存过期，会返回null或(0.0, 0.0)，无法保证获取实时有效位置。
3. 异步位置更新未被利用：调用requestLocationUpdates后，仅在回调中打印位置，但函数已同步返回缓存的lastKnownLocation，实时位置无法传递给调用者。
4. 权限请求后无后续处理：请求权限后直接返回null，用户授予权限后未重新触发位置获取，导致权限生效后仍无法获取位置。

修复方案 #

1. 简化GPS启用检查逻辑 #

移除重复的检查代码，保留一次即可。

2. 改用异步回调获取实时位置 #

位置获取是异步操作，无法通过同步函数直接返回结果，需通过回调或协程传递实时位置。

3. 处理权限请求结果 #

重写onRequestPermissionsResult方法，当权限授予后重新触发位置获取。

4. 添加位置更新监听器移除逻辑 #

避免内存泄漏，在Activity销毁时移除位置更新监听器。

优化后的完整代码 #

// 定义位置回调接口
interface LocationCallback {
    fun onLocationReceived(latitude: Double, longitude: Double)
    fun onLocationFailed(message: String)
}

private lateinit var locationManager: LocationManager
private var locationListener: LocationListener? = null

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    locationManager = getSystemService(LOCATION_SERVICE) as LocationManager
}

private fun getLocation(callback: LocationCallback) {
    try {
        // 检查GPS是否启用
        if (!locationManager.isProviderEnabled(LocationManager.GPS_PROVIDER)) {
            showGpsEnableDialog()
            callback.onLocationFailed("GPS未启用")
            return
        }

        // 检查权限
        if (ActivityCompat.checkSelfPermission(
                this,
                Manifest.permission.ACCESS_FINE_LOCATION
            ) != PackageManager.PERMISSION_GRANTED
        ) {
            ActivityCompat.requestPermissions(
                this,
                arrayOf(Manifest.permission.ACCESS_FINE_LOCATION),
                1
            )
            callback.onLocationFailed("位置权限未授予")
            return
        }

        // 创建位置监听器
        locationListener = object : LocationListener {
            override fun onLocationChanged(location: Location) {
                // 获取到实时位置后，移除监听器
                locationManager.removeUpdates(this)
                callback.onLocationReceived(location.latitude, location.longitude)
            }

            override fun onStatusChanged(provider: String?, status: Int, extras: Bundle?) {}
            override fun onProviderEnabled(provider: String) {}
            override fun onProviderDisabled(provider: String) {}
        }

        // 请求实时位置更新
        locationManager.requestLocationUpdates(
            LocationManager.GPS_PROVIDER,
            0,
            0f,
            locationListener!!
        )

        // 同时尝试获取缓存位置作为 fallback（可选）
        val lastKnownLocation = locationManager.getLastKnownLocation(LocationManager.GPS_PROVIDER)
            ?: locationManager.getLastKnownLocation(LocationManager.NETWORK_PROVIDER)
        lastKnownLocation?.let {
            callback.onLocationReceived(it.latitude, it.longitude)
        }

    } catch (ex: SecurityException) {
        callback.onLocationFailed("权限错误: ${ex.message}")
    } catch (ex: Exception) {
        callback.onLocationFailed("获取位置失败: ${ex.message}")
    }
}

// 显示GPS启用提示对话框
private fun showGpsEnableDialog() {
    AlertDialog.Builder(this)
        .setMessage("请启用GPS以获取位置")
        .setCancelable(false)
        .setPositiveButton("设置") { _, _ ->
            startActivity(Intent(Settings.ACTION_LOCATION_SOURCE_SETTINGS))
        }
        .setNegativeButton("取消") { dialog, _ ->
            dialog.cancel()
        }
        .create()
        .show()
}

// 处理权限请求结果
override fun onRequestPermissionsResult(
    requestCode: Int,
    permissions: Array<out String>,
    grantResults: IntArray
) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults)
    if (requestCode == 1) {
        if (grantResults.isNotEmpty() && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            // 权限授予后，重新获取位置
            getLocation(object : LocationCallback {
                override fun onLocationReceived(latitude: Double, longitude: Double) {
                    // 处理获取到的位置
                }

                override fun onLocationFailed(message: String) {
                    // 处理失败情况
                }
            })
        }
    }
}

// 移除位置监听器，避免内存泄漏
override fun onDestroy() {
    super.onDestroy()
    locationListener?.let {
        locationManager.removeUpdates(it)
    }
}

使用示例 #

调用getLocation时传入回调处理结果：

getLocation(object : LocationCallback {
    override fun onLocationReceived(latitude: Double, longitude: Double) {
        // 这里使用获取到的经纬度
        println("实时位置: $latitude, $longitude")
    }

    override fun onLocationFailed(message: String) {
        println("获取位置失败: $message")
    }
})

内容的提问来源于stack exchange，提问作者Hugo Demont