Redis 7的地理信息命令太太太牛了！一文教你如何使用

╰半夏微凉° 2023-10-12 15:36 16阅读 0赞

Redis是一款流行的开源内存数据库，具有快速、可扩展和多功能的特点。Redis 7引入了对地理信息的支持，通过新的地理信息命令，可以在Redis中存储和处理地理位置数据。本文将详细介绍Redis 7中的地理信息命令及其用法。

![0f386dea95b55826c96404961042def0.png][]

### 地理信息命令概述 ###

Redis 7引入了一组新的地理信息命令，用于处理地理位置和距离计算。这些命令使用经度和纬度坐标表示地理位置，并提供了各种功能，如存储位置、计算距离、查找附近的位置等。下面是Redis 7中常用的地理信息命令：

*  `GEOADD`：将指定的地理位置添加到指定的键中。
 *  `GEODIST`：计算两个位置之间的距离。
 *  `GEOHASH`：获取指定位置的地理哈希值。
 *  `GEOPOS`：获取一个或多个位置的经度和纬度。
 *  `GEORADIUS`：根据指定的位置和距离，在指定的键中查找附近的位置。
 *  `GEORADIUSBYMEMBER`：根据指定的位置成员和距离，在指定的键中查找附近的位置。
 *  `GEOSEARCH`：根据指定的查询参数，在指定的键中搜索符合条件的位置。
 *  `GEOSEARCHSTORE`：根据指定的查询参数，在指定的键中搜索符合条件的位置，并将结果存储到新的键中。

接下来，我们将逐个介绍这些命令的用法和示例。

![277487cfb332e64426425684df44d9c2.png][]

### GEOADD ###

`GEOADD`命令用于将一个或多个地理位置及其名称添加到指定的键中。它的语法如下：

GEOADD key longitude latitude member [longitude latitude member ...]

其中，`key`是指定的键，`longitude`是地理位置的经度，`latitude`是地理位置的纬度，`member`是地理位置的名称或标识。

示例：

GEOADD cities 13.361389 38.115556 "Palermo" 15.087269 37.502669 "Catania"

上述示例将两个地理位置及其名称添加到名为`cities`的键中。

### GEODIST ###

`GEODIST`命令用于计算两个地理位置之间的距离。它的语法如下：

GEODIST key member1 member2 [unit]

其中，`key`是指定的键，`member1`和`member2`是要计算距离的地理位置的名称或标识，`unit`是可选的距离单位，默认为米（m）。

示例：

GEODIST cities "Palermo" "Catania" km

上述示例将计算了名为`cities`中`"Palermo"`和`"Catania"`两个地理位置之间的距离，并指定距离单位为千米。

### GEOHASH ###

`GEOHASH`命令用于获取指定位置的地理哈希值。地理哈希值是一种用于表示地理位置的字符串编码。它的语法如下：

GEOHASH key member [member ...]

其中，`key`是指定的键，`member`是要获取地理哈希值的地理位置的名称或标识。

示例：

GEOHASH cities "Palermo" "Catania"

上述示例将获取名为`cities`中`"Palermo"`和`"Catania"`两个地理位置的地理哈希值。

### GEOPOS ###

`GEOPOS`命令用于获取一个或多个位置的经度和纬度。它的语法如下：

GEOPOS key member [member ...]

其中，`key`是指定的键，`member`是要获取经度和纬度的地理位置的名称或标识。

示例：

GEOPOS cities "Palermo" "Catania"

上述示例将获取名为`cities`中`"Palermo"`和`"Catania"`两个地理位置的经度和纬度。

### GEORADIUS ###

`GEORADIUS`命令用于根据指定的位置和距离，在指定的键中查找附近的位置。它的语法如下：

GEORADIUS key longitude latitude radius unit [WITHCOORD] [WITHDIST] [ASC|DESC] [COUNT count]

其中，`key`是指定的键，`longitude`是中心位置的经度，`latitude`是中心位置的纬度，`radius`是搜索的半径，`unit`是距离单位。可选的参数包括：

*  `WITHCOORD`：返回位置的经度和纬度。
 *  `WITHDIST`：返回位置与中心位置的距离。
 *  `ASC|DESC`：按距离升序或降序排序。
 *  `COUNT count`：返回最多指定数量的结果。

示例：

GEORADIUS cities 15.087269 37.502669 100 km WITHDIST COUNT 5

上述示例将在名为`cities`的键中，以`(15.087269, 37.502669)`为中心，搜索半径为100千米范围内的位置，并返回最多5个结果以及与中心位置的距离。

### GEORADIUSBYMEMBER ###

`GEORADIUSBYMEMBER`命令与`GEORADIUS`命令类似，不同之处在于它根据指定的位置成员和距离，在指定的键中查找附近的位置。它的语法如下：

