GEORADIUS_RO

Usage:
GEORADIUS_RO key longitude latitude radius 〈 m | km | ft | mi 〉 [ WITHCOORD ] [ WITHDIST ] [ WITHHASH ] [ COUNT count [ ANY ] ] [ ASC | DESC ]
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.10
ACL Categories:
@geo, @read, @slow

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.

RESP2/RESP3 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).

History

Version Change
6.2.0

Added the ANY option for COUNT.
7.0.0

Added support for uppercase unit names.
Slack Icon Slack GitHub Icon GitHub LinkedIn Icon LinkedIn X Icon X.com Mail Icon Connect
Code of Conduct Forum About FAQ

© Valkey contributors.

Valkey and the Valkey logo are trademarks of LF Projects, LLC.

Trademark Policy. Privacy Policy. Terms of Use. For other policies, please see lfprojects.org.

Valkey includes certain 3-Clause BSD-licensed Redis code from Redis Ltd. and other source code. Redis Ltd. is not the source of that other source code. Redis is a registered trademark of Redis Ltd.

Logo design by Ziyang.