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.
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.
Notes
This command is deprecated (since 6.2.0) and replaced by GEOSEARCH with the BYRADIUS argument.
See Also
geoadd(3valkey), geodist(3valkey), geohash(3valkey), geopos(3valkey), geosearch(3valkey), geosearchstore(3valkey)