GEORADIUSBYMEMBER key member radius unit [WITHCOORD] [WITHDIST] [ASC|DESC] [COUNT count]

示例：

GEORADIUSBYMEMBER cities "Palermo" 100 km WITHDIST COUNT 5

上述示例将在名为`cities`的键中，以`"Palermo"`位置成员为中心，搜索半径为100千米范围内的位置，并返回最多5个结果以及与中心位置的距离。

### GEOSEARCH ###

`GEOSEARCH`命令用于根据指定的查询参数，在指定的键中搜索符合条件的位置。它的语法如下：

GEOSEARCH key [FROMMEMBER member] [FROMCOORD longitude latitude] [BYRADIUS radius unit] [BYBOX width height unit] [WITHCOORD] [WITHDIST] [ASC|DESC] [COUNT count] [STORE key] [STOREDIST key]

其中，`key`是指定的键，可选的查询参数包括：

*  `FROMMEMBER member`：从指定的位置成员开始搜索。
 *  `FROMCOORD longitude latitude`：从指定的经度和纬度开始搜索。
 *  `BYRADIUS radius unit`：根据半径进行搜索。
 *  `BYBOX width height unit`：根据矩形区域进行搜索。
 *  `WITHCOORD`：返回位置的经度和纬度。
 *  `WITHDIST`：返回位置与查询点的距离。
 *  `ASC|DESC`：按距离升序或降序排序。
 *  `COUNT count`：返回最多指定数量的结果。
 *  `STORE key`：将结果存储到指定的键中。
 *  `STOREDIST key`：将结果存储到指定的键中，并同时存储位置与查询点的距离。

示例：

GEOSEARCH cities BYRADIUS 15.087269 37.502669 100 km WITHDIST COUNT 5

上述示例将在名为`cities`的键中，以`(15.087269, 37.502669)`为中心，半径为100千米范围内进行搜索，并返回最多5个结果以及与查询点的距离。

### GEOSEARCHSTORE ###

`GEOSEARCHSTORE`命令与`GEOSEARCH`命令类似，不同之处在于它将搜索结果存储到一个新的键中。它的语法如下：

GEOSEARCHSTORE destkey key [FROMMEMBER member] [FROMCOORD longitude latitude] [BYRADIUS radius unit] [BYBOX width height unit] [WITHCOORD] [WITHDIST] [ASC|DESC] [COUNT count] [STOREDIST key]

示例：

GEOSEARCHSTORE results cities BYRADIUS 15.087269 37.502669 100 km WITHDIST COUNT 5

上述示例将在名为`cities`的键中，以`(15.087269, 37.502669)`为中心，半径为100千米范围内进行搜索，并将结果存储到名为`results`的新键中。

### 总结 ###

Redis 7中引入了一组新的地理信息命令，使其成为更加全面和多功能的数据库。这些地理信息命令允许在Redis中存储和处理地理位置数据，包括添加地理位置、计算距离、获取地理哈希值、获取经度和纬度、搜索附近的位置等操作。这些命令提供了方便而强大的功能，可以在各种应用场景中使用。

通过使用`GEOADD`命令，我们可以将地理位置及其名称添加到Redis中的指定键中，方便地存储和管理位置数据。`GEODIST`命令允许计算两个位置之间的距离，提供了方便的距离计算功能。使用`GEOHASH`命令可以获取位置的地理哈希值，方便进行位置的索引和查询。通过`GEOPOS`命令，我们可以获取一个或多个位置的经度和纬度信息。

对于位置搜索，Redis提供了多种命令。`GEORADIUS`命令可以根据指定的位置和距离，在指定的键中查找附近的位置。类似地，`GEORADIUSBYMEMBER`命令允许根据指定的位置成员和距离进行搜索。`GEOSEARCH`命令提供更灵活的搜索选项，可以根据查询参数进行位置搜索。而`GEOSEARCHSTORE`命令在执行搜索的同时，将结果存储到新的键中，方便后续使用。

这些地理信息命令使得Redis在地理位置数据处理方面变得更加强大和灵活。无论是构建位置服务应用、实现位置关联功能，还是进行位置数据分析和可视化，Redis的地理信息命令都为开发人员提供了丰富的工具和功能。

总而言之，Redis 7中的地理信息命令为处理和管理地理位置数据提供了强大的功能。通过这些命令，开发人员可以方便地存储、查询和分析地理位置信息，为各种应用场景提供了更多的可能性。

[0f386dea95b55826c96404961042def0.png]: https://img-blog.csdnimg.cn/img_convert/0f386dea95b55826c96404961042def0.png
[277487cfb332e64426425684df44d9c2.png]: https://img-blog.csdnimg.cn/img_convert/277487cfb332e64426425684df44d9c2.png