geo_polygon_densify()

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

Sintaxe

geo_polygon_densify(tolerância a polígonos, [ 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, longo ou real		Define a distância máxima em metros entre a borda plana original e a cadeia de borda geodésica 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 a travessia de borda sobre o antimeridiano. Se não for especificado, o valor padrão false será usado.

Definição de polígono

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.
• 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 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 encerra no máximo metade da esfera. LinearRing divide a esfera em duas regiões. Será escolhida a menor das duas regiões.
• LinearRing o comprimento da borda 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 no polígono densificado é limitado a 10485760.
• O armazenamento de polígonos em formato dinâmico tem limites de tamanho.
• A densificação de 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 entrelaçam umas com as outras.

Motivação

• O formato GeoJSON define uma aresta entre dois pontos como uma linha cartesiana reta enquanto geo_polygon_densify() usa geodésica.
• A decisão de usar bordas geodésicas ou planas pode depender do conjunto de dados e é especialmente relevante em bordas 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 bordas são curtas e a distância entre as bordas planas e suas contrapartes geodésicas é menor do que a distância especificada pela tolerância. Como tal, o resultado mantém-se inalterado.

Executar a consulta

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","coordenadas":[[[-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

Executar a consulta

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
{"tipo":"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 coordenada inválida.

Executar a consulta

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.

Executar a consulta

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