Compartilhar via

geo_polygon_buffer()

  • Artigo

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(tolerância de raio de 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 de amortecimento 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 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 ao redor do Polígono de entrada ou multipolígono. 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 bordas dos polígonos 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","coordenadas": [LinearRingShell, LinearRingHole_1, ..., LinearRingHole_N]})

dynamic({"type": "MultiPolygon","coordenadas": [[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 e buracos interiores.
  • Os vértices LinearRing devem ser distintos com pelo menos três coordenadas. A primeira coordenada deve ser igual à última. São necessárias pelo menos quatro inscrições.
  • 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 abrange no máximo metade da esfera. LinearRing divide a esfera em duas regiões. Será escolhida a menor das duas regiões.
  • O comprimento da borda do LinearRing deve ser inferior a 180 graus. Será escolhida a aresta mais curta entre os dois vértices.
  • Os LinearRings não devem cruzar e não devem compartilhar bordas. LinearRings podem compartilhar vértices.
  • Polígono contém seus vértices.

Exemplos

A consulta a seguir calcula o polígono ao redor do polígono de entrada, com raio de 10km.

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
{"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)
result
{"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))
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