ST_Relate は、内部、境界、外部の「交差テスト」を実行することによって、ジオメトリ間の関係を評価します。ジオメトリ間の関係は、DE-9IM (Dimensionally Extended 9 Intersection Model) フォーマットの 9 文字の文字列で記述されます。この文字列の各文字は、交差テストの結果の次元を表します。

ST_Relate を述部として使用する場合、テストする交差の結果を示した DE-9IM 文字列を渡します。指定した DE-9IM 文字列の条件をジオメトリが満たしている場合、ST_Relate は 「1」 を返します。条件が満たされない場合は、「0」 を返します。片方のジオメトリ、または両方が NULL の場合、「NULL」 を返します。

9 文字の DE-9IM 文字列は、内部、境界、外部間の交差テストのペアごとのマトリックスをフラットにした表現です。次の表に、実行される順序 (左から右、上から下) で 9 つの交差テストを示します。

DE-9IM 文字列を指定する場合、9 文字の各文字に *、0、1、2、T、または F を指定できます。これらの値は、交差によって作成されるジオメトリの次元数を表しています。

ST_Relate と Within 述部用のカスタム DE-9IM 文字列を使用して、ジオメトリが別のジオメトリ内にあるかどうかをテストするとします。

SELECT new ST_Polygon('Polygon(( 2 3, 8 3, 4 8, 2 3 ))').ST_Relate( new ST_Polygon('Polygon((-3 3, 3 3, 3 6, -3 6, -3 3))'), 'T*F**F***' );

これは、交差テストを実行するときに、ST_Relate に次の条件で検索するように問い合わせるのと同じです。

クエリを実行すると、ST_Relate は最初のジオメトリが 2 番目のジオメトリ内にないことを示す 0 を返します。

2 つのジオメトリを表示して、その形状をテストしている内容と比較するには、次の文を Interactive SQL の空間ビューアー ([ツール] » [空間ビューアー]) で実行します。

SELECT NEW ST_Polygon('Polygon(( 2 3, 8 3, 4 8, 2 3 ))') 
UNION ALL
SELECT NEW ST_Polygon('Polygon((-3 3, 3 3, 3 6, -3 6, -3 3))');

• ST_Geometry タイプの ST_Relate(ST_Geometry,CHAR(9)) メソッド

述部以外で ST_Relate を使用すると、2 つのジオメトリ間のすべての関係が返されます。

たとえば、前の例で使用したものと同じ 2 つのジオメトリがあり、それらの関係を知りたいとします。次の文を Interactive SQL で実行すると、ジオメトリ間の関係を定義した DE-9IM 文字列が返されます。

SELECT new ST_Polygon('Polygon(( 2 3, 8 3, 4 8, 2 3 ))').ST_Relate(new ST_Polygon('Polygon((-3 3, 3 3, 3 6, -3 6, -3 3))'));

ST_Relate は DE-9IM 文字列 212111212 を返します。

この値をマトリックス表示すると、多くの交差ポイントがあることがわかります。

• ST_Geometry タイプの ST_Intersects メソッド
• ST_Geometry タイプの ST_Overlaps メソッド
• ST_Geometry タイプの ST_Within メソッド
• ST_Geometry タイプの ST_Disjoint メソッド
• ST_Geometry タイプの ST_Touches メソッド
• ST_Geometry タイプの ST_Crosses メソッド
• ST_Geometry タイプの ST_Contains メソッド
• ST_Geometry タイプの ST_Relate メソッド
• ST_Geometry タイプの ST_Relate(ST_Geometry) メソッド