Redis 与缓存 / 系统课时
使用 Geo 存储地理位置
使用 Geo 存储地理位置
本课解决“如何保存门店坐标并查询距离与附近成员”的问题。完成后,你可以用 Redis Geo 写入经纬度、计算两点距离,并按圆形范围查找附近位置。
学习目标
- 使用
GEOADD写入位置 - 使用
GEOPOS、GEODIST查询坐标和距离 - 使用
GEOSEARCH检索附近成员
Geo 数据模型
Geo 使用成员名标识地点,参数顺序固定为“经度、纬度、成员”。成员应使用稳定地点 ID,地址、营业时间等详情另存到 Hash 或数据库。
Redis 支持的经度范围是 -180 到 180,纬度范围约为 -85.05112878 到 85.05112878。超出范围会报错,同名成员再次写入时会更新位置。

写入并查询位置
下面写入三个地点,读取 central 的坐标,计算它到 tsim-sha-tsui 的距离,并查询 3 千米内的成员。
bash
redis-cli DEL demo:geo:shops:0806 >/dev/null
echo "added:"
redis-cli --raw GEOADD demo:geo:shops:0806 114.1588 22.2819 central 114.1822 22.2803 causeway 114.1694 22.2967 tsim-sha-tsui
echo "central position:"
redis-cli --raw GEOPOS demo:geo:shops:0806 central
echo "distance km:"
redis-cli --raw GEODIST demo:geo:shops:0806 central tsim-sha-tsui km
echo "within 3 km:"
redis-cli --raw GEOSEARCH demo:geo:shops:0806 FROMMEMBER central BYRADIUS 3 km ASC COUNT 10 WITHDIST预期输出:
text
added:
3
central position:
<LONGITUDE_APPROX>
<LATITUDE_APPROX>
distance km:
<DISTANCE_KM_APPROX>
within 3 km:
central
0.0000
tsim-sha-tsui
<TSIM_SHA_TSUI_DISTANCE_KM_APPROX>
causeway
<CAUSEWAY_DISTANCE_KM_APPROX>坐标经过内部编码,返回值可能与输入有极小误差,距离值也会因编码精度产生轻微差异。实际输出中的近似数值会替换上述占位符。
查询方式与边界
GEOSEARCH 也可使用 FROMLONLAT 指定临时中心点,或使用 BYBOX 查询矩形区域。加上 ASC 或 DESC 可按距离排序,WITHDIST 可同时返回距离。
Geo 计算的是近似球面直线距离,不等于道路导航距离,也不能表达楼层、高度、行政区边界或复杂多边形。需要路线规划和区域包含判断时,应使用专业地理服务。
按自己的节奏,确认真正理解。