GEORADIUS
GEORADIUS key longitude latitude radius m|km|ft|mi [WITHCOORD] [WITHDIST] [WITHHASH] [ASC|DESC] [COUNT count]
以給定的經緯度為中心, 返回鍵包含的位置元素當中, 與中心的距離不超過給定最大距離的所有位置元素。
范圍可以使用以下其中一個單位:
m
表示單位為米。km
表示單位為千米。mi
表示單位為英里。ft
表示單位為英尺。
在給定以下可選項時, 命令會返回額外的信息:
WITHDIST
: 在返回位置元素的同時, 將位置元素與中心之間的距離也一並返回。 距離的單位和用戶給定的范圍單位保持一致。WITHCOORD
: 將位置元素的經度和維度也一並返回。WITHHASH
: 以 52 位有符號整數的形式, 返回位置元素經過原始 geohash 編碼的有序集合分值。 這個選項主要用於底層應用或者調試, 實際中的作用並不大。
命令默認返回未排序的位置元素。 通過以下兩個參數, 用戶可以指定被返回位置元素的排序方式:
ASC
: 根據中心的位置, 按照從近到遠的方式返回位置元素。DESC
: 根據中心的位置, 按照從遠到近的方式返回位置元素。
在默認情況下, GEORADIUS
命令會返回所有匹配的位置元素。 雖然用戶可以使用 COUNT <count>
選項去獲取前 N 個匹配元素, 但是因為命令在內部可能會需要對所有被匹配的元素進行處理, 所以在對一個非常大的區域進行搜索時, 即使只使用 COUNT
選項去獲取少量元素, 命令的執行速度也可能會非常慢。 但是從另一方面來說, 使用 COUNT
選項去減少需要返回的元素數量, 對於減少帶寬來說仍然是非常有用的。