目录
[1 基本特性](#1 基本特性)
[2 主要操作命令](#2 主要操作命令)
[2.1 GEOADD key longitude latitude member [longitude latitude member ...]](#2.1 GEOADD key longitude latitude member [longitude latitude member ...])
[2.2 GEOPOS key member [member ...]](#2.2 GEOPOS key member [member ...])
[2.3 GEODIST key member1 member2 [unit]](#2.3 GEODIST key member1 member2 [unit])
[2.4 GEORADIUS key longitude latitude radius unit [WITHCOORD] [WITHDIST] [WITHHASH] [COUNT count] [ASC|DESC] [STORE key] [STOREDIST key]](#2.4 GEORADIUS key longitude latitude radius unit [WITHCOORD] [WITHDIST] [WITHHASH] [COUNT count] [ASC|DESC] [STORE key] [STOREDIST key])
[2.5 GEORADIUSBYMEMBER key member radius unit [WITHCOORD] [WITHDIST] [WITHHASH] [COUNT count] [ASC|DESC] [STORE key] [STOREDIST key]](#2.5 GEORADIUSBYMEMBER key member radius unit [WITHCOORD] [WITHDIST] [WITHHASH] [COUNT count] [ASC|DESC] [STORE key] [STOREDIST key])
[2.6 GEOHASH key member [member ...]](#2.6 GEOHASH key member [member ...])
Redis 的地理空间索引(Geospatial Indexes)提供了一种高效的方式来存储和查询地理位置信息,允许你存储地理位置信息,并提供了多种操作来处理这些数据,比如计算两点之间的距离、查找给定半径内的点等,这种数据类型非常适合需要处理与位置相关的应用,例如地图服务、基于位置的服务(LBS)、实时跟踪等。
1 基本特性
-
高效的空间查询:Redis 使用高效的算法来执行范围查询和距离计算。它能够在很短的时间内找到指定半径内的所有点,这对于实时应用非常有用。
-
低内存占用:通过使用 GeoHash 和其他压缩技术,Redis 能够在存储大量地理位置信息时保持较低的内存占用。每个位置通常只需要少量字节来表示。
-
支持多种操作:除了基本的添加和查询功能外,Geospatial Indexes 还支持距离计算、坐标获取、GeoHash 编码等操作。这些功能使得它能够满足各种基于位置的应用需求。
-
精确度与性能平衡:在默认情况下,Redis 使用的 GeoHash 精确到约 1 米左右。这为大多数应用场景提供了足够的精确度,同时保证了良好的性能。用户可以根据需要调整精确度,以达到精确度和性能的最佳平衡。
基本概念:
- 坐标:在 Redis 中,一个地理位置由经度和纬度表示。
- 成员:每个地理位置可以关联一个名称或标识符,称为成员。
- 距离单位:支持的距离单位包括米(m)、千米(km)、英里(mi)和海里(ft)。
2 主要操作命令
2.1 GEOADD key longitude latitude member [longitude latitude member ...]
添加一个或多个地理位置到指定的键中。每个地理位置由经度、纬度和成员名组成。如果键不存在,则创建新键。
127.0.0.1:6379> geoadd mycity 120.753466 31.222895 "shanghai" 116.407394 39.904111 "beijing"
(integer) 2
2.2 GEOPOS key member [member ...]
获取一个或多个成员的地理位置(经纬度)。
127.0.0.1:6379> geopos mycity shanghai beijing
1) 1) "120.75346559286117554"
2) "31.22289421634820172"
2) 1) "116.40739649534225464"
2) "39.90411140939136914"
2.3 GEODIST key member1 member2 [unit]
计算两个成员之间的距离,默认单位是米。可以使用 m
(米)、km
(千米)、mi
(英里)或 ft
(英尺)来指定其他单位。
127.0.0.1:6379> geodist mycity shanghai beijing
"1042208.3193"
127.0.0.1:6379> geodist mycity shanghai beijing km
"1042.2083"
2.4 GEORADIUS key longitude latitude radius unit [WITHCOORD] [WITHDIST] [WITHHASH] [COUNT count] [ASC|DESC] [STORE key] [STOREDIST key]
类似于 GEORADIUS,但是以某个已存在的成员作为中心点。以给定的经纬度为中心,返回半径内的所有成员。可以附加选项来获取额外的信息,如距离、哈希值或排序结果。
127.0.0.1:6379> georadius mycity 120.753466 31.222895 500 km withdist
1) 1) "shanghai"
2) "0.0001"
2.5 GEORADIUSBYMEMBER key member radius unit [WITHCOORD] [WITHDIST] [WITHHASH] [COUNT count] [ASC|DESC] [STORE key] [STOREDIST key]
以给定的成员位置为中心,返回半径内的所有成员。用法与 GEORADIUS 类似,只是中心点是通过成员名称指定的。
127.0.0.1:6379> georadiusbymember mycity shanghai 500 km withdist
1) 1) "shanghai"
2) "0.0000"
2.6 GEOHASH key member [member ...]
返回一个或多个成员的 Geohash 编码。Geohash 是一种将经纬度编码为短字符串的方法,便于快速比较和搜索。
127.0.0.1:6379> geohash mycity shanghai beijing
1) "wttcegcyx90"
2) "wx4g0bm62c0"
更多命令请参考:Commands | Docs