geo_polygon_centroid()

Platí pro: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

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

Syntaxe

geo_polygon_centroid(mnohoúhelník)

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

Parametry

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

Návraty

Hodnoty centroidu souřadnic ve formátu GeoJSON a dynamického datového typu. Pokud je mnohoúhelník nebo vícepolygon neplatný, dotaz vytvoří výsledek null.

Poznámka:

• Geoprostorové souřadnice jsou interpretovány jako reprezentované referenčním systémem souřadnic WGS-84 .
• Geodetické datum používané pro měření na Zemi je sféra. Polygonové hrany jsou geodesické oblasti na kouli.
• Pokud jsou vstupní mnohoúhelníky rovné kartézské čáry, zvažte použití geo_polygon_densify() k převodu planárních hran na geodesické čáry.
• Pokud je vstup multipolygon a obsahuje více než jeden mnohoúhelník, výsledkem bude centroid mnohoúhelníku sjednocení.

Definice mnohoúhelníku a omezení

dynamic({"type": "Mnohoúhelník";"souřadnice": [ LinearRingShell, LinearRingHole_1; ..., LinearRingHole_N ]})

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

• LinearRingShell je povinný a definovaný jako seřazená counterclockwise matice souřadnic [[lng_1;lat_1],...,[lng_i;lat_i],...,[lng_j;lat_j],...,[lng_1;lat_1]]. Může existovat pouze jedno prostředí.
• LinearRingHole je volitelný 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é s alespoň třemi souřadnicemi. První souřadnice musí být rovna poslední. Vyžaduje se aspoň č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 oblasti [-90, +90].
• LinearRingShell uzavře většinu poloviny sféry. LinearRing rozdělí sféru do dvou oblastí a zvolí menší ze dvou oblastí.
• Délka hrany linearring musí být menší než 180 stupňů. Vybere se nejkratší hrana mezi dvěma vrcholy.
• LinearRings nesmí křížovat a nesmí sdílet hrany. LinearRings může sdílet vrcholy.

Příklady

Následující příklad vypočítá centroid Centrálního parku v New Yorku.

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 centroid = geo_polygon_centroid(central_park)

Výstup

těžiště
{"type": "Bod", "souřadnice": [-73.965735689907618, 40.782550538057812]}

Následující příklad vypočítá délku centroidu Centrálního parku.

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 
centroid = geo_polygon_centroid(central_park)
| project lng = centroid.coordinates[0]

Výstup

Lng
-73.9657356899076

Následující příklad provádí sjednocení mnohoúhelníku v multipolygonu a vypočítá centroid sjednoceného mnohoúhelníku.

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_centroid = geo_polygon_centroid(polygons)

Výstup

polygons_union_centroid
"type": "Point", "coordinates": [-73.968569587829577, 40.776310752555119]}

Následující příklad vizualizuje centroid Centrálního parku na mapě.

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 
centroid = geo_polygon_centroid(central_park)
| render scatterchart with (kind = map)

Výstup

Následující příklad vrátí true kvůli neplatnému mnohoúhelníku.

Spuštění dotazu

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

Výstup

print_0
true