异常教程

redis geo（长文解析）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战(已更新的所有项目都能学习) / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新开坑项目:《Spring AI 项目实战》 正在持续爆肝中，基于 Spring AI + Spring Boot 3.x + JDK 21...， 点击查看 ;
  • 《从零手撸：仿小红书（微服务架构）》 已完结，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

在现代互联网应用中，地理位置相关的功能需求日益增长，例如外卖平台的店铺推荐、社交应用的附近好友匹配，或是物流系统的路径优化。这些场景的实现离不开高效的地理空间数据处理技术。Redis作为一款高性能的内存数据库，其内置的 Redis Geo 模块为开发者提供了一套轻量、快速的解决方案。本文将从基础概念出发，结合实际案例和代码示例，逐步解析 Redis Geo 的核心功能、使用场景及优化技巧，帮助读者快速掌握这一工具。

一、Redis Geo 的核心概念与工作原理

1.1 什么是 Redis Geo？

Redis Geo 是 Redis 数据库中用于存储和查询地理位置数据的功能模块。它通过 经纬度坐标 来表示地理位置，并支持以下操作：

  • 将地理位置信息添加到指定的键（Key）中。
  • 根据半径或距离范围查询附近的地理位置。
  • 计算两个地理位置之间的距离。
  • 获取地理位置的详细信息（如名称、坐标等）。

形象比喻：可以将 Redis Geo 想象为一张覆盖全球的“电子地图”，开发者可以像在地图上标记地点一样，将店铺、用户位置等信息存储为坐标点，而 Redis 则负责快速检索这些点之间的关系。

1.2 数据结构：地理空间的存储方式

Redis Geo 使用 有序集合（Sorted Set） 作为底层数据结构，每个地理位置由以下元素组成：

  • 成员（Member）：唯一标识地理位置的字符串（例如店铺名称或用户ID）。
  • 分数（Score）：存储为 经度 + 纬度 的二进制编码。
  • 地理信息：通过 GEOADD 命令添加时，可附带名称等元数据。

关键点：

  • 经纬度的存储范围需符合地理规范（经度：-180°~180°，纬度：-90°~90°）。
  • Redis Geo 的查询性能依赖于底层的跳跃表（Skip List）结构，可实现亚毫秒级响应。

二、Redis Geo 核心命令详解

2.1 添加地理位置：GEOADD

GEOADD 命令用于向指定键中添加一个或多个地理位置。其语法为：

GEOADD key longitude latitude member [longitude latitude member ...]

示例：

GEOADD "coffee_shops" 121.4737 31.2304 "Starbucks_001"  
GEOADD "coffee_shops" 121.4730 31.2308 "Nescafe_002"

解释：

  • coffee_shops 是键名，表示存储咖啡店的位置集合。
  • 每个店铺的坐标（经度、纬度）和名称（Member）被依次添加。

2.2 查询地理位置：GEORADIUS/GEORADIUSBYMEMBER

2.2.1 根据坐标范围查询：GEORADIUS

GEORADIUS 命令用于在指定半径范围内搜索地理位置。语法如下：

GEORADIUS key longitude latitude radius unit [WITHDIST] [WITHCOORD] [ASC|DESC]

参数说明：

  • radius：范围半径（如 1000 米）。
  • unit：单位（m：米，km：公里等）。
  • WITHDIST：返回每个结果的距离（单位与查询参数一致）。
  • ASC/DESC：按距离升序或降序排列结果。

示例：

GEORADIUS coffee_shops 121.4737 31.2304 1000 m WITHDIST

输出：

1) 1) "Starbucks_001"  
   2) "0.00"  # 距离为0米（自身坐标）  
2) 1) "Nescafe_002"  
   2) "544.23"  # 距离约544米

2.2.2 根据成员查询附近点：GEORADIUSBYMEMBER

GEORADIUSBYMEMBER 通过已有的地理位置成员，查询其附近的其他点。语法为：

GEORADIUSBYMEMBER key member radius unit [WITHDIST] [...]

示例：

GEORADIUSBYMEMBER coffee_shops Starbucks_001 500 m WITHDIST

输出：

