做业务开发时，我们经常遇到这类需求：

✅ 同城筛选附近门店、外卖骑手匹配
✅ 社交APP附近的人、同城动态
✅ 网约车就近派单、地理位置打卡

面对这些地理位置检索场景，无需引入笨重的专业GIS引擎，Redis自带的GEO地理空间索引是一个轻量、高性能的方案。

Redis Geo

Redis Geo 没有创造新结构，完全基于有序集合 Sorted Set（ZSet）实现，底层核心组合：GeoHash 编码 + Sorted Set 索引。
简单来说就是：把二维的经纬度坐标，通过算法压缩成一维整数分值，利用ZSet天然的排序、范围检索能力，实现高效的地理位置查询。

  • Key：地理集合名（如 stores:location 门店位置集合）
  • Member：位置唯一标识（店铺ID、用户ID、设备ID）
  • Score：经纬度编码后的52位GeoHash整数（排序、检索的核心）

GeoHash 编码

GeoHash的核心价值：将二维经纬度，转化为可排序、可比对的一维字符串。
相近的地理位置，会拥有高度相似的编码前缀，这也是“附近查询”能够高效实现的根本原因。

GeoHash编码流程：

  1. 区间划分：针对地球经度范围[-180, 180]与纬度范围[-90, 90]，开展持续的二分操作
  2. 二进制编码：在每次二分过程中，依据目标点所处区间（左区间记为0，右区间记为1）生成对应的二进制位，且经度与纬度的编码过程交替进行
  3. Base32编码：将生成的二进制数据流，按每5位为一组转换为Base32字符

核心命令

命令 作用
GEOADD key longitude latitude member [...] 添加一个或多个地理位置
GEOPOS key member [...] 获取指定成员的经纬度信息
GEODIST key member1 member2 [unit] 计算两个成员之间的直线距离
GEOHASH key member [...] 获取成员对应的GeoHash编码，主要用于调试场景
GEOSEARCH key FROMMEMBER member BYRADIUS radius unit [...] 以已存储的成员为中心，检索指定圆形区域内的位置
GEOSEARCH key FROMLONLAT lng lat BYRADIUS radius unit [...] 以给定的经纬度为中心，检索指定圆形区域内的位置
GEOSEARCH key FROMLONLAT lng lat BYBOX width height unit [...] 检索指定矩形区域内的位置
GEORADIUS key FROMLONLAT lng lat BYBOX width height unit [...] 检索指定矩形区域内的位置，该命令已废弃

实战演练：实现「附近店铺」功能

将店铺位置录入Redis

将店铺的经纬度信息添加至Redis数据库

1
2
3
GEOADD storeId:location 116.48 39.95 store:1001
GEOADD storeId:location 116.50 39.96 store:1002
GEOADD storeId:location 116.30 39.90 store:1003

💡 该操作支持批量添加，可一次性录入多个位置信息，能有效提升操作性能。

检索附近的店铺

当用户A位于(116.48, 39.95)时，若需查询5公里范围内的店铺，可执行如下操作：

1
2
3
4
5
6
7
8
9
GEOSEARCH storeId:location \
FROMLONLAT 116.48 39.95 \ # 以指定经纬度为中心
BYRADIUS 5 km \ # 搜索半径5公里
WITHDIST \ # 返回距离中心点的距离
WITHCOORD \ # 返回目标的经纬度
COUNT 20 ASC # 最多20条，由近及远排序

## Redis 6.2 以下旧版本，可使用以下命令
GEORADIUS storeId:location 116.48 39.95 5 km WITHCOORD

Java代码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

@Service
public class LocationService {
    @Autowired
    private RedisTemplate<String, String> redisTemplate;
    private static final String GEO_KEY = "storeId:location";
    
    public void updateLocation(Long storeId, double lng, double lat) {
        // 先删旧位置，再添加新位置
        redisTemplate.opsForGeo().remove(GEO_KEY, storeId.toString());
        redisTemplate.opsForGeo().add(GEO_KEY, new Point(lng, lat), storeId.toString());
    }
    
    public GeoResults<RedisGeoCommands.GeoLocation<String>> 
            findNearby(double lng, double lat, double radius) {
        Circle circle = new Circle(new Point(lng, lat), 
                                   new Distance(radius, Metrics.KILOMETERS));
        return redisTemplate.opsForGeo().radius(GEO_KEY, circle,
            RedisGeoCommands.GeoRadiusCommandArgs.newGeoRadiusArgs()
                .includeDistance()
                .includeCoordinates()
                .sortAscending()
                .limit(20));
    }
}