基于Redis实现附近商铺查询功能

# 1. 添加地理空间数据
GEOADD stations 116.378248 39.865275 "北京南站" 116.42803 39.903738 "北京站" 116.322287 39.893729 "北京西站"

# 2. 计算北京西站到北京站的距离
GEODIST stations "北京西站" "北京站" km

# 3. 搜索天安门附近10km内的火车站并按距离排序
GEOSEARCH stations FROMLONLAT 116.397904 39.909005 BYRADIUS 10 km ASC

//在ServiceImpl中(简单演示)
@Autowired
    private StringRedisTemplate stringRedisTemplate;
@Override
public Result queryShopByType(Integer typeId, Integer current, Double x, Double y) {
    // 1. 判断是否需要基于地理位置查询
    if (x == null || y == null) {
        // 不需要地理坐标查询时，直接按类型分页查询数据库
        Page<Shop> page = query()
                .eq("type_id", typeId)  // 按店铺类型筛选
                .page(new Page<>(current, SystemConstants.DEFAULT_PAGE_SIZE));  // 分页查询
        // 返回查询结果
        return Result.ok(page.getRecords());
    }
    // 2. 需要地理查询时，计算分页参数
    int from = (current - 1) * SystemConstants.DEFAULT_PAGE_SIZE;  // 起始偏移量
    int end = current * SystemConstants.DEFAULT_PAGE_SIZE;          // 结束位置
    // 3. 从Redis中查询附近店铺ID（GEO查询）
    String key = "shop:geo:" + typeId;  // GEO数据存储的key
    // 执行GEO搜索：以(x,y)为中心，5000米半径范围内，查询end数量的店铺
    GeoResults<RedisGeoCommands.GeoLocation<String>> results = stringRedisTemplate.opsForGeo().search(
            key,
            GeoReference.fromCoordinate(x, y),  // 中心点坐标
            new Distance(5000),                // 搜索半径（5公里）
            RedisGeoCommands.GeoSearchCommandArgs.newGeoSearchArgs()
                    .includeDistance()         // 包含距离信息
                    .limit(end)                // 限制返回数量
    );
    // 4. 处理查询结果并获取店铺详情
    if (results == null) {
        return Result.ok(Collections.emptyList());  // 无结果时返回空列表
    }
    List<GeoResult<RedisGeoCommands.GeoLocation<String>>> list = results.getContent();
    if (list.size() <= from) {
        return Result.ok(Collections.emptyList());  // 结果不足时分页返回空
    }
    // 收集店铺ID和距离信息
    List<Long> ids = new ArrayList<>(list.size());
    Map<String, Distance> distanceMap = new HashMap<>(list.size());
    // 跳过前from条记录（分页处理），然后处理剩余记录
    list.stream().skip(from).forEach(result -> {
        String id = result.getContent().getName();  // 获取店铺ID
        ids.add(Long.valueOf(id));
        distanceMap.put(id, result.getDistance()); // 存储店铺距离
    });
    // 根据ID批量查询店铺详情（保持ID顺序）
    String strIds = StrUtil.join(",", ids);
    List<Shop> shops = query()
            .in("id", ids)  // 按ID列表查询
            .last("ORDER BY FIELD(id," + strIds + ")")  // 保持Redis返回的顺序
            .list();
    // 为每个店铺设置距离信息
    for (Shop shop : shops) {
        shop.setDistance(distanceMap.get(shop.getId().toString()).getValue());
    }
    // 5. 返回带距离信息的店铺列表
    return Result.ok(shops);
}

.sortAscending()    // 按距离升序排序（从近到远）
.sortDescending()  // 按距离降序排序（从远到近）

.includeDistance()  // 在结果中包含距离信息
.includeCoordinates() // 在结果中包含坐标信息
.includeName()     // 在结果中包含成员名称（默认包含）

.limit(50)         // 限制返回结果数量（可用于简单分页）

.includeDistance().withDistance(Metrics.KILOMETERS) // 指定距离单位
//支持的单位：
//Metrics.KILOMETERS(千米)
//Metrics.MILES(英里)
//Metrics.FEET(英尺)
//Metrics.METERS(米)

//1.fromCoordinate(x, y)
//作用：通过经纬度坐标指定中心点
//示例：
GeoReference.fromCoordinate(116.404, 39.915)  // 北京天安门坐标
//2.fromMember(memberName)
//作用：通过 Redis中已存储的GEO成员名称指定中心点
//示例：
GeoReference.fromMember("北京站")  // 以已存储的"北京站"坐标为中心
//3.fromString("x,y")
//作用：通过字符串格式的坐标指定中心点
//示例：
GeoReference.fromString("116.404,39.915")

GeoResults<RedisGeoCommands.GeoLocation<String>> results = stringRedisTemplate.opsForGeo().search(
    "shop:geo:1",
    GeoReference.fromCoordinate(116.397904, 39.909005),
    new Distance(5, Metrics.KILOMETERS),
    RedisGeoCommands.GeoSearchCommandArgs.newGeoSearchArgs()
        .includeDistance()      // 包含距离
        .includeCoordinates()   // 包含坐标
        .sortAscending()        // 按距离升序
        .limit(100)             // 最多返回100条
        .withDistance(Metrics.KILOMETERS) // 距离单位为千米
);

.byBox(width, height, Metrics.KILOMETERS) // 矩形范围搜索

.store("result-key")  // 将结果存储到指定key
.storeDist("result-key") // 存储带距离的结果