Partilhar via

geo_polygon_densify()

  • Artigo

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

Converte arestas planas de polígonos ou multipolígonos em geodésicas, adicionando pontos intermediários.

Sintaxe

geo_polygon_densify(, tolerância, de polígono [ preserve_crossing ])

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Digitar Obrigatória Descrição
polígono dynamic ✔️ Polígono ou multipolígono no formato GeoJSON.
tolerance int, long ou real Define a distância máxima em metros entre a aresta plana original e a cadeia de arestas geodésicas convertida. Os valores suportados estão no intervalo [0,1, 10000]. Se não for especificado, o valor padrão será 10.
preserve_crossing bool Se true, preserva o cruzamento de arestas sobre o antimeridiano. Se não for especificado, o valor padrão false será usado.

Definição de polígono

dynamic({"type": "Polígono","coordinates": [ LinearRingShell, LinearRingHole_1, ..., LinearRingHole_N ]})

dynamic({"type": "MultiPolygon","coordinates": [[ LinearRingShell, LinearRingHole_1, ..., LinearRingHole_N ], ..., [LinearRingShell, LinearRingHole_1, ..., LinearRingHole_M]]})

  • LinearRingShell é necessário e definido como uma counterclockwise matriz ordenada de coordenadas [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]]. Só pode haver um shell.
  • LinearRingHole é opcional e definido como uma clockwise matriz ordenada de coordenadas [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]]. Pode haver qualquer número de anéis e furos internos.
  • LinearRing Os vértices devem ser distintos com pelo menos três coordenadas. A primeira coordenada deve ser igual à última. São necessárias pelo menos quatro 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].
  • LinearRingShell encerra no máximo metade da esfera. LinearRing divide a esfera em duas regiões. A menor das duas regiões será escolhida.
  • LinearRing O comprimento da borda deve ser inferior a 180 graus. A aresta mais curta entre os dois vértices será escolhida.

Restrições

  • O número máximo de pontos no polígono densificado é limitado a 10485760.
  • O armazenamento de polígonos em formato dinâmico tem limites de tamanho.
  • Densificar um polígono válido pode invalidar o polígono. O algoritmo adiciona pontos de maneira não uniforme e, como tal, pode fazer com que as arestas se entrelacem.

Motivação

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

Devoluções

Polígono densificado no formato GeoJSON e de um tipo de dados dinâmico . Se o polígono ou a tolerância for inválido, 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 .

Exemplos

O exemplo a seguir densifica o polígono do Manhattan Central Park. As arestas são curtas e a distância entre as arestas planas e suas contrapartes geodésicas é menor que a distância especificada pela tolerância. Como tal, o resultado permanece inalterado.

print densified_polygon = tostring(geo_polygon_densify(dynamic({"type":"Polygon","coordinates":[[[-73.958244,40.800719],[-73.949146,40.79695],[-73.973093,40.764226],[-73.982062,40.768159],[-73.958244,40.800719]]]})))

Saída

densified_polygon
{"type":"Polígono","coordinates":[[[-73.958244,40.800719],[-73.949146,40.79695],[-73.973093,40.764226],[-73.982062,40.768159],[-73.958244,40.800719]]]}

O exemplo a seguir densifica duas arestas do polígono. O comprimento das bordas densificadas é de ~ 110 km

print densified_polygon = tostring(geo_polygon_densify(dynamic({"type":"Polygon","coordinates":[[[10,10],[11,10],[11,11],[10,11],[10,10]]]})))

Saída

densified_polygon
{"type":"Polígono","coordenadas":[[[10,10],[10.25,10],[10.5,10],[10.75,10],[11,10],[11,11],[10.75,11],[10.5,11],[10.25,11],[10,11],[10,10]]]}

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

print densified_polygon = geo_polygon_densify(dynamic({"type":"Polygon","coordinates":[[[10,900],[11,10],[11,11],[10,11],[10,10]]]}))

Saída

densified_polygon

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

print densified_polygon = geo_polygon_densify(dynamic({"type":"Polygon","coordinates":[[[10,10],[11,10],[11,11],[10,11],[10,10]]]}), 0)

Saída

densified_polygon