本文主要是介绍redis之地理位置,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
目录
GEOADD
语法
返回值
GEOPOS
语法
返回值
GEODIST
语法
返回值
GEORADIUS
语法
返回值
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) 2redis> 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) 2redis> 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) 2redis> 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那样使用输入的经纬度来决定中心点。
返回值
数组,数组中的每个项表示一个范围内的位置元素
这篇关于redis之地理位置的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!