geo_line_length()

  • Artigo

Calcula o comprimento total de uma linha ou de várias linhas na Terra.

Syntax

geo_line_length(Linestring)

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
Linestring dynamic ✔️ Um LineString ou MultiLineString no formato GeoJSON.

Retornos

O comprimento total de uma linha ou uma várias linhas, em metros, na Terra. Se a linha ou várias linhas for inválida, a consulta produzirá um resultado nulo.

Observação

  • As coordenadas geoespaciais são interpretadas como representadas pelo sistema de referência de coordenadas WGS-84 .
  • O datum geodético usado para medir a distância na Terra é uma esfera. As bordas de linha são geodésicas na esfera.
  • Se as bordas da linha de entrada forem linhas cartesianas retas, considere usar geo_line_densify() para converter bordas planares em geodesíacas.
  • Se a entrada for uma várias linhas e contiver mais de uma linha, o resultado será o comprimento total da união de linhas.

Definição e restrições de LineString

dynamic({"type": "LineString","coordinates": [[lng_1,lat_1], [lng_2,lat_2], ..., [lng_N,lat_N]]})

dynamic({"type": "MultiLineString","coordinates": [[line_1, line_2, ..., line_N]]})

  • A matriz de coordenadas LineString deve conter pelo menos duas entradas.
  • As coordenadas [longitude, latitude] devem ser válidas quando longitude é um número real no intervalo [-180, +180] e latitude é um número real no intervalo [-90, +90].
  • O comprimento da borda deve ser inferior a 180 graus. A borda mais curta entre os dois vértices será escolhida.

Exemplos

O exemplo a seguir calcula o comprimento total da linha, em metros.

Executar a consulta

let line = dynamic({"type":"LineString","coordinates":[[-73.95807266235352,40.800426144169315],[-73.94966125488281,40.79691751000055],[-73.97317886352539,40.764486356930334]]});
print length = geo_line_length(line)

Saída

comprimento
4922.48016992081

O exemplo a seguir calcula o comprimento total de várias linhas, em metros.

Executar a consulta

let line = dynamic({"type":"MultiLineString","coordinates":[[[-73.95798683166502,40.800556090021466],[-73.98193359375,40.76819171855746]],[[-73.94940376281738,40.79691751000055],[-73.97317886352539,40.76435634049001]]]});
print length = geo_line_length(line)

Saída

comprimento
8262.24339753741

O exemplo a seguir retorna True devido à linha inválida.

Executar a consulta

print is_bad_line = isnull(geo_line_length(dynamic({"type":"LineString","coordinates":[[1, 1]]})))

Saída

is_bad_line
True