GEOHASH(3valkey)

✨ GEOHASH 💅

okay so bestie, this is a page from the Valkey Command Manual and it's about a command called geohash. It's giving "where my little map pins at" energy. Let's go 💖

---

🌸 NAME

geohash — returns members from a geospatial index as geohash strings. That's it, that's the whole job 🫶

---

🌈 SYNOPSIS

GEOHASH key member [member...]

---

🎀 DESCRIPTION

So you've got a sorted set that's secretly a geospatial index (you put stuff in there with GEOADD, which lives over in valkey-geoadd(7)), and this command hands you back valid Geohash strings that represent where one or more of those elements are actually sitting. ✨

Now, normally Valkey stores positions using its own little variation on the Geohash technique, where positions get encoded as 52 bit integers. That encoding is also different from the standard one, because the initial min and max coordinates used during encoding and decoding are different. No cap. 🙈

But this command? This command returns a standard Geohash, as a string, exactly as described in the Wikipedia article and compatible with the geohash.org web site. Main character behaviour only. 👑

🦋 Geohash string properties

The command returns 11 characters Geohash strings, so literally no precision is lost compared to the Valkey internal 52 bit representation. The returned Geohashes have these properties:

1. They can be shortened by removing characters from the right. You'll lose precision, but it will still point to the same area. Lowkey still valid 💅
2. It is possible to use them in geohash.org URLs such as http://geohash.org/<geohash-string>. That right there is an example of such a URL.
3. Strings with a similar prefix are nearby — but the contrary is not true, so it's possible that strings with different prefixes are nearby too. It's giving "same neighbourhood, different vibes" 🏘️

---

💜 REPLY

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. One geohash per member, in order, periodt ✨

---

🔥 COMPLEXITY

O(1) for each member requested. Snappy. Iconic. 🍓

---

🌟 ACL CATEGORIES

• @geo
• @read
• @slow

---

🧚 HISTORY

• Available since: 3.2.0 — a legend from the jump 👑

---

⭐ 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"

look at those little strings go 😭 so cute, so precise

---

💀 SEE ALSO

• geoadd(3valkey)
• geodist(3valkey)
• geopos(3valkey)
• georadius(3valkey)
• georadiusbymember(3valkey)
• georadiusbymember_ro(3valkey)
• georadius_ro(3valkey)
• geosearch(3valkey)
• geosearchstore(3valkey)

---

and that's the whole page bestie, no notes 💖 go forth and geohash responsibly 🦋

okay bye ily — this was Valkey 9.0.0, dated 2025-10-21, and yes GEOHASH(3valkey) ate, no crumbs left 🌈💅✨