geo_line_centroid()

計算地球上線條或多行的距心。

Syntax

geo_line_centroid(lineString)

深入瞭解 語法慣例。

參數

名稱	類型	必要	Description
lineString	dynamic	✔️	GeoJSON 格式的LineString或 MultiLineString。

傳回

GeoJSON 格式和動態資料類型的質心座標值。 如果行或多行無效，查詢會產生 Null 結果。

注意

• 地理空間座標會以 WGS-84 座標參考系統的表示來解讀。
• 用來測量地球距離的測量基準是球體。 線條邊緣是球體上的測地線。
• 如果輸入線邊緣是直笛卡兒線，請考慮使用 geo_line_densify()，以將平面邊緣轉換為測地線。
• 如果輸入是多行，且包含一行以上，則結果會是線條聯集的中心。

LineString 定義和限制

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]]})

• LineString 座標陣列必須包含至少兩個項目。
• 坐標 [經度， 緯度] 必須是有效的，其中經度是範圍 [-180， +180] 中的實數，而緯度是範圍 [-90， +90] 中的實數。
• 邊緣長度必須小於 180 度。 選擇兩個頂點之間的最短邊緣。

範例

下列範例會計算線條距心。

執行查詢

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

輸出

質心
{“type”： “Point”， “coordinates”： [-73.965567057230942， 40.782453249627416]}

下列範例會計算行心經度。

執行查詢

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]

輸出

lng
-73.9660675626837

下列範例會將地圖上的線條心可視化。

執行查詢

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)

下列範例會 true 傳回 ，因為行無效。

執行查詢

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

輸出

is_bad_line
true