georadius_ro.3valkey - Man Page
Returns members from a geospatial index that are within a distance from a coordinate.
Synopsis
GEORADIUS_RO key longitude latitude radius <M | KM | FT | MI> [WITHCOORD] [WITHDIST] [WITHHASH] [COUNT count [ANY]] [ASC | DESC]
Description
Read-only variant of the GEORADIUS command.
This command is identical to the GEORADIUS command, except that it doesn’t support the optional STORE and STOREDIST parameters.
Alternative
GEOSEARCH with the BYRADIUS argument.
Reply
One of the following:
- If no
WITH*option is specified, an valkey-protocol(7) Array reply of matched member names If
WITHCOORD,WITHDIST, orWITHHASHoptions are specified, the command returns an valkey-protocol(7) 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
- Available since: 3.2.10
- Changed in 6.2.0: Added the
ANYoption forCOUNT. - Changed in 7.0.0: Added support for uppercase unit names.
See Also
geoadd(3valkey), geodist(3valkey), geohash(3valkey), geopos(3valkey), georadius(3valkey), georadiusbymember(3valkey), georadiusbymember_ro(3valkey), geosearch(3valkey), geosearchstore(3valkey)