如何为Android考勤APP添加校园地理围栏实现签到验证

一、核心思路 #

地理围栏的本质是定义校园的地理范围，通过判断学生当前GPS位置是否落在该范围内，来决定扫码签到是否有效。无需依赖Maps SDK的可视化功能，用基础定位API即可实现核心逻辑。

二、分步实现 #

1. 定义校园地理边界 #

根据校园实际形态选择围栏类型：

• 圆形围栏：打开手机地图APP定位校园中心，记录经纬度（比如39.9042, 116.4074），再设置半径（比如500米，根据校园大小调整）。
• 多边形围栏：绕校园边界走一圈，记录关键拐点的经纬度（如校门、围墙转角），按顺序组成坐标数组。

2. 集成Android定位功能 #

先在AndroidManifest.xml添加必要权限：

<!-- 高精度定位权限 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!-- 粗略定位权限（ fallback ） -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- Android 10+ 后台定位权限（若需要后台校验） -->
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />

用Google的FusedLocationProviderClient获取当前位置：

private val fusedLocationClient = LocationServices.getFusedLocationProviderClient(this)

// 获取当前位置并触发围栏校验
fun getCurrentLocationForSignIn() {
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) 
        == PackageManager.PERMISSION_GRANTED) {
        fusedLocationClient.lastLocation.addOnSuccessListener { location: Location? ->
            location?.let {
                val isInCampus = checkIfInCampus(it.latitude, it.longitude)
                handleSignInResult(isInCampus)
            }
        }
    }
}

3. 实现围栏内位置判断 #

圆形围栏判断逻辑

计算当前位置到中心点的直线距离，与半径对比：

// 替换为实际校园中心经纬度和半径（单位：米）
private val CAMPUS_CENTER_LAT = 39.9042
private val CAMPUS_CENTER_LNG = 116.4074
private val CAMPUS_RADIUS = 500.0

fun checkIfInCampus(lat: Double, lng: Double): Boolean {
    val distance = FloatArray(1)
    Location.distanceBetween(CAMPUS_CENTER_LAT, CAMPUS_CENTER_LNG, lat, lng, distance)
    return distance[0] <= CAMPUS_RADIUS
}

多边形围栏判断逻辑

用射线法判断点是否在多边形内部：

// 替换为实际校园边界的经纬度点（按顺时针/逆时针顺序排列）
private val CAMPUS_POLYGON = arrayOf(
    LatLng(39.901, 116.402),
    LatLng(39.905, 116.402),
    LatLng(39.905, 116.408),
    LatLng(39.901, 116.408)
)

fun checkIfInCampus(lat: Double, lng: Double): Boolean {
    val point = LatLng(lat, lng)
    var intersectCount = 0
    val polygonSize = CAMPUS_POLYGON.size

    for (i in 0 until polygonSize) {
        val p1 = CAMPUS_POLYGON[i]
        val p2 = CAMPUS_POLYGON[(i + 1) % polygonSize]
        if (isRayIntersect(point, p1, p2)) intersectCount++
    }
    return intersectCount % 2 == 1 // 交点为奇数则在多边形内
}

// 辅助方法：判断射线与线段是否相交
private fun isRayIntersect(point: LatLng, p1: LatLng, p2: LatLng): Boolean {
    val px = point.longitude
    val py = point.latitude
    val x1 = p1.longitude
    val y1 = p1.latitude
    val x2 = p2.longitude
    val y2 = p2.latitude

    if ((y1 > py) != (y2 > py)) {
        val xIntersect = ((py - y1) * (x2 - x1)) / (y2 - y1) + x1
        if (px <= xIntersect) return true
    }
    return false
}

4. 结合扫码签到逻辑 #

在扫码成功的回调中触发定位和校验：

// 扫码成功后的处理逻辑
fun onQrScannedSuccess(qrContent: String) {
    getCurrentLocationForSignIn()
}

// 根据围栏校验结果处理签到
fun handleSignInResult(isInCampus: Boolean) {
    if (isInCampus) {
        // 执行有效签到：上传服务器、更新本地状态等
        Toast.makeText(this, "签到成功", Toast.LENGTH_SHORT).show()
    } else {
        // 提示不在校园，签到无效
        Toast.makeText(this, "You are not at the University", Toast.LENGTH_SHORT).show()
    }
}

三、关键注意事项 #

• 权限引导：首次打开APP时需引导用户授予定位权限，Android 10+需单独申请后台定位权限（若需要后台自动校验）。
• 定位精度：优先使用ACCESS_FINE_LOCATION获取GPS定位，避免网络定位的误差导致误判。
• 边界容错：可将围栏范围扩大100-200米，抵消定位精度误差，避免合法用户无法签到。
• 离线支持：GPS定位无需网络，确保校园内信号差时仍能正常校验。

内容的提问来源于stack exchange，提问作者Mahmoud Hawary