thinkphp 8.0 可通过 redis geosearch 实现高效外卖配送范围判定：一、将商家经纬度以 id 为成员写入 geo:shop:active；二、用户下单时用 geosearch 按坐标与半径检索；三、统一坐标系（如 gcj-02）避免偏移；四、结合 db 动态过滤配送半径并缓存结果。
ThinkPHP 8.0 可以借助 Redis 的 GEOSEARCH（或兼容的 GEORADIUS）命令实现高效、实时的外卖配送范围判定，核心在于将商家坐标存入 Redis Geo 集合，再根据用户位置快速检索指定半径内的可配送商家。
一、准备商家地理数据并写入 Redis
在商家入驻或编辑地址时，需将其经纬度（如高德/百度坐标系转为 WGS84 或统一使用 GCJ-02，注意前后端一致）存入 Redis Geo 结构。推荐使用商家 ID 作为成员名，避免中文或特殊字符：
- Redis Key 建议命名规范，例如：
geo:shop:active，便于缓存管理和过期控制 - 使用 ThinkPHP 的
Cache::store('redis')->handler()获取原生 Redis 实例，调用geoAdd写入：
$redis = Cache::store('redis')->handler();
$redis->geoAdd('geo:shop:active', $lng, $lat, $shopId);
若需批量导入，可用 geoAdd 多组参数；注意确保经纬度顺序为 经度在前、纬度在后（Redis 要求），且经度范围 -180~180、纬度 -90~90。
二、根据用户位置查询可配送商家
用户下单时，传入其 GPS 坐标（建议前端通过定位 API 获取，后端不做校验但需做基础范围过滤），调用 geoSearch（TP8.0 推荐，替代已标记为 deprecated 的 geoRadius）获取附近商家：
- 支持按距离排序、限制数量、设置单位（m/km/mi/ft）、返回距离和坐标等选项
- ThinkPHP 8.0 默认 Redis 封装支持
geoSearch，无需手动扩展
$redis = Cache::store('redis')->handler();
$result = $redis->geoSearch(
'geo:shop:active',
['longitude' => $userLng, 'latitude' => $userLat],
['radius' => 5000, 'unit' => 'm', 'sort' => 'ASC', 'count' => 20]
);
返回结果为数组，每个元素包含 name（商家 ID）、distance（单位为 m）、hash 和可选的 coord（需显式开启 withcoord => true）。后续可关联查库获取完整商家信息。
三、处理坐标系与精度问题
国内地图 SDK（如高德、百度）返回的坐标通常不是 WGS84，而 Redis Geo 基于球面模型，对坐标系无内置转换，因此必须统一源头：
- 若使用高德地图，调用
AMap.Geocoder时设置coordtype=gcj02，再通过开源库（如gcoord）在前端或后端转为 WGS84（或直接用 GCJ-02 存入——只要商家与用户坐标同源，相对距离误差可控） - 避免混合使用百度 BD09 和高德 GCJ-02，否则 1~2km 偏移常见
- 实际业务中，可接受 100~300 米误差，重点保障“是否在圈内”的逻辑正确性，而非绝对地理精度
四、增强实用性：支持动态配送半径与缓存策略
真实场景中，不同商家配送范围不同（如奶茶店 1km，餐厅 3km），且可能随时间变化（如午市扩圈）：
- 不建议为每个商家建独立 Geo Key（维护成本高），可用「主键 + 半径标签」组合，如
geo:shop:5km，定时任务按规则同步更新 - 更灵活做法：Geo 中只存有效商家，配送半径逻辑下推到应用层——先查 Geo 获取候选商家 ID 列表，再查 DB 过滤
delivery_radius >= 计算距离 - 对高频查询（如首页附近商家），可将结果缓存为 JSON，Key 含用户坐标哈希（如
geo:nearby:+ md5($lng.'|'.$lat.'|5000')），设置 60s 过期，平衡实时性与性能
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
