Redis GEORADIUS –特定のエリア内にある地理的価値の要素を取得する方法

このチュートリアルでは、特定の領域に該当するキーに格納されている地理空間値の要素を取得する方法について学習します。このために、Redis GEORADIUSを使用します コマンド。

GEORADIUSコマンド

このコマンドは、経度、緯度、および半径の引数を使用して計算された領域の境界内にある、キーに格納されている地理空間値（Sorted Set）の1つ以上のメンバーを返すために使用されます。この面積は、指定された経度、緯度の値を円の中心位置として使用し、指定された単位の半径を円の半径として使用して計算されます。

半径は、次のいずれかの単位を使用して指定されます：-

1. m メーター用（デフォルト）。
2. km キロメートルのために。
3. mi 何マイルも。
4. ft 足のために。

オプションの引数

Redis GEORADIUSコマンドは、次のオプションの引数を取ります：-

1. WITHDIST：- 円の中心から返された要素の距離を返します。距離の単位は、半径の引数の単位と同じです。
2. WITHCOORD：- 返されたすべての要素の経度、緯度の座標を返します。
3. WITHHASH：- 返されたすべての要素の生のジオハッシュ文字列（52ビットの符号なし整数）を返します。このジオハッシュ文字列は、並べ替えられたセット内の要素のスコアです。
4. ASC：- 中心を基準にして、最も近い並べ替え順序から最も遠い並べ替え順序まで要素を返します。デフォルトでは、要素はソートされていない順序で返されます。
5. DESC：- 中心を基準にして、最も近い並べ替え順序から最も近い並べ替え順序まで要素を返します。
6. COUNT < count >：- 最初のカウントに制限された要素を返します 一致する要素。デフォルトでは、一致するすべての要素が返されます。

戻り値

このコマンドは、次のタイプの値を含む配列応答を返します：-

1. [ WITHの場合 ] オプションの引数が指定されていない場合、このコマンドは要素の名前を含む配列を返します。
2. WITHCOORDの場合 、 WITHDIST 、 WITHHASH オプションが指定されている場合、このコマンドは配列の配列を返します。各サブ配列は単一の要素を表します。サブ配列の最初の項目は常に返される要素の名前であり、その他の情報は次の順序で返されます：-
   1. 半径で指定されたのと同じ単位での、浮動小数点数としての中心からの距離。
   2. ジオハッシュ整数。
   3. 2つのアイテムのx、y配列（経度、緯度）としての座標。

キーが存在しない場合はNilが返され、キーが存在する場合はエラーが返されますが、キーに格納されている値は、GEOADDコマンドを使用して入力されたソート済みのセットデータ型ではありません。 redis GEORADIUSコマンドの構文は次のとおりです：-

構文：-

redis host:post> GEORADIUS <keyname> <longitude> <latitude> <radius> [UNIT] [WITHCOORD] [WITHDIST] [WITHHASH] [COUNT count] [ASC|DESC] [STORE key] [STOREDIST key]

出力：-

- (array) reply, representing the elements of geospatial values.
- Nil, if key does not exist.
- Error, if key exist and value stored at the key is not a sorted set populated using GEOADD command.

例：-

参照：-

1. RedisGEORADIUSコマンドドキュメント

特定の領域に該当するredisデータストアに格納されている地理空間値の要素を取得する方法は以上です。気に入った場合は、コメントセクションで自分の考えを共有し、他の人にも共有してください。

<-ジオコマンド