前言:
这两天回顾了下之前做的一个轻度社交小程序,代码写的真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度之间。
-
此方法可以一次添加多个成员
-
-
示例：
- 添加
添加天安门位置.png
-
修改
修改天安门位置.png
-
添加多个成员
添加天坛和故宫位置.png
2.命令:GEOPOS
-
参数：
-
key : 地理位置集
-
member: 成员
-
-
语法：
- GEOPOS key member [member
-
功能：
- 从地理位置集里面返回所有给定位置元素的位置信息（经度和维度)
-
返回值:
-
指定成员的位置信息排列如下
- 经度
- 维度
-
-
示例:
- 查询单个成员
查询天安门位置.png
- 查询多个成员
查询天坛和故宫位置.png
3.命令：GEODIST
-
参数：
-
key : 地理位置集
-
member: 成员
-
unit：指定单位
-
-
语法：
- GEOPOS key member1 member2 [unit]
-
功能：
- 返回两给定成员之间的距离
-
说明:
-
如果两个位置之间的其中一个不存在，那么返回空值。
-
指定单位的参数unit必须是一下单位的其中一个：（默认m,km,mi,ft)
-
-
返回值：
- 计算出的距离会以双精度浮点数的形式被返回。如果给定的位置元素不存在，那么命令返回空值
-
示例:
- 距离计算-不指定unit
天坛与故宫距离(单位M).png
- 距离计算-指定unit为KM
天坛与故宫距离(单位KM).png
- 其中一个成员不存在
缺少一个成员.png
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]
-
返回值：
以给定的经纬度为中心，返回地理位置集中与中心的距离不超过给定最大半径的所有用户.
-
示例:
- 添加全部参数-近到远排列
georadius.png
-
图解
- 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]
-
示例:
- 添加全部参数-远到近排列
georadiusbymember.png
6.删除成员命令
-
说明:
- GEO没有提供删除成员的命令，但是因为GEO的底层实现是zset，所以可以借用zrem命令实现对地理位置信息的删除.
-
语法:
- ZREM key member [member ...]
-
返回值:
- 删除成员个数
-
示例:
- 删除一个成员
删除天安门.png
- 删除多个成员
删除故宫和天坛.png
写在后面
Redis-GEO底层是无序集合结构，这个结构对后端开发的功能超级友好.排行榜等类似的功能也可以用它来实现.喜欢redis
网友评论