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

あるジオメトリ値と別のジオメトリ値との空間的な関係が、交点マトリックスで指定されているとおりかどうかをテストします。ST_Relate メソッドは、Dimensionally Extended 9 Intersection Model (DE-9IM) からの 9 文字の文字列を使用して、2 つの空間データ項目間のペアワイズの関係を示します。たとえば、ST_Relate メソッドは、ジオメトリ間に共通部分が存在するかどうかを確認し、存在する場合は結果の共通部分のジオメトリを調べます。

構文

geometry-expression.ST_Relate(geo2,relate-matrix)

パラメータ

名前	型	説明
geo2	ST_Geometry	geometry-expression と比較する 2 番目のジオメトリ値。
relate-matrix	CHAR(9)	Dimensionally Extended 9 Intersection Model でマトリックスを表す 9 文字の文字列。9 文字の文字列に定義された各文字は、2 つのジオメトリの内部、境界、外部の間の考えられる 9 つの共通部分のいずれかで許可される共通部分タイプを表します。

戻り値

備考

2 つのジオメトリの内部、境界、外部の間の共通部分をテストすることによって、ジオメトリ値が、交点マトリックスで指定されているとおりに別のジオメトリ値と空間的に関係しているかどうかをテストします。参照：空間の関係操作

注意

geometry-expression に円ストリングが含まれている場合、それらは線ストリングに補間されます。

注意

このメソッドは、曲面の空間参照系のジオメトリでは使用できません。

標準と互換性

例

次の例では、指定した線と '0F***T***' の関係を持つ各シェイプについて、1 ローずつの結果を返します。'0' は、両方のジオメトリの内部が交差し、ポイントまたは複数ポイントを形成する必要があることを意味します。'F' は、線の内部と Shape の境界が交差してはならないことを意味します。'T' は、線の外部と Shape の内部が交差する必要があることを意味します。

SELECT ShapeID, "Description" From SpatialShapes
WHERE NEW ST_LineString( 'LineString( 0 0, 10 0 )' )
    .ST_Relate( Shape, '0F****T**' ) = 1
ORDER BY ShapeID

この例では、次の結果セットを返します。

ShapeID	Description
`18`	`CircularString`
`30`	`Multicurve`

DocCommentXchange で意見交換できます