前言
支持 GEO 系列命令的 Redis 版本从 3.2.0 起开始才可以使用,所以之前版本就不要想了。
函数列表
geoadd - 将指定的地理空间项(纬度,经度,名称)添加到指定的键, 数据作为有序集存储在 Redis 中。
GEOADD key longitude latitude member [longitude latitude member …]
key - 存储在 Redis 中的指定的键
longitude - 经度
latitude - 纬度
member - 成员名称
<?php
$redis->geoadd("city", 117.224311, 39.111515, "天津")
// 1
$redis->geoadd("city", 116.40378, 39.91544, "北京", 121.473913, 31.222965, "上海")
// 2
?>
geopos - 返回由key处的有序集表示的地理空间索引的所有指定成员的位置(经度,纬度)。
GEOPOS key member [member ...]
key - 存储在 Redis 中的指定的键
member - 成员名称
<?php
$redis->geopos("city", "天津") // Array ( [0] => Array ( [0] => 117.22431153059005737 [1] => 39.11151424175071867 ) )
$redis->geopos("city", "天津", "北京") // Array ( [0] => Array ( [0] => 117.22431153059005737 [1] => 39.11151424175071867 ) [1] => Array ( [0] => 116.40378087759017944 [1] => 39.91543907825245441 ) )
?>
geodist - 返回由有序集合表示的地理空间索引中的两个成员之间的距离。
GEODIST key member1 member2 [unit]
key - 存储在 Redis 中的指定的键
member - 成员名称
unit - 单位 m(米),km(千米),mi(英里),ft(英尺)
<?php
$redis->geodist("city","天津", "北京","km") //113.8093
?>
georadius - 使用GEOADD返回包含地理空间信息的已排序集合的成员,这些信息位于中心位置和与中心的最大距离(半径)指定区域的边界内。
GEORADIUS key longitude latitude radius unit(m|km|ft|mi) [WITHCOORD] [WITHDIST] [WITHHASH][COUNT count] [ASC|DESC] [STORE key][STOREDIST key]
key - 存储在 Redis 中的指定的键
longitude - 经度
latitude - 纬度
radius - 半径
unit - 单位 m(米),km(千米),mi(英里),ft(英尺)
WITHCOORD 返回目标的经纬度
WITHDIST 返回距离中心点的距离
WITHHASH 返回 52位 无符号整数的 geohash 有序集合分数
COUNT 返回条数
ASC|DESC 正序排序|倒序排序
<?php
$redis->georadius("city", 117.224311, 39.111515, 1000, "km", ['WITHDIST','ASC'])
// Array ( [0] => Array ( [0] => 上海 [1] => 958.4076 ) [1] => Array ( [0] => 北京 [1] => 113.8092 ) [2] => Array ( [0] => 天津 [1] => 0.0001 ) )
$redis->georadius("city", 117.224311, 39.111515, 1000, "km", ['WITHCOORD','WITHDIST','ASC','COUNT'=>1])
// Array ( [0] => Array ( [0] => 天津 [1] => 0.0001 [2] => Array ( [0] => 117.22431153059005737 [1] => 39.11151424175071867 ) ) )
?>
georadiusbymember - 这个命令与GEORADIUS完全相同,区别在于该命令返回的是成员附近的所有成员
GEORADIUSBYMEMBER key member radius unit(m|km|ft|mi) [WITHCOORD] [WITHDIST] [WITHHASH][COUNT count] [ASC|DESC] [STORE key][STOREDIST key]
key - 存储在 Redis 中的指定的键
member - 成员名称
radius - 半径
unit - 单位 m(米),km(千米),mi(英里),ft(英尺)
WITHCOORD 返回目标的经纬度
WITHDIST 返回距离中心点的距离
WITHHASH 返回 52位 无符号整数的 geohash 有序集合分数
COUNT 返回条数
ASC|DESC 正序排序|倒序排序
<?php
$redis->georadiusbymember("city", "天津", 200, "km", ['WITHCOORD', 'WITHDIST', 'ASC'])
//Array ( [0] => Array ( [0] => 天津 [1] => 0.0000 [2] => Array ( [0] => 117.22431153059005737 [1] => 39.11151424175071867 ) ) [1] => Array ( [0] => 北京 [1] => 113.8093 [2] => Array ( [0] => 116.40378087759017944 [1] => 39.91543907825245441 ) ) )
?>
geohash - 返回有效的Geohash字符串
GEOHASH key member [member …]
key - 存储在 Redis 中的指定的键
member - 成员名称
<?php
$redis->geohash("city", "天津", "北京")
// Array ( [0] => wwgqe801h60 [1] => wx4g0f6sk90 )