前言:
这两天回顾了下之前做的一个轻度社交小程序,代码写的真tm糙hah.另外发现附近人功能使用的redis-GEO竟然没落文档..,所以在这里补充一下.地理位置管理神器,codeMan奉上
1.概念
redis的GEO特性最早是在2014年初以redis模块形式编写,2016年官方二次修改后发布。
redis的GEO特性为Redis3.2版本版本添加的新特性
redis的GEO特性可以将用户给定的地理位置存储起来,并对这些信息进行操作。
redis的GEO特性底层实现为zset(记忆)
3.GEO相关命令
1.命令:GEOADD
-
参数:
key : 地理位置集
longitude: 经度
latitude: 维度
member: 成员
-
语法:
- GEOADD key longitude latitude member [longitude latitude member
-
功能:
- 将给定的空间元素(经度、维度)和成员添加到指定的地理位置(key)集里面
-
返回值:
- 如果成员是新成员,则为1;如果成员是更新成员,则为0
-
说明:
有效的经度介于-180度至180度之间。
有效的维度介于-85.05112878度至85.05112878度之间。
此方法可以一次添加多个成员
-
示例:
- 添加
-
修改
添加多个成员
2.命令:GEOPOS
-
参数:
key : 地理位置集
member: 成员
-
语法:
- GEOPOS key member [member
-
功能:
- 从地理位置集里面返回所有给定位置元素的位置信息(经度和维度)
-
返回值:
-
指定成员的位置信息排列如下
- 经度
- 维度
-
-
示例:
- 查询单个成员
- 查询多个成员
3.命令:GEODIST
-
参数:
key : 地理位置集
member: 成员
unit:指定单位
-
语法:
- GEOPOS key member1 member2 [unit]
-
功能:
- 返回两给定成员之间的距离
-
说明:
如果两个位置之间的其中一个不存在,那么返回空值。
指定单位的参数unit必须是一下单位的其中一个:(默认m,km,mi,ft)
-
返回值:
- 计算出的距离会以双精度浮点数的形式被返回。如果给定的位置元素不存在,那么命令返回空值
-
示例:
- 距离计算-不指定unit
- 距离计算-指定unit为KM
- 其中一个成员不存在
4.命令GEORADIUS
-
参数:
key : 地理位置集
longitude: 当前经度
latitude: 当前维度
radius:半径
m|km|gt|mi:单位
[WITHCOORD]:将成员的经度和纬度也一并返回。
[WITHDIST]:在返回成员的同时,将位置元素与中心之间的距离也一并返回。
[WITHHASH]:以52位有符号整数的形式,返回成员经过原始geohash编码的有序集合分值。这个选项主要用于底层应用或者调试,实际中的作用并不大。
[ASC|DESC] :根据中心的位置,按照从[近到远|远到近]的方式返回位置元素
-
语法:
- GEORADIUS key longitude latitude radius m|km|gt|mi [WITHCOORD] [WITHDIST] [WITHHASH] [ASC|DESC] [WITHGEOJSON]
-
返回值:
以给定的经纬度为中心,返回地理位置集中与中心的距离不超过给定最大半径的所有用户.
-
示例:
- 添加全部参数-近到远排列
-
图解
- 1)成员
2)距离
3)52位有符号整数
4)成员位置经度
5)成员位置维度
5.命令:GEORADIUSBYMEMBER
-
说明:
这个命令和georadius命令一样,都可以找出位于指定半径内的成员,但是georadiusbymember的中心点是由给定的成员决定的,而不是像georadius那样,使用输入的经度和纬度来决定中心点。
返回值中同样包含中心点成员本身.
-
特殊参数(相对georadius)
- member: 成员
-
语法:
- GEORADIUSBYMEMBER key longitude latitude radius m|km|gt|mi [WITHCOORD] [WITHDIST] [WITHHASH] [ASC|DESC] [WITHGEOJSON]
-
示例:
- 添加全部参数-远到近排列
6.删除成员命令
-
说明:
- GEO没有提供删除成员的命令,但是因为GEO的底层实现是zset,所以可以借用zrem命令实现对地理位置信息的删除.
-
语法:
- ZREM key member [member ...]
-
返回值:
- 删除成员个数
-
示例:
- 删除一个成员
- 删除多个成员
写在后面
Redis-GEO底层是无序集合结构,这个结构对后端开发的功能超级友好.排行榜等类似的功能也可以用它来实现.喜欢redis