GEODIST key member1 member2 [m|km|ft|mi]

Redis GEODIST 命令用于返回两个给定位置之间的距离。

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

*语法

GEODIST 语法格式如下:

GEODIST key member1 member2 [m|km|ft|mi]

member1 member2 为两个地理位置。

最后一个距离单位参数说明:

  • m :米,默认单位。
  • km :千米。
  • mi :英里。
  • ft :英尺。

如果用户没有显式地指定单位参数, 那么 GEODIST 默认使用米作为单位。

GEODIST 命令在计算距离时会假设地球为完美的球形, 在极限情况下, 这一假设最大会造成 0.5% 的误差。

*返回值

多行字符串:

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

*例子

redis>  GEOADD Sicily 13.361389 38.115556 "Palermo" 15.087269 37.502669 "Catania"
(integer) 2
redis>  GEODIST Sicily Palermo Catania
"166274.1516"
redis>  GEODIST Sicily Palermo Catania km
"166.2742"
redis>  GEODIST Sicily Palermo Catania mi
"103.3182"
redis>  GEODIST Sicily Foo Bar
(nil)
redis>