geo_polygon_buffer()

  • 项目

计算包含地球上的输入多边形或多多边形的给定半径内所有点的多边形或多多边形。

语法

geo_polygon_buffer(polygon,radius,tolerance)

详细了解语法约定。

参数

客户 类型​​ 必需 说明
polygon dynamic ✔ 采用 GeoJSON 格式的多边形或多多边形。
radius real ✔ 以米为单位的缓冲区半径。 有效值必须为正。
tolerance real 定义以米为单位的公差，用于确定多边形可以偏离理想半径的程度。 如果未指定，则使用默认值 10。 公差应不低于半径的 0.0001%。 指定大于半径的公差会将公差降低到半径以下的最大可能值。

返回

围绕输入多边形或多多边形的多边形或多多边形。 如果坐标、半径或公差无效，则查询会生成 null 结果。

注意

  • 以 WGS-84 坐标参考系统表示方法对地理空间坐标进行解释。
  • 用于在地球上进行测量的大地基准是一个球体。 多边形边缘是球体上的测地线。
  • 如果输入多边形边缘是直笛卡尔线，请考虑使用 geo_polygon_densify() 以将平面边缘转换为测地线。

多边形定义和约束

dynamic({"type": "Polygon","coordinates": [LinearRingShell, LinearRingHole_1, ..., LinearRingHole_N]})

dynamic({"type": "MultiPolygon","coordinates": [[LinearRingShell, LinearRingHole_1, ..., LinearRingHole_N], ..., [LinearRingShell, LinearRingHole_1, ..., LinearRingHole_M]]})

  • LinearRingShell 是必需的，定义为 counterclockwise 有序坐标数组 [[lng_1,lat_1], ...,[lng_i,lat_i], ...,[lng_j,lat_j], ...,[lng_1,lat_1]]。 只能有一个 shell。
  • LinearRingHole 是可选的，定义为 clockwise 有序坐标数组 [[lng_1,lat_1], ...,[lng_i,lat_i], ...,[lng_j,lat_j], ...,[lng_1,lat_1]]。 可以有任意数量的内部环和孔。
  • LinearRing 顶点必须很独特，至少有三个坐标。 第一个坐标必须等于最后一个坐标。 至少需要四个条目。
  • 坐标 [经度, 纬度] 必须有效。 经度必须是 [-180, +180] 范围内的实数，纬度必须是 [-90, +90] 范围内的实数。
  • LinearRingShell 最多包含球体的一半。 LinearRing 将球体分成两个区域。 将选择这两个区域中较小的一个。
  • LinearRing 边缘长度必须小于 180 度。 将选择两个顶点之间的最短边缘。
  • LinearRing 不得交叉且不得共享边缘。 LinearRing 可以共享顶点。
  • 多边形包含其顶点。

示例

以下查询计算围绕输入多边形的多边形，其半径为 10 公里。

let polygon = dynamic({"type":"Polygon","coordinates":[[[139.813757,35.719666],[139.72558,35.71813],[139.727471,35.653231],[139.818721,35.657264],[139.813757,35.719666]]]});
print buffer = geo_polygon_buffer(polygon, 10000)
缓冲区
{"type": "Polygon","coordinates": [ ... ]}

以下查询计算围绕每个多边形的缓冲区并统一结果

datatable(polygon:dynamic, radius:real )
[
    dynamic({"type":"Polygon","coordinates":[[[12.451218693639277,41.906457003556625],[12.445753852969375,41.90160968881543],[12.453514425793855,41.90361551885886],[12.451218693639277,41.906457003556625]]]}), 100,
    dynamic({"type":"Polygon","coordinates":[[[12.4566086734784,41.905119850039995],[12.453913683559591,41.903652663265234],[12.455485761012113,41.90146110630562],[12.4566086734784,41.905119850039995]]]}), 20
]
| project buffer = geo_polygon_buffer(polygon, radius)
| summarize polygons = make_list(buffer)
| project result = geo_union_polygons_array(polygons)
result
{"type": "Polygon","coordinates": [ ... ]}

由于多边形无效，以下示例将返回 true。

print buffer = isnull(geo_polygon_buffer(dynamic({"type":"p"}), 1))
缓冲区
True

由于半径无效，以下示例将返回 true。

print buffer = isnull(geo_polygon_buffer(dynamic({"type":"Polygon","coordinates":[[[10,10],[0,10],[0,0],[10,10]]]}), 0))
缓冲区
True