Redis GEOSEARCH 怎样在矩形区域与圆形区域查询之间选择

Redis GEOSEARCH 的选择并不复杂：配送半径、附近门店、步行距离这类“离中心不超过多少”的需求，用 BYRADIUS；地图视窗、行政网格、仓储服务矩形这类“经度和纬度都落在边界内”的需求，用 BYBOX。两者都从同一个 GEO 索引取成员，但过滤形状不同，不能只把半径数字换成宽高。

先把“附近”拆成圆形和矩形

GEOSEARCH 的语法先指定 Redis key，再指定查询来源：可以是 FROMMEMBER，也可以是 FROMLONLAT longitude latitude。之后只能选择一种过滤形状。圆形由半径定义，矩形由宽和高定义，单位都可以使用米、千米、英尺或英里。

例如，门店配送通常要求“中心点 3 千米内”，边界是圆；而地图拖动后加载“横向 8 千米、纵向 5 千米”的可视区域，边界是矩形。后者不应先计算一个近似半径，因为四个角点会被错误纳入或排除。

用两条命令对照验证过滤边界

下面用同一个经纬度中心和同一个地理索引做对照。示例成员可以先通过 GEOADD places longitude latitude member 写入；重点是观察形状参数如何改变结果，不把下面的命令当成真实线上运行截图。

# 圆形：查中心点 3 千米内的成员，适合配送半径
GEOSEARCH places FROMLONLAT 116.3974 39.9093 BYRADIUS 3 KM ASC WITHDIST

# 矩形：查宽 6 千米、高 4 千米的区域，适合地图视窗
GEOSEARCH places FROMLONLAT 116.3974 39.9093 BYBOX 6 4 KM ASC WITHDIST

两条命令都用 ASC，所以在同一查询形状内会按距离从近到远返回；但矩形命令的“入选条件”仍是落在矩形框内，并不是到中心点的距离小于某个固定值。要排查边界，优先准备四类点：中心点、圆周附近、矩形角点附近，以及明显落在外侧的点。

返回距离、坐标和数量时怎样组合参数

只要业务需要展示距离，就加 WITHDIST；需要在地图上继续绘制点位，就加 WITHCOORD。两者可以一起使用。COUNT 限制返回成员数量，适合附近推荐；不要把它理解成“查询只扫描这么多条”，也不要用 COUNT n ANY 代替最近排序，若结果必须是最近的几个成员，应保留默认精确候选并使用 ASC。

上线前用边界清单复查

第一，确认坐标顺序始终是经度在前、纬度在后；第二，确认所有距离参数使用同一单位；第三，矩形的宽高是整体尺寸，不是从中心到边缘的单边距离；第四，若业务需要“最近”，明确使用 ASC 而不是依赖返回的默认顺序；第五，跨越日期变更线或极端纬度的地图需求要单独做地理边界测试，不能只用城市中心点验证。

这样选择后，GEOSEARCH 的命令就和业务语言一致：圆形回答“距离中心多远”，矩形回答“是否在这块覆盖区域内”。

常见问题

BYBOX 的宽和高能直接写成半径吗？

不能。BYBOX 接收矩形的整体宽度和高度；如果只有一个服务半径，应使用 BYRADIUS，避免把矩形角点当成圆形范围。

怎样让结果按距离最近优先？

在过滤条件后增加 ASC，需要展示具体距离时再增加 WITHDIST。随后用 COUNT 截取前 N 个结果。

只返回成员名称还是同时返回坐标？

默认返回成员名称；需要在应用层绘制或再次计算时使用 WITHCOORD，需要展示距离时使用 WITHDIST，两者可同时出现。