st_perimeter Função

Aplica-se a: Databricks SQL Databricks Runtime 17.1 e superior

Retorna o perímetro do valor de entrada GEOGRAPHY ou GEOMETRY.

Syntax

st_perimeter ( geoExpr )

Arguments

• geoExpr: um valor GEOGRAPHY ou GEOMETRY.

Returns

Um valor do tipo DOUBLE, que representa o perímetro da entrada GEOGRAPHY ou GEOMETRY valor.

Se a entrada for um valor GEOGRAPHY, a função calcula o perímetro geodésico do valor de entrada GEOGRAPHY. Especificamente, ele retorna a soma dos comprimentos geodésicos dos segmentos (projeções 2D dos) de um polígono, e a soma dos perímetros dos polígonos em um multipolígono. Para geografias não areais (pontos, linhas, multipontos e multilinhas), 0 é retornado, enquanto para coleções de geometria, é retornada a soma dos perímetros 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.

Se a entrada for um GEOMETRY valor, a função retornará o perímetro cartesiano do valor de entrada GEOMETRY . Especificamente, ele retorna a soma dos comprimentos dos segmentos cartesianos (projeções cartesianas 2D do) de um polígono, e a soma dos perímetros dos polígonos em um multipolígono. Para geometrias não areais (pontos, linhas, multipontos e multilinhas), retorna-se 0, enquanto nas coleções de geometria retorna-se a soma dos perímetros dos elementos na coleção. As unidades do resultado são as do sistema de referência espacial do valor de entrada GEOMETRY .

A função retorna NULL se qualquer uma das entradas for NULL.

Examples

-- Returns the perimeter of a 2D Cartesian polygon with a hole.
> SELECT round(st_perimeter(st_geomfromtext('POLYGON((0 0,50 0,50 50,0 50,0 0),(20 20,25 30,30 20,20 20))')), 2);
  232.36

Funções relacionadas

• st_area Função
• st_length Função