geo_line_densify()

Mude de serviço usando a lista suspensa de Versões . Saiba mais sobre navegação.
Aplica a: ✅ Microsoft Fabric ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel

Converte linhas planas ou arestas multilineares em geodésicas, adicionando pontos intermédios.

Sintaxe

geo_line_densify( lineString,Tolerância, [ preserve_crossing ])

Saiba mais sobre convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Description
lineString dynamic ✔️ Uma LineString ou MultiLineString no formato GeoJSON.
tolerance int, longo ou real Define a distância máxima em metros entre a aresta planar original e a cadeia de arestas geodésicas convertida. Os valores suportados estão no intervalo [0,1, 10000]. Se não especificado, é usado o valor 10 padrão.
preserve_crossing bool Se true, preserva o cruzamento de arestas sobre o antimeridiano. Se não especificado, é usado o valor false padrão.

Devoluções

Linha densificada no formato GeoJSON e de tipo de dados dinâmico . Se a linha ou a tolerância forem inválidas, 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 .

Definição 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. A longitude deve ser um número real no intervalo [-180, +180] e a latitude deve ser um número real no intervalo [-90, +90].
  • O comprimento da aresta deve ser inferior a 180 graus. Será escolhida a aresta mais curta entre os dois vértices.

Restrições

  • O número máximo de pontos na linha densificada está limitado a 10485760.
  • Armazenar linhas em formato dinâmico tem limites de tamanho.

Motivação

  • O formato GeoJSON define uma aresta entre dois pontos como uma linha cartesiana reta, enquanto geo_line_densify() utiliza geodésica.
  • A decisão de usar arestas geodésicas ou planas pode depender do conjunto de dados e é especialmente relevante em arestas longas.

Examples

O exemplo seguinte densifica uma estrada na ilha de Manhattan. A aresta é curta e a distância entre a aresta planar e a sua contraparte geodésica é inferior à distância especificada pela tolerância. Assim, o resultado mantém-se inalterado.

Executar a consulta

print densified_line = tostring(geo_line_densify(dynamic({"type":"LineString","coordinates":[[-73.949247, 40.796860],[-73.973017, 40.764323]]})))

Output

densified_line
{"type":"LineString","coordenadas":[[-73.949247, 40.796860], [-73.973017, 40.764323]]}

O exemplo seguinte densifica uma aresta de ~130 km de comprimento

Executar a consulta

print densified_line = tostring(geo_line_densify(dynamic({"type":"LineString","coordinates":[[50, 50], [51, 51]]})))

Output

densified_line
{"type":"LineString","coordenadas":[[50,50],[50.125,50.125],[50.25,50.25],[50.375,50.375],[50.5,50.5],[50.625,50.625],[50.75,50.75],[50.875,50.875],[51,51]]}

O exemplo a seguir retorna um resultado nulo devido à entrada de coordenadas inválida.

Executar a consulta

print densified_line = geo_line_densify(dynamic({"type":"LineString","coordinates":[[300,1],[1,1]]}))

Output

densified_line

O exemplo seguinte devolve um resultado nulo devido à entrada de tolerância inválida.

Executar a consulta

print densified_line = geo_line_densify(dynamic({"type":"LineString","coordinates":[[1,1],[2,2]]}), 0)

Output

densified_line
  • Last updated on