geo_line_length()
Beräknar den totala längden på en linje eller en flerrad på jorden.
Syntax
geo_line_length(
lineString)
Läs mer om syntaxkonventioner.
Parametrar
Namn | Typ | Obligatorisk | Beskrivning |
---|---|---|---|
lineString | dynamic |
✔️ | En LineString eller MultiLineString i GeoJSON-format. |
Returer
Den totala längden på en linje eller en flerlinje, i meter, på jorden. Om raden eller flera rader är ogiltiga genererar frågan ett null-resultat.
Anteckning
- De geospatiala koordinaterna tolkas som de representeras av WGS-84-koordinatreferenssystemet .
- Det geodetiska datum som används för att mäta avstånd på jorden är en sfär. Linjekanter är geodesik på sfären.
- Om indatalinjens kanter är raka kartesiska linjer bör du överväga att använda geo_line_densify() för att konvertera planära kanter till geodesik.
- Om indata är en flerrad och innehåller mer än en rad blir resultatet total längd på linjernas union.
LineString-definition och begränsningar
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]]})
- Matrisen LineString-koordinater måste innehålla minst två poster.
- Koordinaterna [longitud, latitud] måste vara giltiga där longitud är ett reellt tal i intervallet [-180, +180] och latitud är ett verkligt tal i intervallet [-90, +90].
- Kantlängden måste vara mindre än 180 grader. Den kortaste kanten mellan de två hörnen väljs.
Exempel
I följande exempel beräknas den totala linjelängden i meter.
let line = dynamic({"type":"LineString","coordinates":[[-73.95807266235352,40.800426144169315],[-73.94966125488281,40.79691751000055],[-73.97317886352539,40.764486356930334]]});
print length = geo_line_length(line)
Resultat
length |
---|
4922.48016992081 |
I följande exempel beräknas total längd för flera linjer i meter.
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)
Resultat
length |
---|
8262.24339753741 |
Följande exempel returnerar True på grund av den ogiltiga raden.
print is_bad_line = isnull(geo_line_length(dynamic({"type":"LineString","coordinates":[[1, 1]]})))
Resultat
is_bad_line |
---|
Sant |
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för