geo_line_length()
Calcula o comprimento total de uma linha ou de uma linha multiline na Terra.
Syntax
geo_line_length(
lineString)
Saiba mais sobre as convenções de sintaxe.
Parâmetros
Nome | Tipo | Necessário | Descrição |
---|---|---|---|
lineString | dynamic |
✔️ | Um LineString ou MultiLineString no formato GeoJSON. |
Devoluções
O comprimento total de uma linha ou de uma linha múltipla, em metros, na Terra. Se a linha ou a linha multiline for inválida, a consulta produzirá um resultado nulo.
Nota
- 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 arestas de linha são geodésicas na esfera.
- Se as arestas da linha de entrada forem linhas cartesianas retas, considere utilizar geo_line_densify() para converter arestas planar em geodésicos.
- Se a entrada for multiline e contiver mais do que 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","coordenadas": [[line_1, line_2, ..., line_N]]})
- A matriz de coordenadas LineString tem de conter, pelo menos, duas entradas.
- As coordenadas [longitude, latitude] têm de ser válidas em que a longitude é um número real no intervalo [-180, +180] e a latitude é um número real no intervalo [-90, +90].
- O comprimento da extremidade tem de ser inferior a 180 graus. Será escolhida a margem mais curta entre os dois vértices.
Exemplos
O exemplo seguinte calcula o comprimento total da linha, em metros.
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
length |
---|
4922.48016992081 |
O exemplo seguinte calcula o comprimento total de várias linhas, em medidores.
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
length |
---|
8262.24339753741 |
O exemplo seguinte devolve Verdadeiro devido à linha inválida.
print is_bad_line = isnull(geo_line_length(dynamic({"type":"LineString","coordinates":[[1, 1]]})))
Saída
is_bad_line |
---|
Verdadeiro |
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários