GEORADIUSBYMEMBER_RO

Returns members from a geospatial index that are within a distance from a member.

Usage

GEORADIUSBYMEMBER_RO key member radius <M | KM | FT | MI> [WITHCOORD] [WITHDIST] [WITHHASH] [COUNT count [ANY]] [ASC | DESC]

Description

Read-only variant of the GEORADIUSBYMEMBER command.

This command is identical to the GEORADIUSBYMEMBER command, except that it doesn’t support the optional STORE and STOREDIST parameters.

Alternative

GEOSEARCH with the BYRADIUS and FROMMEMBER arguments.

Reply

One of the following:

• If no WITH* option is specified, an Array reply of matched member names

• If WITHCOORD, WITHDIST, or WITHHASH options are specified, the command returns an Array reply of arrays, where each sub-array represents a single item:

  • The distance from the center as a floating point number, in the same unit specified in the radius.

  • The Geohash integer.

  • The coordinates as a two items x,y array (longitude,latitude).

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

@geo @read @slow

History

• 3.2.10: Introduced.
• 6.2.0: Added the ANY option for COUNT.
• 7.0.0: Added support for uppercase unit names.

See also

GEOADD, GEODIST, GEOHASH, GEOPOS, GEORADIUS, GEORADIUSBYMEMBER, GEORADIUS_RO, GEOSEARCH, GEOSEARCHSTORE.