geo_polygon_centroid()

Oblicza centroid wielokąta lub wielobiegun na Ziemi.

Składnia

geo_polygon_centroid(Wielokąt)

Dowiedz się więcej o konwencjach składniowych.

Parametry

Nazwa	Typ	Wymagane	Opis
Wielokąt	dynamic	✔️	Wielokąt lub multipolygon w formacie GeoJSON.

Zwraca

Wartości współrzędnych centroid w formacie GeoJSON i dynamicznego typu danych. Jeśli wielokąt lub wielobiegun są nieprawidłowe, zapytanie generuje wynik null.

Uwaga

• Współrzędne geoprzestrzenne są interpretowane jako reprezentowane przez system odniesienia współrzędnych WGS-84 .
• Geodetic datum używane do pomiarów na Ziemi jest sferą. Krawędzie wielokątne są geodesykami na sferze.
• Jeśli krawędzie wielokąta wejściowe są prostymi liniami kartezjańskimi, rozważ użycie geo_polygon_densify() w celu przekonwertowania krawędzi planarnych na geodesyki.
• Jeśli dane wejściowe są wielobiegunowe i zawierają więcej niż jeden wielokąt, wynik będzie centroidem unii wielokątów.

Definicja i ograniczenia wielokątne

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

dynamic({"type": "MultiPolygon","współrzędne": [[ LinearRingShell, LinearRingHole_1, ..., LinearRingHole_N], ..., [LinearRingShell, LinearRingHole_1, ..., LinearRingHole_M]]})

• Program LinearRingShell jest wymagany i zdefiniowany jako uporządkowana tablica współrzędnych counterclockwise [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]]. Może istnieć tylko jedna powłoka.
• Element LinearRingHole jest opcjonalny i zdefiniowany jako uporządkowana tablica współrzędnych clockwise [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]]. Może istnieć dowolna liczba wewnętrznych pierścieni i otworów.
• Wierzchołki liniowe muszą być różne z co najmniej trzema współrzędnymi. Pierwsza współrzędna musi być równa ostatniej. Wymagane są co najmniej cztery wpisy.
• Współrzędne [długość geograficzna, szerokość geograficzna] muszą być prawidłowe. Długość geograficzna musi być liczbą rzeczywistą w zakresie [-180, +180], a szerokość geograficzna musi być liczbą rzeczywistą w zakresie [-90, +90].
• LinearRingShell otacza najwyżej połowę kuli. Funkcja LinearRing dzieli sferę na dwa regiony i wybiera mniejsze z dwóch regionów.
• Długość krawędzi liniowej musi być mniejsza niż 180 stopni. Wybierana jest najkrótsza krawędź między dwoma wierzchołkami.
• Linijki nie mogą być krzyżowe i nie mogą współdzielić krawędzi. Wierzchołki liniowe mogą udostępniać wierzchołki.

Przykłady

Poniższy przykład oblicza centroid Central Park w Nowym Jorku.

Uruchamianie zapytania

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)

Dane wyjściowe

Strefy
{"type": "Point", "coordinates": [-73.965735689907618, 40.782550538057812]}

W poniższym przykładzie obliczana jest długość centroid parku centralnego.

Uruchamianie zapytania

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]

Dane wyjściowe

Lng
-73.9657356899076

Poniższy przykład wykonuje połączenie wielokątów w wielobiegunu i oblicza centroid ujednoliconego wielokąta.

Uruchamianie zapytania

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)

Dane wyjściowe

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

Poniższy przykład wizualizuje centroid Central Park na mapie.

Uruchamianie zapytania

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)

Dane wyjściowe

Poniższy przykład zwraca true wartość z powodu nieprawidłowego wielokąta.

Uruchamianie zapytania

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

Dane wyjściowe

print_0
true