GEORADIUSBYMEMBER (已弃用)
截至Redis版本6.2.0,此命令被视为已弃用。
在迁移或编写新代码时,可以使用GEOSEARCH
和GEOSEARCHSTORE
以及BYRADIUS
和FROMMEMBER
参数来替换它。
Syntax
GEORADIUSBYMEMBER key member radius <M | KM | FT | MI> [WITHCOORD] [WITHDIST] [WITHHASH] [COUNT count [ANY]] [ASC | DESC] [STORE key | STOREDIST key]
- Available since:
- 3.2.0
- Time complexity:
- O(N+log(M)) where N is the number of elements inside the bounding box of the circular area delimited by center and radius and M is the number of items inside the index.
- ACL categories:
-
@write
,@geo
,@slow
,
此命令与GEORADIUS
完全相同,唯一的区别在于,它不是以经度和纬度值作为查询区域的中心,而是以已存在于由排序集表示的地理空间索引中的成员名称作为中心。
指定成员的位置被用作查询的中心。
请查看下面的示例和GEORADIUS
文档以获取有关该命令及其选项的更多信息。
请注意,自 Redis 3.2.10 和 Redis 4.0.0 起,GEORADIUSBYMEMBER_RO
也可用,以提供一个可以在副本中使用的只读命令。更多信息请参见 GEORADIUS
页面。
示例
RESP2/RESP3 回复
以下之一:
- 如果没有指定
WITH*
选项,则返回匹配成员名称的数组回复 - 如果指定了
WITHCOORD
、WITHDIST
或WITHHASH
选项,命令将返回一个数组回复,其中每个子数组代表一个单独的项目:- 从中心到该点的距离,以浮点数表示,单位与半径指定的单位相同。
- Geohash整数。
- 坐标作为一个包含两个元素的x,y数组(经度,纬度)。
历史
- 从 Redis 版本 6.2.0 开始:为
COUNT
添加了ANY
选项。 - 从 Redis 7.0.0 版本开始:增加了对大写单位名称的支持。