geo_line_length()
计算地球上一条线或多线的总长度。
语法
geo_line_length(lineString)
详细了解语法约定。
参数
| 客户 | 类型 | 必需 | 说明 |
|---|---|---|---|
| lineString | dynamic |
✔ | 采用 GeoJSON 格式的 LineString 或 MultiLineString。 |
返回
地球上直线或多线的总长度（米）。 如果一条线或多线无效，该查询会生成 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.95807266235352,40.800426144169315],[-73.94966125488281,40.79691751000055],[-73.97317886352539,40.764486356930334]]});
print length = geo_line_length(line)
输出
| length |
|---|
| 4922.48016992081 |
以下示例计算多线的总长度（米）。
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)
输出
| length |
|---|
| 8262.24339753741 |
以下示例由于直线无效而返回 True。
print is_bad_line = isnull(geo_line_length(dynamic({"type":"LineString","coordinates":[[1, 1]]})))
输出
| is_bad_line |
|---|
| True |