geo_point_buffer()
적용 대상: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
지구 점의 지정된 반경 내에 있는 모든 점을 포함하는 다각형을 계산합니다.
구문
geo_point_buffer(
경도,
위도,
반지름,
허용 오차)
구문 규칙에 대해 자세히 알아봅니다.
매개 변수
이름 | Type | 필수 | 설명 |
---|---|---|---|
경도 | real |
✔️ | 지리 공간 좌표 경도 값(도)입니다. 유효한 값은 실수이며 범위 [-180, +180]입니다. |
latitude | real |
✔️ | 지리 공간적 좌표 위도 값(도)입니다. 유효한 값은 실수이며 범위 [-90, +90]입니다. |
반지름 | real |
✔️ | 버퍼 반경(미터)입니다. 유효한 값은 양수여야 합니다. |
공차 | real |
다각형이 이상적인 반경에서 얼마나 벗어날 수 있는지를 결정하는 공차(미터)를 정의합니다. 지정하지 않으면 기본값 10 이 사용됩니다. 허용 오차는 반지름의 0.0001%보다 작지 않아야 합니다. 허용 오차를 반지름보다 크게 지정하면 허용 오차가 가능한 최대 값으로 반경 아래로 낮아지게 됩니다. |
반품
입력 지점 주위의 다각형입니다. 좌표나 반경 또는 허용 오차가 잘못된 경우 쿼리는 null 결과를 생성합니다.
참고 항목
- 지리 공간적 좌표는 WGS-84 좌표 참조 시스템에서 나타내는 것으로 해석됩니다.
- 지구 거리를 측정하는 데 사용되는 측지 데이텀은 구입니다.
예제
다음 쿼리는 반경 20km인 [-115.1745008278, 36.1497251277] 좌표 주위의 다각형을 계산합니다.
print buffer = geo_point_buffer(-115.1745008278, 36.1497251277, 20000)
buffer |
---|
{"type": "Polygon","coordinates": [ ... ]} |
다음 쿼리는 각 지점 주위의 버퍼를 계산하고 결과를 통합합니다.
datatable(longitude:real, latitude:real, radius:real)
[
real(-80.3212217992616), 25.268683367546604, 5000,
real(-80.81717403605833), 24.82658441221962, 3000
]
| project buffer = geo_point_buffer(longitude, latitude, radius)
| summarize polygons = make_list(buffer)
| project result = geo_union_polygons_array(polygons)
result |
---|
{"type": "MultiPolygon","좌표": [ ... ]} |
다음 예제에서는 잘못된 지점으로 인해 true를 반환합니다.
print result = isnull(geo_point_buffer(200, 1,0.1))
result |
---|
True |
다음 예제에서는 잘못된 반지름으로 인해 true를 반환합니다.
print result = isnull(geo_point_buffer(10, 10, -1))
result |
---|
True |