st_length Função

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

Devolve o comprimento do valor de entrada GEOGRAPHY ou GEOMETRY.

Syntax

st_length ( geoExpr )

Arguments

• geoExpr: um valor GEOGRAPHY ou GEOMETRY.

Returns

Um valor do tipo DOUBLE, que representa o comprimento da entrada GEOGRAPHY ou GEOMETRY valor.

Se a entrada for um GEOGRAPHY valor, a função devolve o comprimento geodésico 2D da parte linear do GEOGRAPHY valor. Especificamente, a função retorna o comprimento geodésico para linhas e, além disso, retorna a soma dos comprimentos geodésicos das linhas em uma multilinha. 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 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 devolve o comprimento cartesiano 2D da parte linear do GEOMETRY valor. Especificamente, a função retorna o comprimento cartesiano 2D para linhas e a soma dos comprimentos das linhas em uma multilinha. Para geometrias não lineares (pontos, polígonos, multipontos 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 retorna 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