このトピックでは、ST_Area関数について説明します。 この関数は、ポリゴンオブジェクトの面積を計算します。
構文
float ST_Area(geometry g1);
float ST_Area(geography geog , boolean useSpheroid);パラメーター
パラメーター | 説明 |
g1 | 指定するジオメトリオブジェクト。 |
geog | 指定するgeographyオブジェクト。 |
usesSpheroid | 楕円体を使用するかどうかを指定します。 デフォルト値は True です。 |
説明
ジオメトリオブジェクトを指定した場合、この関数はジオメトリオブジェクトの空間参照系で指定された単位でジオメトリオブジェクトの2Dデカルト領域を返します。
geographyオブジェクトを指定した場合、この関数は、定義した楕円体上のジオメトリオブジェクトの面積を返します。 面積は平方メートルで測定されます。
楕円体を使用しないことを選択できます。 このように、この関数は、より高速であるがより低い精度で面積を計算することができる。
この関数は多面体表面をサポートします。
この関数は2D多面体サーフェスをサポートします。 この関数は、2.5D多面体表面をサポートしません。 x座標とy座標のみを持つ平面上に完全に存在する2.5D多面体サーフェスを指定した場合、この関数はゼロ以外の結果を返すことがあります。
例
SELECT ST_Area(ST_Buffer(ST_GeomFromText('POINT(0 0)',3857),1000));
st_area
------------------
3121445.15225805
(1 row)