本文介绍如何在 laravel 应用中，通过 haversine 公式计算用户实时经纬度与数据库中预存位置的距离，并据此判断用户是否处于目标地理围栏范围内。
本文介绍如何在 laravel 应用中，通过 haversine 公式计算用户实时经纬度与数据库中预存位置的距离，并据此判断用户是否处于目标地理围栏范围内。
在实际业务场景（如健康码校验、校区准入、门店签到等）中，仅靠经纬度完全相等（=）匹配往往不可行——GPS 定位存在误差，且用户可能位于目标地点数百米范围内而非精确坐标点上。因此，推荐使用球面距离计算（Haversine 公式），结合可配置的阈值（如 500 米），科学判定用户是否“位于某地点附近”。
✅ 正确实现：距离计算 + 阈值判断
首先，在 App/Helpers/LocationHelper.php 中创建一个复用的静态方法（或直接放在 Controller 中，但建议解耦）：
<?php namespace App\Helpers;
class LocationHelper
{
/**
* 计算两点间球面距离（单位：米）
* @param float $lat1 起点纬度
* @param float $lng1 起点经度
* @param float $lat2 目标纬度
* @param float $lng2 目标经度
* @param float $earthRadius 地球平均半径（米），默认 6371000
* @return float 距离（米）
*/
public static function distanceInMeters($lat1, $lng1, $lat2, $lng2, $earthRadius = 6371000): float
{
$lat1 = deg2rad($lat1);
$lng1 = deg2rad($lng1);
$lat2 = deg2rad($lat2);
$lng2 = deg2rad($lng2);
$latDelta = $lat2 - $lat1;
$lngDelta = $lng2 - $lng1;
$angle = 2 * asin(sqrt(
pow(sin($latDelta / 2), 2) +
cos($lat1) * cos($lat2) * pow(sin($lngDelta / 2), 2)
));
return abs($angle * $earthRadius);
}
}然后，在控制器中调用该方法完成匹配逻辑（注意：需对 $data 做空值和类型校验）：
<?php namespace App\Http\Controllers;
use Illuminate\Http\Request;
use Stevebauman\Location\Facades\Location;
use App\Models\Healthcode; // 确保模型已正确命名并使用
use App\Helpers\LocationHelper;
class HealthController extends Controller
{
public function showHealth(Request $request)
{
$ip = $request->ip() ?: $request->getClientIp(); // 更健壮地获取 IP
$data = Location::get($ip);
// 安全校验：确保获取到有效坐标
if (!$data || !isset($data->latitude, $data->longitude)) {
return view('healthcode', ['isNearby' => false, 'message' => '无法定位您的位置']);
}
$userLat = (float) $data->latitude;
$userLng = (float) $data->longitude;
// 查询所有预设地点，并计算距离
$threshold = 500; // 单位：米（可根据业务调整，如校园范围设为 1000m）
$isNearby = false;
$matchedPlace = null;
foreach (Healthcode::whereNotNull('latitude')->whereNotNull('longitude')->get() as $place) {
$distance = LocationHelper::distanceInMeters(
$userLat,
$userLng,
(float) $place->latitude,
(float) $place->longitude
);
if ($distance place;
break; // 找到第一个匹配即退出（如需全部匹配，可收集数组）
}
}
return view('healthcode', [
'isNearby' => $isNearby,
'matchedPlace' => $matchedPlace,
'distance' => $isNearby ? round($distance, 1) : null,
'data' => $data
]);
}
}⚠️ 注意事项与优化建议
-
数据库字段类型优化：当前迁移中 latitude 和 longitude 使用 string 类型，易导致精度丢失与查询性能低下。请立即修改为 decimal(10,8)（纬度最多 90°，经度最多 180°，8 位小数足够 GPS 精度）：
$table->decimal('latitude', 10, 8)->nullable(); $table->decimal('longitude', 11, 8)->nullable();并运行 php artisan migrate:fresh --seed（开发环境）或 php artisan migrate（生产环境，需配合 change() 方法）。
-
性能优化（大数据量场景）：若地点数量较多（>1000 条），应避免 PHP 循环逐条计算。可改用 MySQL 的 ST_Distance_Sphere（MySQL 5.7+）或 POINT 字段 + 空间索引，实现原生地理查询：
Healthcode::selectRaw('*, ST_Distance_Sphere(point(longitude, latitude), point(?, ?)) as distance', [$userLng, $userLat]) ->having('distance', 'first(); 前端补充定位：服务端 IP 定位精度有限（通常城市级）。建议在前端通过 navigator.geolocation 获取更高精度坐标，并通过 AJAX 提交至后端校验，提升准确性。
异常处理与日志：生产环境务必捕获 Location::get() 的异常（如 API 限流、网络失败），并记录日志，避免因定位服务不可用导致流程中断。
通过以上实现，您即可构建一个鲁棒、可扩展且符合真实地理场景的位置匹配系统，不再依赖脆弱的“坐标完全相等”逻辑。
