geo_intersects_2lines()
计算两条线或多线是否相交。
语法
geo_intersects_2lines(
lineString1,
lineString2)
详细了解语法约定。
参数
客户 | 类型 | 必需 | 说明 |
---|---|---|---|
lineString1 | dynamic |
✔️ | GeoJSON 格式的一条直线或多条直线。 |
lineString2 | 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 度。 将选择两个顶点之间的最短边缘。
提示
使用文本 LineString 或 MultiLineString 以提高性能。
示例
以下示例检查两条文本直线是否相交。
let lineString1 = dynamic({"type":"LineString","coordinates":[[-73.978929,40.785155],[-73.980903,40.782621]]});
let lineString2 = dynamic({"type":"LineString","coordinates":[[-73.985195,40.788275],[-73.974552,40.779761]]});
print intersects = geo_intersects_2lines(lineString1, lineString2)
输出
intersects |
---|
正确 |
以下示例查找 NYC GeoJSON 道路表中与一些相关直线相交的所有道路。
let my_road = dynamic({"type":"LineString","coordinates":[[-73.97892951965332,40.78515573551921],[-73.98090362548828,40.78262115769851]]});
NY_Manhattan_Roads
| project name = features.properties.Label, road = features.geometry
| where geo_intersects_2lines(road, my_road)
| project name
输出
name |
---|
百老汇 |
W 78th St |
W 79th St |
W 80th St |
W 81st St |
由于其中一条直线无效,以下示例将返回 null 结果。
let lineString1 = dynamic({"type":"LineString","coordinates":[[-73.978929,40.785155],[-73.980903,40.782621]]});
let lineString2 = dynamic({"type":"LineString","coordinates":[[-73.985195,40.788275]]});
print isnull(geo_intersects_2lines(lineString1, lineString2))
输出
print_0 |
---|
True |