geo_line_centroid()

适用于:✅Azure 数据资源管理器Azure MonitorMicrosoft Sentinel

计算地球上一条线或多线的质心。

语法

geo_line_centroid(lineString)

详细了解语法约定

参数

客户 类型​​ 必需 说明
lineString dynamic ✔️ 采用 GeoJSON 格式的 LineString 或 MultiLineString。

返回

采用 GeoJSON 格式、数据类型为 dynamic 的质心坐标值。 如果该线或多线无效,则查询会生成 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 坐标数组必须至少包含两个条目。
  • 如果 longitude 是 [-180, +180] 范围内的实数,而 latitude 是 [-90, +90] 范围内的实数,则坐标 [longitude,latitude] 必须有效。
  • 边缘长度必须小于 180 度。 将选择两个顶点之间的最短边。

示例

以下示例计算直线质心。

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

输出

centroid
{"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