st_perimeter Função

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

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 de tipo DOUBLE, que representa o perímetro da entrada GEOGRAPHY ou GEOMETRY do valor.

Se a entrada for um valor GEOGRAPHY, a função será o perímetro geodésico do valor de entrada GEOGRAPHY . Especificamente, retorna a soma dos comprimentos geodésicos dos segmentos (projeções 2D de) de um polígono e a soma dos perímetros dos polígonos em um multipolígono. Para geografias não areais (pontos, linhas, vários pontos e multilinhas) 0 é retornado, enquanto para coleções de geometria a soma dos perímetros dos elementos da coleção é retornada. O resultado é calculado realizando o 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, retorna a soma dos comprimentos dos segmentos (projeções cartesianas 2D de) de um polígono e a soma dos perímetros dos polígonos em um multipolígono. Para geometrias não areais (pontos, sequências de linhas, multipontos e sequências de multilinhas), retorna-se 0; enquanto para coleções de geometria, retorna-se a soma dos perímetros dos elementos dentro da coleção. As unidades do resultado são as do sistema de referência espacial do valor de entrada GEOMETRY .

A função retornará 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