Compartilhar via

geo_line_centroid()

  • Artigo

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Calcula o centroide de uma linha ou de uma multilinha na Terra.

Sintaxe

geo_line_centroid(linhaString)

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Digitar Obrigatória Descrição
linhaString dynamic ✔️ Um LineString ou MultiLineString no formato GeoJSON.

Devoluções

Os valores de coordenadas do centroide no formato GeoJSON e de um tipo de dados dinâmico . Se a linha ou a multilinha 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 dado geodésico 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 retas cartesianas, considere usar geo_line_densify() para converter arestas planas em geodésicas.
  • Se a entrada for uma multilinha e contiver mais de uma linha, o resultado será a união do centróide das 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 onde 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 aresta mais curta entre os dois vértices é escolhida.

Exemplos

O exemplo a seguir calcula o centróide de linha.

let line = dynamic({"type":"LineString","coordinates":[[-73.95796, 40.80042], [-73.97317, 40.764486]]});
print centroid = geo_line_centroid(line);

Saída

Centróide
{"tipo": "Ponto", "coordenadas": [-73.965567057230942, 40.782453249627416]}

O exemplo a seguir calcula a longitude do centróide da linha.

let line = dynamic({"type":"LineString","coordinates":[[-73.95807266235352,40.800426144169315],[-73.94966125488281,40.79691751000055],[-73.97317886352539,40.764486356930334],[-73.98210525512695,40.76786669510221],[-73.96004676818848,40.7980870753293]]});
print centroid = geo_line_centroid(line)
| project lng = centroid.coordinates[0]

Saída

Gnl
-73.9660675626837

O exemplo a seguir visualiza o centróide de linha em um mapa.

let line = dynamic({"type":"MultiLineString","coordinates":[[[-73.95798683166502,40.800556090021466],[-73.98193359375,40.76819171855746]],[[-73.94940376281738,40.79691751000055],[-73.97317886352539,40.76435634049001]]]});
print centroid = geo_line_centroid(line)
| render scatterchart with (kind = map)

Captura de tela do centróide da linha do Central Park de Nova York.

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

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

Saída

is_bad_line
true