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.

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.
• 6.2.0: Deprecated; replaced by GEOSEARCH with the BYRADIUS and FROMMEMBER arguments.

See also

GEOADD, GEODIST, GEOHASH, GEOPOS, GEOSEARCH, GEOSEARCHSTORE.