Redis 与缓存 / 系统课时

使用 Geo 存储地理位置

使用 Geo 存储地理位置

本课解决“如何保存门店坐标并查询距离与附近成员”的问题。完成后,你可以用 Redis Geo 写入经纬度、计算两点距离,并按圆形范围查找附近位置。

学习目标

  • 使用 GEOADD 写入位置
  • 使用 GEOPOS、GEODIST 查询坐标和距离
  • 使用 GEOSEARCH 检索附近成员

Geo 数据模型

Geo 使用成员名标识地点,参数顺序固定为“经度、纬度、成员”。成员应使用稳定地点 ID,地址、营业时间等详情另存到 Hash 或数据库。

Redis 支持的经度范围是 -180 到 180,纬度范围约为 -85.05112878 到 85.05112878。超出范围会报错,同名成员再次写入时会更新位置。

Redis Geo 半径检索示意图

写入并查询位置

下面写入三个地点,读取 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 计算的是近似球面直线距离,不等于道路导航距离,也不能表达楼层、高度、行政区边界或复杂多边形。需要路线规划和区域包含判断时,应使用专业地理服务。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 Geo 存储地理位置

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通