st_area Função

Aplica-se a: Databricks SQL Databricks Runtime 17.1 and above

Retorna a área do valor de entrada GEOGRAPHY ou GEOMETRY.

Syntax

st_area ( geoExpr )

Arguments

• geoExpr: Um valor GEOGRAPHY ou GEOMETRY.

Returns

Um valor do tipo DOUBLE, que representa a área do valor de entrada GEOGRAPHY ou GEOMETRY.

Se a entrada for um GEOGRAPHY valor, a função retornará a área geodésica 2D do GEOGRAPHY valor. Especificamente, a função retorna a área geodésica para polígonos e a soma das áreas dos polígonos em vários polígonos. Para geografias não areais (pontos, linhas de linha, vários pontos e multilinestrings) 0 é retornado, enquanto para coleções de geometria a função retorna a soma das áreas dos elementos na coleção. O resultado é calculado executando o cálculo geodésico inverso utilizando o elipsoide WGS84. As unidades do resultado são metros quadrados.

Se a entrada for um GEOMETRY valor, a função retornará a área cartesiana 2D do GEOMETRY valor. Especificamente, a função retorna a área cartesiana 2D para polígonos e a soma das áreas dos polígonos em um multipolígono. Para geometrias não areais (pontos, linhas de linha, vários pontos e multilinestrings) 0 é retornado, enquanto para coleções de geometria retorna a soma das áreas dos elementos na coleção. As unidades do resultado são as do sistema de referência espacial do valor de entrada GEOMETRY , ao quadrado.

A função retornará NULL se qualquer uma das entradas for 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

Funções relacionadas

• st_length função
• st_perimeter função