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
, orWITHHASH
options 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
ANY
option 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)