Partilhar via

geo_polygon_buffer()

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

Calcula polígono ou multipolígono que contém todos os pontos dentro do raio dado do polígono de entrada ou multipolígono na Terra.

Sintaxe

geo_polygon_buffer( polígono,,tolerância)

Saiba mais sobre convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
polígono dynamic ✔️ Polígono ou multipolígono no formato GeoJSON.
raio real ✔️ Raio de buffer em metros. O valor válido deve ser positivo.
tolerância real Define a tolerância em metros que determina o quanto um polígono pode se desviar do raio ideal. Se não for especificado, o valor 10 padrão será usado. A tolerância não deve ser inferior a 0,0001% do raio. Especificar tolerância maior que raio reduzirá a tolerância para o maior valor possível abaixo do raio.

Devoluções

Polígono ou MultiPolígono em torno do Polígono de entrada ou multipolígono. Se as coordenadas, raio ou tolerância forem inválidos, 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 medições na Terra é uma esfera. As bordas do polígono são geodésicas na esfera.
  • Se as arestas do polígono de entrada forem linhas cartesianas retas, considere usar geo_polygon_densify() para converter arestas planas em geodésicas.

Definição e restrições de polígonos

dynamic({"type": "Polygon","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 uma concha.
  • 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 interiores e buracos.
  • Os vértices lineares do anel 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. Será escolhida a mais pequena das duas regiões.
  • O comprimento da borda LinearRing deve ser inferior a 180 graus. Será escolhida a aresta mais curta entre os dois vértices.
  • LinearRings não deve cruzar e não deve compartilhar bordas. LinearRings pode compartilhar vértices.
  • Polígono contém seus vértices.

Exemplos

O exemplo a seguir calcula o polígono em torno do polígono de entrada, com raio de 10 km.

let polygon = dynamic({"type":"Polygon","coordinates":[[[139.813757,35.719666],[139.72558,35.71813],[139.727471,35.653231],[139.818721,35.657264],[139.813757,35.719666]]]});
print buffer = geo_polygon_buffer(polygon, 10000)
memória temporária
{"type": "Polígono","coordenadas": [ ... ]}

A consulta a seguir calcula o buffer em torno de cada polígono e unifica o resultado

datatable(polygon:dynamic, radius:real )
[
    dynamic({"type":"Polygon","coordinates":[[[12.451218693639277,41.906457003556625],[12.445753852969375,41.90160968881543],[12.453514425793855,41.90361551885886],[12.451218693639277,41.906457003556625]]]}), 100,
    dynamic({"type":"Polygon","coordinates":[[[12.4566086734784,41.905119850039995],[12.453913683559591,41.903652663265234],[12.455485761012113,41.90146110630562],[12.4566086734784,41.905119850039995]]]}), 20
]
| project buffer = geo_polygon_buffer(polygon, radius)
| summarize polygons = make_list(buffer)
| project result = geo_union_polygons_array(polygons)
Resultado
{"type": "Polígono","coordenadas": [ ... ]}

O exemplo a seguir retornará true, devido ao polígono inválido.

print buffer = isnull(geo_polygon_buffer(dynamic({"type":"p"}), 1))
memória temporária
Verdade

O exemplo a seguir retornará true, devido ao raio inválido.

print buffer = isnull(geo_polygon_buffer(dynamic({"type":"Polygon","coordinates":[[[10,10],[0,10],[0,0],[10,10]]]}), 0))
memória temporária
Verdade
  • Last updated on