geo_line_centroid()

Oblicza centroid linii lub wielowierszową na Ziemi.

Składnia

geo_line_centroid(Linestring)

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

Parametry

Nazwa	Typ	Wymagane	Opis
Linestring	dynamic	✔️	LineString lub MultiLineString w formacie GeoJSON.

Zwraca

Wartości współrzędnych centroid w formacie GeoJSON i dynamicznego typu danych. Jeśli wiersz lub wielowierszowy jest nieprawidłowy, zapytanie generuje wynik o wartości null.

Uwaga

• Współrzędne geoprzestrzenne są interpretowane jako reprezentowane przez system odniesienia współrzędnych WGS-84 .
• Geodetyczne datum używane do mierzenia odległości na Ziemi jest sferą. Krawędzie linii są geodesics na sferze.
• Jeśli krawędzie linii wejściowej są liniami kartezjańskimi, rozważ użycie geo_line_densify(), aby przekonwertować krawędzie planarne na geodesy.
• Jeśli dane wejściowe są wielowierszowe i zawierają więcej niż jeden wiersz, wynik będzie centroidem linii unii.

Definicja i ograniczenia lineString

dynamic({"type": "LineString","współrzędne": [[lng_1,lat_1], [lng_2,lat_2], ..., [lng_N,lat_N]]})

dynamic({"type": "MultiLineString","współrzędne": [[line_1, line_2, ..., line_N]})

• Tablica współrzędnych LineString musi zawierać co najmniej dwa wpisy.
• Współrzędne [długość geograficzna, szerokość geograficzna] muszą być prawidłowe, gdzie długość geograficzna jest liczbą rzeczywistą w zakresie [-180, +180], a szerokość geograficzna jest liczbą rzeczywistą w zakresie [-90, +90].
• Długość krawędzi musi być mniejsza niż 180 stopni. Wybierana jest najkrótsza krawędź między dwoma wierzchołkami.

Przykłady

Poniższy przykład oblicza centroid linii.

Uruchamianie zapytania

let line = dynamic({"type":"LineString","coordinates":[[-73.95796, 40.80042], [-73.97317, 40.764486]]});
print centroid = geo_line_centroid(line);

Dane wyjściowe

Strefy
{"type": "Point", "współrzędne": [-73.965567057230942, 40.782453249627416]}

Poniższy przykład oblicza długość geograficzną centroid linii.

Uruchamianie zapytania

let line = dynamic({"type":"LineString","coordinates":[[-73.95807266235352,40.800426144169315],[-73.94966125488281,40.79691751000055],[-73.97317886352539,40.764486356930334],[-73.98210525512695,40.76786669510221],[-73.96004676818848,40.7980870753293]]});
print centroid = geo_line_centroid(line)
| project lng = centroid.coordinates[0]

Dane wyjściowe

Lng
-73.9660675626837

Poniższy przykład wizualizuje centroid linii na mapie.

Uruchamianie zapytania

let line = dynamic({"type":"MultiLineString","coordinates":[[[-73.95798683166502,40.800556090021466],[-73.98193359375,40.76819171855746]],[[-73.94940376281738,40.79691751000055],[-73.97317886352539,40.76435634049001]]]});
print centroid = geo_line_centroid(line)
| render scatterchart with (kind = map)

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

Uruchamianie zapytania

print is_bad_line = isnull(geo_line_centroid(dynamic({"type":"LineString","coordinates":[[1, 1]]})))

Dane wyjściowe

is_bad_line
true