Tair (Redis® OSS-Compatible):GIS

パラメーター

説明

構文

GIS.ADDエリアpolygonName polygonWkt [polygonName polygonWkt ...]

時間の複雑さ

O (ログn)

コマンド説明

パラメーター

• area: 幾何学的な概念。

• PolygonName: 管理するポリゴンの名前。

• polygonWkt: WKTで記述されたポリゴンの説明。 説明は経度と緯度を含みます。 WKTでは、次のポリゴンタイプを記述できます。

  • POINT: ポイントを記述するWKT。 例: 'POINT (120.086631 30.138141)' この値は、点が経度120.086631および緯度30.138141に位置することを示す。

  • LINESTRING: ラインストリングを記述するWKT。 ラインストリングは2つの点からなる。 例: 'LINESTRING (30 10, 40 40) '

  • POLYGON: ポリゴンを記述するWKT。 多角形は複数の点からなる。 例: 'POLYGON ((31 20,29 20,29 21,31))' 。

  説明

  • 経度の有効値は − 180〜180であり、緯度の有効値は − 90〜90である。

  • MULTIPOINT、MULTILINESTRING、MULTIPOLYGON、GEOMETRY、またはCOLLECTIONコレクションタイプはサポートされていません。

Output

• 操作が成功すると、追加および更新されたポリゴンの数が返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

サンプルコマンド:

GIS.ADD hangzhou campus 'POLYGON ((30 10, 40 40, 20 40, 10 20, 30 10))'

サンプル出力：

(integer) 1

パラメーター

説明

構文

GIS.GETエリアpolygonName

時間の複雑さ

O(1)

コマンド説明

領域内のポリゴンのWKT表現を取得します。

パラメーター

• area: 幾何学的な概念。

• PolygonName: 管理するポリゴンの名前。

Output

• 操作が成功した場合、ポリゴンのWKT表現が返されます。

• 領域またはポリゴンが存在しない場合は、nilが返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

GIS.ADD hangzhou campus 'POLYGON ((30 10、40、20 40、20 40、10 20、30 10))' コマンドは事前に実行されます。

サンプルコマンド:

GIS.GET hangzhou campus

サンプル出力：

'POLYGON ((30 10、40 40、20 40、10 20、30 10))'

パラメーター

説明

構文

GIS.GETALLエリア [WITHOUTWKT]

時間の複雑さ

O(n)

コマンド説明

領域内のすべてのポリゴンの名前とWKT表現を取得します。 WITHOUTWKTパラメーターを指定した場合、ポリゴンの名前のみが返されます。

パラメーター

• area: 幾何学的な概念。

• WITHOUTWKT: ポリゴンのWKT表現を返すかどうかを指定します。 このパラメーターを指定すると、ポリゴンのWKT表現は返されません。

Output

• 操作が成功すると、ポリゴンの名前とWKT表現が返されます。 WITHOUTWKTパラメーターを指定した場合、ポリゴンの名前のみが返されます。

• エリアが存在しない場合は、nilが返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

GIS.ADD hangzhou campus 'POLYGON ((30 10、40、20 40、20 40、10 20、30 10))' コマンドは事前に実行されます。

サンプルコマンド:

GIS.GETALL hangzhou

サンプル出力：

1) "campus"
2) "POLYGON((30 10,40 40,20 40,10 20,30 10))"

パラメーター

説明

構文

GIS. containins area polygonWkt [WITHOUTWKT]

時間の複雑さ

• 最適な時間の複雑さ:

• 最も望ましい時間の複雑さ: O(log n)

コマンド説明

ポイント、ラインストリング、またはポリゴンが特定の領域内のポリゴンにあるかどうかを確認します。 はいの場合、このコマンドは、領域内の点、線列、またはポリゴンを含むポリゴンの数とWKT表現を返します。

パラメーター

• area: 幾何学的な概念。

• polygonWkt: WKTで記述されたポリゴンの説明。 WKTでは、次のポリゴンタイプを記述できます。

  • POINT: ポイントを記述するWKT。

  • LINESTRING: ラインストリングを記述するWKT。

  • POLYGON: ポリゴンを記述するWKT。

• WITHOUTWKT: ポリゴンのWKT表現を返すかどうかを指定します。 このパラメーターを指定すると、ポリゴンのWKT表現は返されません。

Output

• 操作が成功した場合、ポリゴンの番号とWKT表現が返されます。

• 領域が存在しない場合、「空のリストまたはセット」メッセージが返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

GIS.ADD hangzhou campus 'POLYGON ((30 10、40、20 40、20 40、10 20、30 10))' コマンドは事前に実行されます。

サンプルコマンド:

GIS.CONTAINS hangzhou 'POINT (30 11)'

サンプル出力：

G1) "1"
2) 1) "campus"
   2) "POLYGON((30 10,40 40,20 40,10 20,30 10))"IS.CONTAINS hangzhou 'POINT (30 11)'

パラメーター

説明

構文

GIS.WITHINエリアpolygonWkt [WITHOUTWKT]

時間の複雑さ

• 最適な時間の複雑さ:

• 最も望ましい時間の複雑さ: O(log n)

コマンド説明

領域が点、線列、またはポリゴン内にあるかどうかをチェックします。 はいの場合、このコマンドは、ポイント、ラインストリング、またはポリゴン内にある領域内のポリゴンの番号とWKT表現を返します。

パラメーター

• area: 幾何学的な概念。

• polygonWkt: WKTで記述されたポリゴンの説明。 WKTでは、次のポリゴンタイプを記述できます。

  • POINT: ポイントを記述するWKT。

  • LINESTRING: ラインストリングを記述するWKT。

  • POLYGON: ポリゴンを記述するWKT。

  説明

  MULTIPOINT、MULTILINESTRING、MULTIPOLYGON、GEOMETRY、またはCOLLECTIONはサポートされていません。

