GEORADIUS_RO

从地理空间索引中返回距坐标一定距离内的成员。

语法

GEORADIUS RO key longitude latitude radius [WITHCOORD] [WITHDIST] [WITHHASH] [COUNT count [ANY]] [ASC | DESC]

引入版本：3.2.10

复杂度摘要：O(N+log(M)

GEORADIUS 命令的只读变体。

该命令与 GEORADIUS 命令相同，只是它不支持可选的 STORE 和 STOREDIST 参数。

必需参数

key

保存地理空间索引（有序集合）的键的名称。

longitude

中心点的经度。

latitude

中心点的纬度。

radius

搜索圆的半径，单位由以下参数给出。

M | KM | FT | MI

radius 的单位：米 (M)、公里 (KM)、英尺 (FT) 或英里 (MI)。

可选参数

WITHCOORD

同时返回每个匹配项的经度和纬度。

WITHDIST

同时返回每个匹配项距中心的距离，单位与半径相同。

WITHHASH

还返回每个匹配项的原始 52 位 geohash 编码分数。

COUNT count [ANY]

最多返回count个匹配项。使用 ANY，一旦找到足够的匹配项，该命令就会返回 — 速度更快，但结果可能未排序。

ASC | DESC

按距中心的距离对结果进行排序：最近的优先 (ASC) 或最远的优先 (DESC)。

Redis Software 与 Redis Cloud 兼容性

Redis 软件	Redis Cloud	说明
✅ 标准 ✅ 主动-主动	✅ 标准 ✅ 主动-主动	从 Redis v6.2.0 开始已弃用。

返回值

RESP2

以下之一： * 如果未指定 WITH* 选项，则为匹配成员名称的数组回复 * 如果指定了 WITHCOORD、WITHDIST 或 WITHHASH 选项，则该命令返回数组的数组回复，其中每个子数组代表单个项目： * 距中心的距离为浮点数，采用与半径中指定的相同单位。 * Geohash 整数。 * 坐标为两个 x,y 数组（经度、纬度）。

RESP3

以下之一： * 如果未指定 WITH* 选项，则为匹配成员名称的数组回复 * 如果指定了 WITHCOORD、WITHDIST 或 WITHHASH 选项，则该命令返回数组的数组回复，其中每个子数组代表单个项目： * 距中心的距离为浮点数，采用与半径中指定的相同单位。 * Geohash 整数。 * 坐标为两个 x,y 数组（经度、纬度）。

资料来源：Redis 官方 GEORADIUS_RO 文档；中文内容参考 Redis 文档许可。