st_length Função

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

Retorna o comprimento do valor de entrada GEOGRAPHY ou GEOMETRY.

Syntax

st_length ( geoExpr )

Arguments

• geoExpr: Um valor GEOGRAPHY ou GEOMETRY.

Returns

Um valor de tipo DOUBLE, representando o comprimento do valor de entrada GEOGRAPHY ou GEOMETRY.

Se a entrada for um GEOGRAPHY valor, a função retornará o comprimento geodésico 2D da parte linear do GEOGRAPHY valor. Especificamente, a função retorna o comprimento geodésico para linestrings e a soma dos comprimentos das linestrings em uma multilinestring. Para geografias não lineares (pontos, polígonos, multipontos e multipolígonos) 0 é retornado, enquanto para coleções de geometria a função retorna a soma dos comprimentos dos elementos na coleção. 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 comprimento cartesiano 2D da parte linear do GEOMETRY valor. Especificamente, a função retorna o comprimento cartesiano 2D para cadeias de linhas e a soma dos comprimentos das cadeias de linhas em uma cadeia múltipla. Para geometrias não lineares (pontos, polígonos, vários pontos e multipolígonos) 0 é retornado, enquanto para coleções de geometria retorna a soma dos comprimentos 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 retornará NULL se qualquer uma das entradas for NULL.

Examples

-- Returns the length of a 2D Cartesian linestring.
> SELECT round(st_length(st_geomfromtext('LINESTRING(10 34,44 57,30 24)')), 8);
  76.89564816

Funções relacionadas

• st_area função
• st_perimeter função