• WITHOUTWKT: ポリゴンのWKT表現を返すかどうかを指定します。 このパラメーターを指定すると、ポリゴンのWKT表現は返されません。

Output

• 操作が成功した場合、ポリゴンの番号とWKT表現が返されます。

• 領域が存在しない場合、「空のリストまたはセット」メッセージが返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

GIS.ADD hangzhou campus 'POLYGON ((30 10、40、20 40、20 40、10 20、30 10))' コマンドは事前に実行されます。

サンプルコマンド:

GIS.WITHIN hangzhou 'POLYGON ((30 5、50 50、20 50、5 20、30 5))'

サンプル出力：

1) "1"
2) 1) "campus"
   2) "POLYGON((30 10,40 40,20 40,10 20,30 10))"

パラメーター

説明

構文

GIS.INTERSECTSエリアpolygonWkt

時間の複雑さ

• 最適な時間の複雑さ:

• 最も望ましい時間の複雑さ: O(log n)

コマンド説明

ポイント、ラインストリング、またはポリゴンが特定の領域内のポリゴンと交差するかどうかを確認します。 はいの場合、このコマンドは、点、線列、またはポリゴンと交差する領域内のポリゴンの数とWKT表現を返します。

パラメーター

• area: 幾何学的な概念。

• polygonWkt: WKTで記述されたポリゴンの説明。 WKTでは、次のポリゴンタイプを記述できます。

  • POINT: ポイントを記述するWKT。

  • LINESTRING: ラインストリングを記述するWKT。

  • POLYGON: ポリゴンを記述するWKT。

• WITHOUTWKT: ポリゴンのWKT表現を返すかどうかを指定します。 このパラメーターを指定すると、ポリゴンのWKT表現は返されません。

Output

• 操作が成功した場合、ポリゴンの番号とWKT表現が返されます。

• 領域が存在しない場合、「空のリストまたはセット」メッセージが返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

GIS.ADD hangzhou campus 'POLYGON ((30 10、40、20 40、20 40、10 20、30 10))' コマンドは事前に実行されます。

サンプルコマンド:

 GIS.INTERSECTS hangzhou 'LINESTRING (30 10, 40 40)'

サンプル出力：

1) "1"
2) 1) "campus"
   2) "POLYGON((30 10,40 40,20 40,10 20,30 10))"

パラメーター

説明

構文

GIS.SEARCH area [RADIUS longitude latitude distance M|KM|FT|MI]
[MEMBER field distance M|KM|FT|MI]
[GEOM geom]
[COUNT count]
[ASC|DESC]
[WITHDIST]
[WITHOUTWKT]

時間の複雑さ

• 最適な時間の複雑さ:

• 最も望ましい時間の複雑さ: O(log n)

コマンド説明

特定の経度と緯度の位置の半径内にあるエリア内のポイントを照会します。

パラメーター

• area: 幾何学的な概念。

• RADIUS: 経度、緯度、半径、半径の単位。 単位の有効な値: M (メートル) 、KM (キロメートル) 、FT (フィート) 、およびMI (マイル) 。 例: RADIUS 15 37 200 KM。

• MEMBER: 基点として使用される領域内の点とその点の半径。 値は、ポリゴン (フィールド) の名前、検索半径 (距離) 、および半径単位の順序で指定する必要があります。 半径単位の有効な値: M (メートル) 、KM (キロメートル) 、FT (フィート) 、およびMI (マイル) 。 例: MEMBERアグリジェント100 KM

• GEOM: 検索範囲を指定するWKTで記述されたポリゴン。 例: GEOM「POLYGON((10 30,20 30,20 40,10 40)) 」

• COUNT: 返すことができるエントリの最大数。 例: COUNT 3

• ASC | DESC: 返されたエントリがランク付けされる順序。 ASCは、返されたエントリが、中心までの距離に基づいてショートからロングにランク付けされることを示します。 DESCは、返されたエントリが、中心までの距離に基づいてロングからショートにランク付けされることを示します。

• WITHDIST: 特定のポイントとMEMBERパラメーターで指定されたポイント間の距離を返すかどうかを指定します。

• WITHOUTWKT: 点のWKT表現を返すかどうかを指定します。 このパラメーターを指定すると、ポイントのWKT表現は返されません。

Output

• 操作が成功した場合、ポイントの数とWKT表現が返されます。

• 領域が存在しない場合、「空のリストまたはセット」メッセージが返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

GIS.ADD Sicily "Palermo" "POINT (13.361389 38.115556)" "Catania" "POINT(15.087269 37.502669)" コマンドは事前に実行されます。

サンプルコマンド:

GIS.SEARCH Sicily RADIUS 15 37 200 km WITHDIST ASC

サンプル出力：

1) (integer) 2
2) 1) "Catania"
   2) "POINT(15.087269 37.502669)"
   3) "56.4413"
   4) "Palermo"
   5) "POINT(13.361389 38.115556)"
   6) "190.4424"

パラメーター

説明

構文

GIS.DELエリアpolygonName

時間の複雑さ

O (ログn)

コマンド説明

特定のポリゴンを領域から削除します。

パラメーター

• area: 幾何学的な概念。

• PolygonName: 管理するポリゴンの名前。

Output

• 操作が成功した場合、OKが返されます。

• 領域またはポリゴンが存在しない場合は、nilが返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

GIS.ADD hangzhou campus 'POLYGON ((30 10、40、20 40、20 40、10 20、30 10))' コマンドは事前に実行されます。

サンプルコマンド:

GIS.DEL hangzhou campus

サンプル出力：

OK