Sdílet prostřednictvím

geo_polygon_area()

  • Článek

Vypočítá oblast mnohoúhelníku nebo multipolygonu na Zemi.

Syntax

geo_polygon_area(Mnohoúhelník)

Přečtěte si další informace o konvencích syntaxe.

Parametry

Název Typ Vyžadováno Popis
Mnohoúhelník dynamic ✔️ Mnohoúhelník nebo multipolygon ve formátu GeoJSON.

Návraty

Plocha mnohoúhelníku nebo multipolygonu, v metrech čtverečních, na Zemi. Pokud je mnohoúhelník nebo multipolygon neplatný, dotaz vygeneruje výsledek null.

Poznámka

  • Geoprostorové souřadnice jsou interpretovány jako reprezentované systémem souřadnic WGS-84 .
  • Geodetická rovina používaná pro měření na Zemi je koule. Mnohoúhelníkové hrany jsou geodézie na kouli.
  • Pokud jsou vstupní mnohoúhelníky rovné kartézské čáry, zvažte použití geo_polygon_densify() k převodu rovinných okrajů na geodézie.
  • Pokud je vstup multipolygon a obsahuje více než jeden mnohoúhelník, výsledkem bude sjednocení oblasti mnohoúhelníku.

Definice a omezení mnohoúhelníku

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

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

  • LinearRingShell je povinný a definovaný jako uspořádané counterclockwise pole souřadnic [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]]. Může existovat jenom jedno prostředí.
  • LinearRingHole je nepovinný a definovaný jako clockwise uspořádané pole souřadnic [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]]. Může existovat libovolný počet vnitřních kroužků a otvorů.
  • Vrcholy LinearRing musí být odlišné alespoň třemi souřadnicemi. První souřadnice musí být rovna poslední. Vyžadují se alespoň čtyři položky.
  • Souřadnice [zeměpisná délka, zeměpisná šířka] musí být platné. Zeměpisná délka musí být reálné číslo v oblasti [-180, +180] a zeměpisná šířka musí být reálné číslo v rozsahu [-90, +90].
  • LinearRingShell obklopuje maximálně polovinu koule. LinearRing rozdělí kouli na dvě oblasti. Zvolí se menší z těchto dvou oblastí.
  • Délka lineárního okraje musí být menší než 180 stupňů. Zvolí se nejkratší hrana mezi dvěma vrcholy.
  • LinearRings nesmí křížovat a nesmí sdílet hrany. LinearRings mohou sdílet vrcholy.

Příklady

Následující příklad vypočítá oblast NYC Central Park.

Spuštění dotazu

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)

Výstup

oblast
3475207.28346606

Následující příklad provede sjednocení mnohoúhelníku v multipolygonu a vypočítá oblast na sjednocený mnohoúhelník.

Spuštění dotazu

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)

Výstup

polygons_union_area
10889971.5343487

Následující příklad vypočítá 5 největších států USA podle oblasti.

Spuštění dotazu

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

Výstup

name oblast
Alaska 1550934810070.61
Texas 693231378868.483
California 410339536449.521
Montana 379583933973.436
New Mexico 314979912310.579

Následující příklad vrátí hodnotu True z důvodu neplatného mnohoúhelníku.

Spuštění dotazu

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

Výstup

print_0
Ano