需先将gcj-02坐标纠偏为wgs-84再计算距离，封装haversine函数并返回米制结果，大数据量时优先用mysql的st_distance_sphere优化查询，地址与坐标转换须加redis缓存和失败兜底。
确认坐标系并做必要纠偏
国内地图服务（如高德、腾讯）返回的经纬度默认是GCJ-02坐标系，而标准地理计算（如Haversine公式）要求WGS-84。若直接用高德坐标算距离，误差可能达300–500米。ThinkPHP6本身不自动纠偏，需主动调用高德/腾讯提供的坐标转换接口（如/geoconv），把原始坐标转为WGS-84后再参与计算。
封装可靠的两点距离计算函数
不要手写未验证的三角运算。推荐在服务类中定义getDistance()方法，核心要点包括：
- 输入参数统一转为弧度：
deg2rad($lat1)、deg2rad($lng1)等 - 使用Haversine公式，避免欧氏距离在球面上的严重失真
- 返回单位建议设为“米”，便于后续按范围筛选（如
WHERE distance ） - 示例关键行：
return 6371 * $c * 1000;（6371为地球平均半径，×1000得米）
数据库层优先用ST_Distance_Sphere优化查询
当需查“附近门店”且数据量较大时，别在PHP里遍历计算。MySQL 5.7+支持地理空间函数，可直接在SQL中完成高效筛选：
- 确保
longitude和latitude字段类型为DECIMAL(10,8)，并建立空间索引 - 使用
POINT(longitude, latitude)构造地理点 - 查询语句类似：
SELECT id, name, ST_Distance_Sphere(POINT(116.48,39.92), POINT(longitude,latitude)) AS distance FROM shops WHERE distance
地址与坐标的双向转换要加缓存和兜底
TP6可通过topthink/think-geo扩展快速调用第三方API，但生产环境必须处理两个风险点：
- 地址转经纬度（地理编码）不能每次实时请求：用Redis缓存已解析结果，键建议含地址哈希值，过期时间设为7天
- 逆地理编码（经纬度转地址）失败时不能让
$result为null：检测isset($result['formatted_address'])，否则返回默认文案如“未知位置”，避免后续距离计算或展示报错 - 第三方API限流或403时，记录
error_log("Geo API failed: " . $e->getMessage())，便于定位配额或白名单问题
