ST_Dimension

ST_Dimension は、入力ジオメトリの固有のディメンションを返します。inherent dimension は、ジオメトリで定義されているサブタイプのディメンション値です。

ST_Dimension は、3DM、3DZ、4D ジオメトリが入力された場合、2D ジオメトリが入力された場合と同じ結果を返します。

構文

ST_Dimension(geom)

引数

geom

データ型 GEOMETRY の値または GEOMETRY 型と評価される式の値。

戻り型

INTEGER は geom 固有のディメンションを表します。

geom が null の場合、null が返されます。

返される値は次のとおりです。

戻り値	ジオメトリのサブタイプ
0	geom が POINT または MULTIPOINT サブタイプの場合に返されます
1	geom が LINESTRING または MULTILINESTRING サブタイプの場合に返されます
2	geom が POLYGON または MULTIPOLYGON サブタイプの場合に返されます
0	geom が空の GEOMETRYCOLLECTION サブタイプの場合に返されます
コレクションのコンポーネントの最大ディメンション	geom が GEOMETRYCOLLECTION サブタイプの場合に返されます

例

次の SQL は、4 ポイントの LINESTRING の WKT (Well-Known Text) 表現を GEOMETRY オブジェクトに変換し、LINESTRING のディメンションを返します。

SELECT ST_Dimension(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 29.26,77.27 29.31,77.29 29.07)'));

st_dimension
-------------
1