geo_polygon_area()

Calcula el área de un polígono o un multipolígono en la Tierra.

Syntax

geo_polygon_area(Polígono)

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre	Tipo	Requerido	Descripción
Polígono	dynamic	✔️	Polígono o multipolígono en formato GeoJSON.

Devoluciones

El área de un polígono o un multipolígono, en metros cuadrados, en la Tierra. Si el polígono o el multipolygon no son válidos, la consulta generará un resultado nulo.

Nota

• Las coordenadas geoespaciales se interpretan como representadas por el sistema de referencia de coordenadas WGS-84 .
• La referencia geodética utilizada para las mediciones en la Tierra es una esfera. Los bordes de polígono son geodesics en la esfera.
• Si los bordes de polígono de entrada son líneas cartesianas rectas, considere la posibilidad de usar geo_polygon_densify() para convertir bordes planales en geodesics.
• Si la entrada es un multipolygon y contiene más de un polígono, el resultado será el área de unión de polígonos.

Definición y restricciones de polígono

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

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

• LinearRingShell es necesario y se define como una counterclockwise matriz ordenada de coordenadas [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]]. Solo puede haber un shell.
• LinearRingHole es opcional y se define como una clockwise matriz ordenada de coordenadas [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]]. Puede haber cualquier número de anillos interiores y agujeros.
• Los vértices linearRing deben ser distintos con al menos tres coordenadas. La primera coordenada debe ser igual a la última. Se requieren al menos cuatro entradas.
• Las coordenadas [longitud, latitud] deben ser válidas. La longitud debe ser un número real en el intervalo [-180, +180] y la latitud debe ser un número real en el intervalo [-90, +90].
• LinearRingShell incluye como máximo la mitad de la esfera. LinearRing divide la esfera en dos regiones. Se elegirá el menor de las dos regiones.
• La longitud del borde linearRing debe ser inferior a 180 grados. Se elegirá el borde más corto entre los dos vértices.
• LinearRings no debe cruzar y no compartir bordes. LinearRings puede compartir vértices.

Ejemplos

En el ejemplo siguiente se calcula el área del parque central de Nueva York.

Ejecución de la consulta

let central_park = dynamic({"type":"Polygon","coordinates":[[[-73.9495,40.7969],[-73.95807266235352,40.80068603561921],[-73.98201942443848,40.76825672305777],[-73.97317886352539,40.76455136505513],[-73.9495,40.7969]]]});
print area = geo_polygon_area(central_park)

Salida

área
3475207.28346606

En el ejemplo siguiente se realiza la unión de polígonos en multipolígono y se calcula el área en el polígono unificado.

Ejecución de la consulta

let polygons = dynamic({"type":"MultiPolygon","coordinates":[[[[-73.9495,40.7969],[-73.95807266235352,40.80068603561921],[-73.98201942443848,40.76825672305777],[-73.97317886352539,40.76455136505513],[-73.9495,40.7969]]],[[[-73.94262313842773,40.775991804565585],[-73.98107528686523,40.791849155467695],[-73.99600982666016,40.77092185281977],[-73.96150588989258,40.75609977566361],[-73.94262313842773,40.775991804565585]]]]});
print polygons_union_area = geo_polygon_area(polygons)

Salida

polygons_union_area
10889971.5343487

En el ejemplo siguiente se calculan los cinco estados más grandes de EE. UU. por área.

Ejecución de la consulta

US_States
| project name = features.properties.NAME, polygon = geo_polygon_densify(features.geometry)
| project name, area = geo_polygon_area(polygon)
| top 5 by area desc

Salida

name	área
Alaska	1550934810070.61
Texas	693231378868.483
California	410339536449.521
Montana	379583933973.436
Nuevo México	314979912310.579

En el ejemplo siguiente se devuelve True debido al polígono no válido.

Ejecución de la consulta

print isnull(geo_polygon_area(dynamic({"type": "Polygon","coordinates": [[[0,0],[10,10],[10,10],[0,0]]]})))

Salida

print_0
True