ST_ToMultiSurface メソッド

ジオメトリを複数面値に変換します。

構文

geometry-expression.ST_ToMultiSurface()

戻り値

ST_MultiSurface geometry-expression が ST_MultiSurface タイプの場合は、geometry-expression を返します。geometry-expression が面のみを含むジオメトリコレクションの場合は、geometry-expression の要素を含む複数面オブジェクトを返します。geometry-expression が ST_Surface タイプの場合は、1 つの要素 (geometry-expression) を含む複数面値を返します。geometry-expression が空のセットの場合は、ST_MultiSurface タイプの空のセットを返します。それ以外の場合は、例外条件が発生します。
結果の空間参照系識別子は、geometry-expression の空間参照系と同じです。

備考

geometry-expression が ST_MultiSurface 値であるとすでにわかっている場合は、ST_ToMultiSurface メソッドよりも TREAT( geometry-expression AS ST_MultiSurface ) を使用する方が効率的です。

注意

ST_ToMultiSurface では、デフォルトで、使用可能な場合はジオメトリの元のフォーマットが使用されます。それ以外の場合は、内部フォーマットが使用されます。内部フォーマットと元のフォーマットの詳細については、STORAGE FORMAT 句、CREATE SPATIAL REFERENCE SYSTEM 文を参照してください。

SELECT NEW ST_GeomCollection().ST_ToMultiSurface()

次の例では、結果として MultiSurface (((3 3, 8 3, 4 8, 3 3))) を返します。

SELECT Shape.ST_ToMultiSurface()
FROM SpatialShapes WHERE ShapeID = 22

DocCommentXchange で意見交換できます

ST_ToMultiSurface メソッド

構文

戻り値

備考

注意

参照

標準と互換性

例