地理位置管理神器redis-GEO

前言:

这两天回顾了下之前做的一个轻度社交小程序,代码写的真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

• 功能：

  • 从地理位置集里面返回所有给定位置元素的位置信息（经度和维度)

• 返回值:

  • 指定成员的位置信息排列如下

    1. 1. 经度
    2. 维度

• 示例:

  • 查询单个成员
  查询天安门位置.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. 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