geo_line_simplify()

  • 项目

通过将地球上短边缘近乎直线的链替换为单一长边缘，简化一条直线或多条直线。

语法

geo_line_simplify(lineString,tolerance)

详细了解语法约定。

参数

客户 类型​​ 必需 说明
lineString dynamic ✔ GeoJSON 格式 的 LineString 或 MultiLineString。
tolerance int、long 或 real 用于定义任意两个顶点之间的最小距离（以米为单位）。 支持的值范围为 [0, ~7,800,000 米]。 如果未指定，则使用默认值 10。

返回

采用 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 度。 将选择两个顶点之间的最短边缘。

示例

以下示例通过删除彼此距离在 10 米以内的顶点来简化直线。

运行查询

let line = dynamic({"type":"LineString","coordinates":[[-73.97033169865608,40.789063020152824],[-73.97039607167244,40.78897975920816],[-73.9704617857933,40.78888837512432],[-73.97052884101868,40.7887949601531],[-73.9706052839756,40.788698498903564],[-73.97065222263336,40.78862640672032],[-73.97072866559029,40.78852791445617],[-73.97079303860664,40.788434498977836]]});
print simplified = geo_line_simplify(line, 10)

输出

simplified
{"type": "LineString", "coordinates": [[-73.97033169865608, 40.789063020152824], [-73.97079303860664, 40.788434498977836]]}

以下示例简化了直线，并将结果合并到 GeoJSON 几何集合中。

NY_Manhattan_Roads
| project road = features.geometry
| project road_simplified = geo_line_simplify(road, 100)
| summarize roads_lst = make_list(road_simplified)
| project geojson = bag_pack("type", "Feature","geometry", bag_pack("type", "GeometryCollection", "geometries", roads_lst), "properties", bag_pack("name", "roads"))

输出

geojson
{"type": "Feature", "geometry": {"type": "GeometryCollection", "geometries": [ ... ]}, "properties": {"name": "roads"}}

以下示例简化了直线并统一了结果

NY_Manhattan_Roads
| project road = features.geometry
| project road_simplified = geo_line_simplify(road, 100)
| summarize roads_lst = make_list(road_simplified)
| project roads = geo_union_lines_array(roads_lst)

输出

道路
{"type": "MultiLineString", "coordinates": [ ... ]}

以下示例由于直线无效而返回 True。

运行查询

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

输出

is_invalid_line
True

以下示例由于公差无效而返回 True。

运行查询

print is_invalid_line = isnull(geo_line_simplify(dynamic({"type":"LineString","coordinates":[[1, 1],[2,2]]}), -1))

输出

is_invalid_line
True

以下示例由于高公差导致小直线消失而返回 True。

运行查询

print is_invalid_line = isnull(geo_line_simplify(dynamic({"type":"LineString","coordinates":[[1.1, 1.1],[1.2,1.2]]}), 100000))

输出

is_invalid_line
True