Redis Geo相关命令详解

GEOADD

最早可用版本：3.2.0

时间复杂度：O(log(N))，N是Sorted set元素数量

用法：GEOADDkey longitude latitude member [longitude latitude member …]

将指定的地理空间位置（纬度、经度、名称）添加到指定key中。这些数据将存储到sorted set，这样为了方便使用GEORADIUS或GEORADIUSBYMEMBER命令。

该命令采用标准格式参数x,y，所以经度必须在纬度之前。输入的坐标有如下限制：

• 有效的经度从-180度到180度

• 有效的纬度从-85.05112878度到85.05112878度

当坐标位置超出上述指定范围时，该命令返回一个错误。

GEODIST

最早可用版本：3.2.0

时间复杂度：O(log(N))

用法：GEODIST key member1 member2 [unit]

返回两个给定位置之间的距离。

如果两个位置之间的其中一个不存在，那么命令返回空值。

指定单位的参数unit必须是以下其中一个：

• m表示单位为米

• km表示单位为千米

• mi表示单位为英里

• ft表示单位为英尺

如果用户没有显示指定单位参数，默认使用米作为单位。

GEODIST命令在计算距离时会假设地球为完美球形，极限情况下，这一假设最大会造成0.5%的误差。

GEOHASH

最早可用版本：3.2.0

时间复杂度：O(log(N))

返回一个或多个元素位置的Geohash表示。

用法：GEOHASH key member [member …]

返回一个或多个位置元素的Geohash表示。

通常，Redis使用Geohash技术的变体表示元素的位置，位置使用52位整数进行编码。由于编码和解码过程的初始最大和最小坐标不同，所以编码也不是标准的编码方式。

该命令返回11个字符的Geohash字符串，和内部的52位表示方法相比没有精度的损失。返回的Geohash有以下属性：

1. 它可以移除右边的字符以缩短长度，这只会导致精度的损失，但仍指向同一区域

2. 它可以在heohash.org网站使用，地址是http://geohash.org/

3. 前缀相似的字符串指向的位置离得很近，但这不代表前缀不同的字符串就离得很远

GEOPOS

最早可用版本：3.2.0

时间复杂度：O(log(N))

用法：GEOPOS key member [member …]

返回指定key中的指定位置信息。

GEORADIUS

最早可用版本：3.2.0

时间复杂度：O(N+log(M))，N是半径区域内元素数量，M是指定key中元素数量

用法：GEORADIUS key longitude latitude radiusm|km|ft|mi [WITHCOORD] [WITHDIST] [WITHHASH][COUNT count] [ASC|DESC] [STORE key][STOREDIST key]

以给定经纬度为中心，返回键包含的位置元素与中心距离不超过最大距离的所有位置元素。

命令额外选项：

• WITHDIST：在返回位置元素的同时，将位置元素与中心的距离也一并返回，单位与用户给定距离的单位一直

• WITHCOORD：将位置元素的经度和纬度也一并返回

• WITHHASH：以52位有符号整数的形式，返回位置元素经过原始geohash编码的有序集合分值。这个选项主要用于底层应用或调试。

命令默认返回结果未排序，可以指定ASC或DESC按距离排序。

COUNT表示指定返回元素的数量，如果不指定则返回全部符合的元素。

当GEORADIUS和GEORADIUSBYMEMBER命令有了STORE和STOREDIST参数时，这两命令被标记成了写命令。在集群中，如果设置了READONLY，它们将被重定向到主节点，即使它们没有做写操作。但为了解决这个问题，在Redis4.0引入了这两个命令的变种，分别是GEORADIUS_RO和GEORADIUSBYMEMBER_RO。

GEORADIUSBYMEMBER

最早可用版本：3.2.0

时间复杂度：O(N+log(M))，N是半径区域内元素数量，M是指定key中元素数量

用法：GEORADIUSBYMEMBER key member radiusm|km|ft|mi [WITHCOORD] [WITHDIST] [WITHHASH][COUNT count] [ASC|DESC] [STORE key][STOREDIST key]

这个命令和GEORADIUS命令一样，都可以找出位置范围内的元素，但指定中心点的方式不同，该命令直接指定key中的元素作为中心，而不像GEORADIUS一样指定经纬度。