Comparteix via


st_area Función

Se aplica a:check marcado yes Databricks SQL check marcado yes Databricks Runtime 17.1 y versiones posteriores

Important

Esta característica está en versión preliminar pública.

Nota:

Esta característica no está disponible en almacenes clásicos de Databricks SQL. Para más información sobre los almacenes de SQL de Databricks, consulte Tipos de almacenamiento de SQL.

Devuelve el área del valor GEOGRAPHY o GEOMETRY de entrada.

Syntax

st_area ( geoExpr )

Arguments

  • geoExpr: un valor de GEOGRAPHY o GEOMETRY.

Returns

Valor de tipo DOUBLE, que representa el área del valor de entrada GEOGRAPHY o GEOMETRY.

Si la entrada es un GEOGRAPHY valor, la función devuelve el área geodesica 2D del valor GEOGRAPHY . En concreto, la función devuelve el área geodesica de los polígonos y la suma de las áreas de los polígonos en varios polígonos. En el caso de las geografías no areales (puntos, líneas, multipuntos y multilíneas) se devuelve 0, mientras que para las colecciones de geometría, la función devuelve la suma de las áreas de los elementos de la colección. El resultado se calcula realizando el cálculo geodesico inverso suponiendo el elipsoide WGS84. Las unidades del resultado son metros cuadrados.

Si la entrada es un GEOMETRY valor, la función devuelve el área cartesiana 2D del GEOMETRY valor. En concreto, la función devuelve el área cartesiana 2D para polígonos y la suma de las áreas de los polígonos en un multipolygon. Para las geometrías no areales (puntos, líneas poligonales, multipuntos y multilíneas) se devuelve 0, y para las colecciones de geometría, devuelve la suma de las áreas de los elementos de la colección. Las unidades del resultado son las del sistema de referencia espacial del valor de entrada GEOMETRY , cuadrático.

La función devuelve NULL si alguna de las entradas es NULL.

Examples

-- Returns the area of a 2D Cartesian polygon with a hole.
> SELECT st_area(st_geomfromtext('POLYGON((0 0,50 0,50 50,0 50,0 0),(20 20,25 30,30 20,20 20))'));
  2450.0