geo_polygon_centroid()
Vypočítá centroid mnohoúhelníku nebo multipolygonu na Zemi.
Syntax
geo_polygon_centroid(
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
Hodnoty centroidních souřadnic ve formátu GeoJSON a dynamického datového typu. Pokud jsou mnohoúhelník nebo mnohoúhelník neplatné, dotaz vygeneruje výsledek null.
Poznámka
- Geoprostorové souřadnice jsou interpretovány jako reprezentované systémem souřadnic WGS-84 .
- Geodetické datum 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 centroid sjednocení 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
counterclockwise
uspořádané pole 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 nejméně 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 rozsahu [-180, +180] a zeměpisná šířka musí být reálné číslo v rozsahu [-90, +90].
- LinearRingShell obklopuje nejvýše polovinu sféry. LinearRing rozdělí kouli na dvě oblasti a vybere menší z těchto dvou oblastí.
- Délka hrany linearRing musí být menší než 180 stupňů. Zvolí se nejkratší hrana mezi dvěma vrcholy.
- LinearRings se nesmí křížovat a nesmí sdílet hrany. LinearRings může sdílet vrcholy.
Příklady
Následující příklad vypočítá centroid Central Park v New Yorku.
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
Centroid |
---|
{"type": "Point", "souřadnice": [-73.965735689907618, 40.782550538057812]} |
Následující příklad vypočítá zeměpisná délka centroid Central Park.
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 provede sjednocení mnohoúhelníky v multipolygonu a vypočítá centroid sjednoceného mnohoúhelníku.
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 Central Park na mapě.
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.
print isnull(geo_polygon_centroid(dynamic({"type": "Polygon","coordinates": [[[0,0],[10,10],[10,10],[0,0]]]})))
Výstup
print_0 |
---|
true |
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro