st_length 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.

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
  • Last updated on