st_area Função

Aplica-se a:check marked yes Databricks SQL check marked yes Databricks Runtime 17.1 e superior

Important

O suporte para valores de GEOGRAFIA está disponível em Pré-visualização Pública. O suporte para valores GEOMETRY está geralmente disponível.

Observação

Esse recurso não está disponível nos armazéns Databricks SQL Classic. Para saber mais sobre os armazéns SQL do Databricks, consulte Tipos de armazém SQL.

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 da entrada GEOGRAPHY ou GEOMETRY valor.

Se a entrada for um valor GEOGRAPHY, a função retorna a área geodésica 2D do valor GEOGRAPHY. Especificamente, a função retorna a área geodésica para polígonos, e a soma das áreas dos polígonos em um multipolígono. Para geografias não areais (pontos, cadeias de caracteres, multipontos e cadeias de caracteres de várias linhas) 0 é retornado, enquanto para coleções de geometria a função retorna a soma das áreas dos elementos na coleção. O resultado é calculado através da realização do cálculo geodésico inverso assumindo 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, cadeias de caracteres, multipontos e cadeias de caracteres de várias linhas) 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 retorna 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
  • Last updated on