- Usage:
-
GEORADIUSBYMEMBER key member radius 〈 m | km | ft | mi 〉 [ WITHCOORD ] [ WITHDIST ] [ WITHHASH ] [ COUNT count [ ANY ] ] [ ASC | DESC ] [ STORE storekey | STOREDIST storedistkey ]
- 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.
- Since:
- 3.2.0
-
If no
WITH*
option is specified, an Array reply of matched member names -
If
WITHCOORD
,WITHDIST
, orWITHHASH
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).
-
This command is exactly like GEORADIUS
with the sole difference that instead
of taking, as the center of the area to query, a longitude and latitude value, it takes the name of a member already existing inside the geospatial index represented by the sorted set.
The position of the specified member is used as the center of the query.
Please check the example below and the GEORADIUS
documentation for more information about the command and its options.
Note that GEORADIUSBYMEMBER_RO
was added to provide a read-only command that can be used in replicas. See the GEORADIUS
page for more information.
Examples
127.0.0.1:6379> GEOADD Sicily 13.583333 37.316667 "Agrigento"
(integer) 1
127.0.0.1:6379> GEOADD Sicily 13.361389 38.115556 "Palermo" 15.087269 37.502669 "Catania"
(integer) 2
127.0.0.1:6379> GEORADIUSBYMEMBER Sicily Agrigento 100 km
1) "Agrigento"
2) "Palermo"
RESP2/RESP3 Reply
One of the following:
History
Version | Change |
---|---|
6.2.0 | Added the |
7.0.0 | Added support for uppercase unit names. |