Redis GEOHASH 怎么把地理坐标编码成可比较的字符串

Redis 的 GEOHASH 不是把经纬度原样打印出来，而是根据已经写入地理索引的成员，返回对应的 geohash 字符串。最小可用做法是：先用 GEOADD 保存经度、纬度和成员名，再用 GEOHASH key member 读取编码。查询多个成员时，返回值和请求顺序一一对应；成员不存在时，该位置返回空值。

官方地址：https://redis.io/docs/latest/commands/geohash/

如果你的目标是导出一个可按前缀分组的空间标识，直接保存并读取 GEOHASH 的结果即可。它适合做空间分桶、前缀聚合和调试展示，但不能把 geohash 字符串的字典序直接当成距离或附近关系。

先分清三种值：坐标、成员和编码

这个命令最容易被误解的地方，是把返回的字符串当成新的经纬度。一个 Redis 地理成员实际上至少有三种不同的表达：

GEOHASH 的输入是地理索引 key 和成员名，输出是成员的 geohash 字符串，而不是重新计算后的经纬度。地理索引中没有这个成员时，不应把空值当成“坐标为 0”。

准备一个地点编码小项目

下面做一个很小的“地点编码导出”项目：把两个地点写入 city:points，然后一次读取它们的编码。这里不展开附近搜索，重点是建立稳定的成员名和编码读取关系。

# 创建第一个地点：参数依次是 key、经度、纬度和成员名
redis-cli GEOADD city:points 116.3974 39.9093 gate-a

# 创建第二个地点，使用不同成员名，便于观察批量返回顺序
redis-cli GEOADD city:points 121.4737 31.2304 gate-b

# 读取两个成员的 geohash，成员顺序就是返回列表的顺序
redis-cli GEOHASH city:points gate-a gate-b

GEOADD 的关键不是成员名看起来像什么，而是三者要保持固定约定：先经度、再纬度、最后成员。把纬度和经度颠倒，命令仍可能被接受，但得到的空间位置就不是预期地点。

用 GEOHASH 读取一个或多个成员

单成员查询适合做详情页或导出一行数据，多成员查询适合批量生成分桶字段。Redis 官方命令语法允许在同一条命令中传入多个成员，返回值按照这些成员在参数中的出现顺序排列。

# 只读取一个成员，便于给地点详情记录补充编码
redis-cli GEOHASH city:points gate-a

# 混合一个存在成员和一个不存在成员，观察位置对应关系
redis-cli GEOHASH city:points gate-a missing-gate

返回结果可以按下面的语义理解：

第 1 项：gate-a 对应的 geohash 字符串
第 2 项：missing-gate 不存在，对应空值

这里有两个实用判断。第一，不能因为列表里有空值，就把后面的值整体左移；每个返回位置仍然对应请求中的同位置成员。第二，空值是“成员未找到”的信号，导出程序应该保留成员名并记录缺失状态，而不是写入一个假的编码。

为什么说字符串“可比较”，但不能直接代表距离

geohash 的核心思路是把经纬度区域递归切分成网格，再把网格路径编码成字符串。较短的共同前缀通常意味着两个点落在较粗粒度的同一区域；共同前缀越长，表示它们在更细粒度上仍处于同一网格的可能性越高。

因此，工程上可以把 geohash 当作一个稳定的分组键：按前 4 个字符聚合城市片区，按前 6 个字符做更细的空间桶，或者在导出文件中用字符串前缀做筛选。但这种“可比较”是前缀和分组意义上的比较，不等于下面这些结论：

• 字符串字典序相邻，就一定代表地理距离相近。
• 字符串越大，就一定在地图上越靠东或越靠北。
• 共同前缀长度可以直接换算成精确米数。

跨越网格边界时，地理上很近的两个点也可能突然失去较长的共同前缀。所以如果业务要求最近距离、排序或半径判断，应继续使用 Redis 的地理查询能力或读取坐标后做距离计算；不要只对 GEOHASH 返回值做字符串排序。

把读取结果接入导出和分桶流程

如果要把编码交给应用程序，建议把“成员名、geohash、缺失状态”作为一条完整记录处理。批量查询时，先准备一份有序成员清单，再把返回列表按下标配对，最后根据业务约定截取前缀。

# 按固定顺序读取，保证导出文件的列可以稳定配对
redis-cli GEOHASH city:points gate-a gate-b > geohash-result.txt

# 只展示前 6 个字符作为空间分桶键；不要把它当作精确距离
cut -c 1-6 geohash-result.txt

生产代码中还应明确三个边界：成员名重复时以最后一次写入的地理位置为准；成员不存在时保留空值并记录错误上下文；截取前缀前先统一字符串编码和空值处理。这样可以避免把缺失成员误归入默认桶，也能让后续重跑导出时得到一致的列结构。

最后怎么验收这次编码

这个小项目的验收不需要把 geohash 当成神秘结果，只要确认四件事：写入时经纬度顺序正确；查询成员顺序与返回顺序一致；不存在成员对应空值；前缀只用于空间分组，不被误用成距离排序。

如果这四点都符合，说明已经掌握了 Redis GEOHASH 的主要用途。需要更精确的位置展示时读取经纬度，需要附近查询时使用专门的地理查询命令，需要分桶或导出时再使用 geohash 字符串。

常见问题

GEOHASH 返回的是经纬度吗？

不是。它返回成员对应的 geohash 字符串；经纬度应使用写入时的坐标或其他地理位置查询命令获取。

为什么两个很近的点没有很长的共同前缀？

它们可能刚好位于 geohash 网格边界两侧。共同前缀适合做粗粒度分组，不是连续距离函数。

可以直接按 GEOHASH 字符串排序找最近地点吗？

不建议。字符串排序只反映编码顺序，不能替代距离计算或 Redis 的附近查询。

批量 GEOHASH 的返回值怎么和成员对应？

按请求参数顺序逐项对应；成员缺失时保留该位置的空值，不要把后续结果前移。