geo_line_centroid()

Vypočítá centroid přímky nebo víceřádkové čáry na Zemi.

Syntax

geo_line_centroid(Linestring)

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

Parametry

Název	Typ	Vyžadováno	Popis
Linestring	dynamic	✔️	LineString nebo MultiLineString ve formátu GeoJSON.

Návraty

Hodnoty centroidních souřadnic ve formátu GeoJSON a dynamického datového typu. Pokud je řádek nebo víceřádkový řádek 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é k měření vzdálenosti na Zemi je koule. Hrany čar jsou geodézie na kouli.
• Pokud jsou hrany vstupních čar rovné kartézské čáry, zvažte použití geo_line_densify() k převodu rovinných okrajů na geodézie.
• Pokud je vstup víceřádkový a obsahuje více než jeden řádek, výsledkem bude sjednocení centroidu řádků.

Definice a omezení linestringu

dynamic({"type": "LineString";"coordinates": [[lng_1;lat_1], [lng_2;lat_2], ...; [lng_N;lat_N]]})

dynamic({"type": "MultiLineString";"coordinates": [[line_1, line_2, ..., line_N]]})

• Pole souřadnic LineString musí obsahovat alespoň dvě položky.
• Souřadnice [zeměpisná délka, zeměpisná šířka] musí být platné, kde zeměpisná délka je reálné číslo v rozsahu [-180; +180] a zeměpisná šířka je reálné číslo v rozsahu [-90, +90].
• Délka hrany musí být menší než 180 stupňů. Zvolí se nejkratší hrana mezi dvěma vrcholy.

Příklady

Následující příklad vypočítá centroid řádku.

Spuštění dotazu

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

Výstup

Centroid
{"type": "Point", "coordinates": [-73.965567057230942, 40.782453249627416]}

Následující příklad vypočítá délku centroid řádku.

Spuštění dotazu

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]

Výstup

Lng
-73.9660675626837

Následující příklad vizualizuje centroid čáry na mapě.

Spuštění dotazu

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)

Následující příklad vrátí true kvůli neplatnému řádku.

Spuštění dotazu

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

Výstup

is_bad_line
true