名前

ST_Force3DZ — ST_Force_3DZ — ジオメトリをXYZモードに強制します。これはST_Force_3Dと同義です。

概要

geometry ST_Force3DZ(geometry geomA);

説明

ジオメトリをXYZモードに強制します。これはST_Force_3Dと同義です。ジオメトリがZ値を持っていない場合は0のZ値を追加します。

機能強化: 2.0.0では、多面体サーフェスが導入されました。

変更: 2.1.0 2.0.xより後ではST_Force_3DZと呼ばれます。

この関数は多面体サーフェスに対応しています。

この関数は3次元に対応し、Z値を削除しません。

このメソッドは曲線ストリングと曲線に対応しています。

-- 既に3次元ジオメトリになっている場合は何も起きません
SELECT ST_AsEWKT(ST_Force3DZ(ST_GeomFromEWKT('CIRCULARSTRING(1 1 2, 2 3 2, 4 5 2, 6 7 2, 5 6 2)')));
                                   st_asewkt
-----------------------------------------------
 CIRCULARSTRING(1 1 2,2 3 2,4 5 2,6 7 2,5 6 2)


SELECT  ST_AsEWKT(ST_Force3DZ('POLYGON((0 0,0 5,5 0,0 0),(1 1,3 1,1 3,1 1))'));

                                                 st_asewkt
--------------------------------------------------------------
 POLYGON((0 0 0,0 5 0,5 0 0,0 0 0),(1 1 0,3 1 0,1 3 0,1 1 0))
                

関連情報

ST_AsEWKT, ST_Force2D, ST_Force3DM, ST_Force3D