3.8、GEO

GEO

Redis3.2版本提供了GEO(地理信息定位)功能,支持存储地理位置信息用来实现诸
如附近位置、摇一摇这类依赖于地理位置信息的功能,对于需要实现这些功能的开发
者来说是一个福音。GEO功能是Redis的另一位作者Matt Stancliff借鉴NoSQL数据
库Ardb实现的,Ardb的作者是来自中国,它供了优秀的GEO功能。

  1. 增加地理位置信息

    geoadd key longitude latitude member [longitude latitude member ...]

    longitude、latitude、member分别是该地理位置的经度、纬度、成员,下表
    展示了5个城市的经纬度

    城市 经度 纬度 成员
    北京 116.28 39.55 beijing
    天津 117.12 39.08 tianjin
    石家庄 114.29 38.02 shijiazhuang
    唐山 118.01 39.38 tangshan
    保定 115.29 38.51 baoding

    cities:locations是上面5个城市地理位置信息的几个,现向其添加北京的地
    理位置信息:

    1270.0.0.1:6379> geoadd cities:locations 116.28 39.55 beijing
    (integer) 1
    

    返回结果代表添加成功的个数,如果cities:locations没有包含beijing,那
    么返回结果为1,如果已经存在则返回0:

    1270.0.0.1:6379> geoadd cities:locations 116.28 39.55 beijing
    (integer) 0
    

    如果需要更新地理位置信息,仍然可以使用geoadd命令,虽然返回结果为
    0.geoadd命令可以同时添加多个地理位置信息:

    1270.0.0.1:6379> geoadd cities:locations 117.12 39.08 tianjin 114.29 38.02 shijiazhuang 118.01 39.38 tangshan 115.29 38.51 baoding
    (integer) 4
    
  2. 获取地理位置信息

    geopos key member [member ...]

    下面操作会获取天津的经纬度:

    1270.0.0.1:6379> geopos cities:location tianjian
    1) 1) "117.12000042200088501"
       2) "39.0800000535766543"
    
  3. 获取两个地理位置的距离

    geodist key member1 member2 [unit]

    其中unit代表返回结果的单位,包含以下四中:

    • m(meters)代表米
    • km(kilometers)代表千米
    • mi(miles)代表英尺
    • ft(feet)代表尺

    下面操作用于计算天津到北京的距离,并以公里为单位:

    1270.0.0.1:6379> geodist cities:location tianjin beijing km
    "89.2061"
    
  4. 获取指定位置范围内的地理信息位置集合

    georadius key longitude latitude radiusm|km|ft|mi [withcoord] [withdist] [withhash] [COUNT count] [asc|desc] [store key] [storedist key]
    
    georadiusbymember key member radiusm|km|ft|mi [withcoord] [withdist] [withhash] [COUNT count] [asc|desc] [store key] [storedist key]
    

    georadisu和georadiusbymember两个命令的作用是一样的,都是以一个地理
    位置为中心算出指定半径内的其他地理信息位置,不同的是georadius命令的中
    心位置给出了具体的经纬度,georadiusbymember只需给出成员即可。其中
    radiusm|km|ft|mi是必需参数,指定了半径(带单位),这两个命令有很多可
    选参数,如下所示:

    • withcoord:返回结果中包含经纬度。
    • withdist:返回结果中包含离中心节点位置的距离。
    • withhash:返回结果中包含geohash,有关geohash后面介绍。
    • COUNT count:指定返回结果的数量。
    • asc|desc:返回结果按照离中心节点的距离做升序或者降序。
    • store key:将返回结果的地理位置信息保存到指定键。
    • storedist key:将返回结果离中心节点的距离保存到指定键。

    下面操作计算第五座城市中,距离北京150公里以内的城市:

    127.0.0.1:6379> georadiusbymember cities:location beijing 150 km
    1) "beijing"
    2) "tianjin"
    3) "tangshan"
    4) "baoding"
    
  5. 获取geohash

    geohash key member [member ...]

    Redis使用geohash将二维经纬度转换为一维字符串,下面操作会返回beijing
    的geohash值。

    127.0.0.1:6379> geohash cities:locations beijing
    1) "wx4ww02w070"
    

    geohash有如下特点:

    • GEO的数据类型zset,Redis将所有地理位置信息的geohash存放在zset中。

      127.0.0.1:6379> type cities:locations
      zset
      
    • 字符串越长,表示的位置更精确,下表给出了字符串长度对应的精度,例如
      geohash长度为9时,精度在2米左右。

      geohash长度 精确度(km)
      1 2500
      2 630
      3 78
      4 20
      5 2.4
      6 0.61
      7 0.076
      8 0.019
      9 0.002
    • 两个字符串越相似,它们之间的距离越近,Redis利用字符串前缀匹配算法实
      现相关的命令。

    • geohash编码和经纬度是可以相互转换的。

    Redis正式使用有序集合并结合geohash的特性实现了GEO的若干命令。

  6. 删除地理位置信息

    zrem key member

    GEO没有提供删除成员的命令,但是因为GEO的底层实现是zset,所以可以借用
    zrem命令实现对地理位置信息的删除。

你可能感兴趣的:(3.8、GEO)