redis之地理位置

目录

GEOADD

语法

返回值

GEOPOS

语法

返回值

GEODIST

语法

返回值

GEORADIUS

扫描二维码关注公众号,回复: 6040300 查看本文章

语法

返回值

GEOHASH

语法

返回值

GEORADIUSBYMEMBER

语法

返回值


官方文档:http://redisdoc.com/geo/georadiusbymember.html 

GEOADD

语法

GEOADD key longitude latitude member [longitude latitude member ...]

将给定的空间元素(经度,纬度,名字)添加到指定的键里面。

这些数据会以有序集合的形式被存储在键里面,从而使得像GEORADIUS和GEORADIUSBYMEMBER这样的命令可以在之后通过位置查询取得这些元素。

非常接近两级的区域是无法被索引的。

有效的经度介于-180°至180°之间

有效的纬度介于-85.05112878°至85.05112878°

当输入的范围超出经度或者纬度范围时,geoadd返回错误。

返回值

新添加到键里面的空间元素数量,不包括那些已经存在但是被更新的元素。

redis> GEOADD Sicily 13.361389 38.115556 "Palermo" 15.087269 37.502669 "Catania"
(integer) 2

redis> GEODIST Sicily Palermo Catania
"166274.15156960039"

redis> GEORADIUS Sicily 15 37 100 km
1) "Catania"

redis> GEORADIUS Sicily 15 37 200 km
1) "Palermo"
2) "Catania"

GEOPOS

语法

GEOPOS key member [member ...]

从键里面返回所有给定位置元素的位置(经度和纬度)

因为geopos命令接受可变数量的位置元素作为参数,所以即使只给了一个位置元素,命令也会返回数组回复。

返回值

返回数组,数组中的每个项都由两个元素组成:第一个元素是给定位置元素的经度,第二个元素是给定元素的纬度。

当给定的位置不存在时,对应的数组为空值。

redis> GEOADD Sicily 13.361389 38.115556 "Palermo" 15.087269 37.502669 "Catania"
(integer) 2

redis> GEOPOS Sicily Palermo Catania NonExisting
1) 1) "13.361389338970184"
   2) "38.115556395496299"
2) 1) "15.087267458438873"
   2) "37.50266842333162"
3) (nil)

GEODIST

语法

GEODIST key member1 member2 [unit]

返回两个给定位置之间的距离

如果两个位置之间的其中一个不存在,那么命令返回空值。

指定的单位unit必须是以下之一:

m:单位米
km:单位千米
mi:单位英里
ft:单位英尺

如果没有显示指定单位参数,那么默认为m。

GEODIST在计算距离时会假设地球为完美的球形,会造成0.5%的误差。

返回值

计算出的距离会以双精度浮点数的形式被返回,如果给定的位置不存在,那么命令返回空值。

redis> GEOADD Sicily 13.361389 38.115556 "Palermo" 15.087269 37.502669 "Catania"
(integer) 2

redis> GEODIST Sicily Palermo Catania
"166274.15156960039"

redis> GEODIST Sicily Palermo Catania km
"166.27415156960038"

redis> GEODIST Sicily Palermo Catania mi
"103.31822459492736"

redis> GEODIST Sicily Foo Bar
(nil)

GEORADIUS

语法

GEORADIUS key longitude latitude radius m|km|ft|mi [WITHCOORD] [WITHDIST] [WITHHASH] [ASC|DESC] [COUNT count]

以给定的经纬度为中心,返回键包含的位置元素当中,与中心的距离不超过给定最大距离的所有位置元素。

范围可以是以下其中一个单位

m:米
km:千米
mi:英里
ft:英尺

在给定以下可选项时,命令会返回额外的信息:

WITHSIST:在返回位置元素的同时,将位置元素与中心之间的距离也一并返回。距离的单位与用户给定的范围单位保持一致
WITHCOORD:将位置元素的经纬度一并返回
WITHHASH:以52位有符号整数的形式,返回位置元素经过原始geohash编码有序集合分值。主要用于底层应用或调试。

命令返回未排序的位置元素

ASC:根据中心位置,按照从近到远的方式返回位置元素
DESC:根据中心位置,按照从远到近的方式返回位置元素

默认情况下,GEORADIUS会返回所有匹配的位置元素。可以使用count<count>选项获取前N个匹配元素。但是命令内部可能会对所有匹配的元素进行处理,会导致命令执行速度很慢。但是使用count可以减少需要返回的元素数量,对于减少带宽是有用的。

返回值

返回一个数组。

在没有给定任何WITH选项情况下,返回一个像["new york", "paris"]这样的线性列表

指定了WITH选项的情况下,会返回一个二层嵌套数组。子数组的第一个元素总是位置元素的名字

GEOHASH

语法

GEOHASH key member [member …]

返回一个或多个位置元素的geohash表示

返回值

数组,数组的每个项都是一个geohash。返回的geohash的位置与用户给定的位置元素的位置一一对应。

GEORADIUSBYMEMBER

语法

GEORADIUSBYMEMBER key member radius m|km|ft|mi [WITHCOORD] [WITHDIST] [WITHHASH] [ASC|DESC] [COUNT count]

 

与georadius命令一样,可以找出位于指定范围内的元素,但是GEORADIUSBYMEMBER的中心点是由给定的位置元素决定的,而不是像georadius那样使用输入的经纬度来决定中心点。

返回值

数组,数组中的每个项表示一个范围内的位置元素

猜你喜欢

转载自blog.csdn.net/u010918487/article/details/89382531