1) 1) "Nescafe_002"  
   2) "544.23"  # 超出半径范围时可能无结果

2.3 计算距离：GEODIST

GEODIST 命令用于计算两个地理位置之间的距离。语法：

GEODIST key member1 member2 [unit]

示例：

GEODIST coffee_shops Starbucks_001 Nescafe_002 km

输出：

"0.54"  # 约0.54公里

2.4 获取坐标信息：GEOPos

GEOPos 返回指定成员的经纬度坐标。语法：

GEOPos key member [member ...]

示例：

GEOPos coffee_shops Nescafe_002

输出：

1) 1) "121.4730"  # 经度  
   2) "31.2308"   # 纬度

三、Redis Geo 的实际应用场景与案例

3.1 场景1：附近店铺推荐

需求：用户打开外卖App时，展示附近3公里内的咖啡店。

实现步骤：

  1. 将所有咖啡店的位置信息通过 GEOADD 存入 Redis。
  2. 用户登录时，获取其实时坐标（经度、纬度）。
  3. 使用 GEORADIUS 命令查询半径3公里内的店铺。

代码示例（Python）：

import redis  

r = redis.Redis(host='localhost', port=6379, db=0)  

r.geoadd('coffee_shops',  
         121.4737, 31.2304, 'Starbucks_001',  
         121.4730, 31.2308, 'Nescafe_002')  

user_longitude = 121.4737  
user_latitude = 31.2304  

results = r.georadius(  
    'coffee_shops',  
    user_longitude, user_latitude,  
    radius=3000, unit='m',  
    with_dist=True, sort='ASC'  
)  

for shop in results:  
    print(f"店铺：{shop[0].decode()}, 距离：{shop[1]:.2f} 米")

3.2 场景2：社交应用的“附近的人”

需求：用户查看附近5公里内的在线好友。

实现思路：

  • 每个用户登录时，将坐标更新到 Redis 的 online_users 键中。
  • 定期清理离线用户的坐标（可通过 Redis 的过期时间实现）。
  • 查询时使用 GEORADIUS 返回结果，并结合其他业务逻辑（如用户状态）。

代码示例（Lua 脚本）：

local key = KEYS[1]  
local longitude = tonumber(ARGV[1])  
local latitude = tonumber(ARGV[2])  
local radius = tonumber(ARGV[3])  
local unit = ARGV[4]  

return redis.call('GEORADIUS', key, longitude, latitude, radius, unit, 'WITHDIST', 'COUNT', 10)

四、Redis Geo 的性能优化与注意事项

4.1 数据量与查询性能

  • 数据量限制：单个键存储的地理位置建议不超过 10万条，超过此规模需分片存储。
  • 查询优化：
    • 减少 WITHCOORD、WITHDIST 等参数的使用，避免返回冗余数据。
    • 对高频查询的坐标范围进行缓存（如热门商圈的店铺列表）。

4.2 精度与误差

  • Redis Geo 的坐标存储精度为 5.2米（由二进制编码决定），适用于大多数场景。
  • 若需更高精度（如测绘级应用），需结合其他工具（如 PostGIS）。

4.3 地理围栏与动态更新

  • 地理围栏：通过定期扫描 Redis Geo 数据，结合 GEORADIUS 判断用户是否进入/离开指定区域。
  • 实时更新：用户移动时，使用 GEOADD 覆盖旧坐标（旧坐标会被自动删除）。

五、结论

Redis Geo 以其轻量、高效的特点，为地理位置相关的业务场景提供了强大的支持。无论是外卖平台的店铺推荐，还是社交应用的附近匹配，开发者只需掌握几个核心命令，即可快速实现功能。然而，合理规划数据存储、关注查询性能，以及理解其精度限制，是确保应用稳定的关键。随着 Redis 的持续更新，未来其在地理空间处理领域的功能将更加完善，值得开发者深入探索。

通过本文的讲解，读者应能掌握 Redis Geo 的基础用法，并能结合自身业务需求设计解决方案。建议读者通过官方文档进一步学习进阶功能（如 GEOHASH 命令），以应对更复杂的场景。

最新发布

查看更多文章