ST_Area

Con respecto a una geometría de entrada, ST_Area devuelve el área cartesiana de una proyección 2D. Las unidades de área son las mismas que las unidades en las que se expresan las coordenadas de la geometría de entrada. Para puntos, cadenas de línea, multipuntos y linestring múltiples, la función devuelve 0. Para las colecciones de geometría, devuelve la suma de las áreas de las geometrías de la colección.

Con respecto a una geografía de entrada, ST_Area devuelve el área geodésica de la proyección 2D de una geografía de área de entrada calculada sobre el esferoide que determina el SRID. La unidad de longitud se expresa en metros cuadrados. La función devuelve un valor cero (0) para las geografías de puntos, multipuntos y lineales. Cuando la entrada es una colección de geometría, la función devuelve la suma de las áreas de las geografías de la colección.

Sintaxis

ST_Area(geo)

Argumentos

Tipo de retorno

DOUBLE PRECISION

Si geom es nulo, entonces se devuelve el valor nulo.

Ejemplos

El siguiente SQL devuelve el área cartesiana de un multipolygon.

SELECT ST_Area(ST_GeomFromText('MULTIPOLYGON(((0 0,10 0,0 10,0 0)),((10 0,20 0,20 10,10 0)))'));

 st_area
---------
     100

El siguiente SQL devuelve el área de un polígono en una geografía.

SELECT ST_Area(ST_GeogFromText('polygon((34 35, 28 30, 25 34, 34 35))'));

     st_area
------------------
 201824655743.383

El siguiente SQL devuelve un valor cero para una geografía lineal.

SELECT ST_Area(ST_GeogFromText('multipoint(0 0, 1 1, -21.32 121.2)'));

 st_area
---------
       0