Compartilhar via

geo_polygon_buffer()

  • Artigo

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

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

Sintaxe

geo_polygon_buffer(Tolerância do raio, do polígono, )

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.
raio real ✔️ Raio do buffer em metros. O valor válido deve ser positivo.
tolerance 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 padrão 10 será usado. A tolerância não deve ser inferior a 0,0001% do raio. Especificar uma tolerância maior que o raio reduzirá a tolerância para o maior valor possível abaixo do raio.

Devoluções

Polygon ou MultiPolygon ao redor do Polygon ou multipolygon de entrada. Se as coordenadas, o raio ou a 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 arestas 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í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.
  • Os vértices do LinearRing 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 inclui no máximo metade da esfera. LinearRing divide a esfera em duas regiões. A menor das duas regiões será escolhida.
  • O comprimento da borda do LinearRing deve ser inferior a 180 graus. A aresta mais curta entre os dois vértices será escolhida.
  • LinearRings não devem cruzar e não devem compartilhar bordas. LinearRings podem compartilhar vértices.
  • O polígono contém seus vértices.

Exemplos

A consulta 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)
Buffer
{"tipo": "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)
result
{"tipo": "Polígono","coordenadas": [ ... ]}

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

print buffer = isnull(geo_polygon_buffer(dynamic({"type":"p"}), 1))
Buffer
Verdadeiro

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))
Buffer
Verdadeiro