geohash.3valkey - Man Page
Returns members from a geospatial index as geohash strings.
Synopsis
GEOHASH key member [member...]
Description
Return valid Geohash\c strings representing the position of one or more elements in a sorted set value representing a geospatial index (where elements were added using GEOADD).
Normally Valkey represents positions of elements using a variation of the Geohash technique where positions are encoded using 52 bit integers. The encoding is also different compared to the standard because the initial min and max coordinates used during the encoding and decoding process are different. This command however returns a standard Geohash in the form of a string as described in the Wikipedia article\c and compatible with the geohash.org\c web site.
Geohash string properties
The command returns 11 characters Geohash strings, so no precision is lost compared to the Valkey internal 52 bit representation. The returned Geohashes have the following properties:
- They can be shortened removing characters from the right. It will lose precision but will still point to the same area.
- It is possible to use them in
geohash.orgURLs such ashttp://geohash.org/<geohash-string>. This is an example of such URL\c . - Strings with a similar prefix are nearby, but the contrary is not true, it is possible that strings with different prefixes are nearby too.
Reply
Resp2
valkey-protocol(7) Array reply: an array where each element is the Geohash corresponding to each member name passed as an argument to the command.
Resp3
valkey-protocol(7) Array reply: An array where each element is the Geohash corresponding to each member name passed as an argument to the command.
Complexity
O(1) for each member requested.
Acl Categories
@geo @read @slow
History
- Available since: 3.2.0
Examples
127.0.0.1:6379> GEOADD Sicily 13.361389 38.115556 "Palermo" 15.087269 37.502669 "Catania" (integer) 2 127.0.0.1:6379> GEOHASH Sicily Palermo Catania 1) "sqc8b49rny0" 2) "sqdtr74hyu0"
See Also
geoadd(3valkey), geodist(3valkey), geopos(3valkey), geosearch(3valkey), geosearchstore(3valkey)