Udostępnij za pośrednictwem

geo_line_length()

  • Artykuł

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Oblicza całkowitą długość linii lub wielowierszową na Ziemi.

Składnia

geo_line_length(lineString)

Dowiedz się więcej na temat konwencji składni.

Parametry

Nazwisko Type Wymagania opis
lineString dynamic ✔️ Ciąg lineString lub MultiLineString w formacie GeoJSON.

Zwraca

Całkowita długość linii lub wielolinii, w metrach, na Ziemi. Jeśli wiersz lub wielowierszowa jest nieprawidłowa, zapytanie spowoduje wygenerowanie wyniku 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ą geodesykami na sferze.
  • Jeśli krawędzie linii wejściowej są liniami kartezjańskimi, rozważ użycie geo_line_densify() w celu przekonwertowania krawędzi planarnych na geodesiki.
  • Jeśli dane wejściowe są wielowierszowe i zawierają więcej niż jeden wiersz, wynik będzie całkowitą długością linii union.

Definicja i ograniczenia linestring

dynamic({"type": "LineString","coordinates": [[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. Zostanie wybrana najkrótsza krawędź między dwoma wierzchołkami.

Przykłady

Poniższy przykład oblicza łączną długość linii w metrach.

let line = dynamic({"type":"LineString","coordinates":[[-73.95807266235352,40.800426144169315],[-73.94966125488281,40.79691751000055],[-73.97317886352539,40.764486356930334]]});
print length = geo_line_length(line)

Wyjście

length
4922.48016992081

Poniższy przykład oblicza łączną długość wielowierszową w metrach.

let line = dynamic({"type":"MultiLineString","coordinates":[[[-73.95798683166502,40.800556090021466],[-73.98193359375,40.76819171855746]],[[-73.94940376281738,40.79691751000055],[-73.97317886352539,40.76435634049001]]]});
print length = geo_line_length(line)

Wyjście

length
8262.24339753741

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

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

Wyjście

is_bad_line
Prawda